douyin-downloaderlisted
Install: claude install-skill wuxutian2-bot/douyin-downloader
# 抖音作品下载器(视频 / 图集 / 动图 / GIF / 音频)
给一个抖音链接,把作品的原片存到本地:视频取最高清晰度无水印源,图集取原图(自动转 JPG),
动图/实况连动画一起存(默认转成 `_01.gif`)。用户明确要音频时,还能导出视频原声或作品配乐。
完全本地运行,不依赖任何第三方 Python 包。
## When to Use
用户粘贴抖音链接(短链 `v.douyin.com/xxx`、`/video/<id>`、`/note/<id>`、裸 19 位 ID,
或整段分享文案)并想要其中的视频、图片、图集、动图/实况或 GIF。也用于用户问"这个抖音链接能下吗"、
"帮我存下来"、"要原图"、"转个 GIF"、"动图怎么不动"。非抖音平台(YouTube/TikTok/B站)用 `video-download`。
用户额外提到**声音/音频**时也归这里:`原声`、`视频里的声音`、`音频`、`配音`、`人声` →
加 `--audio`;`配乐`、`BGM`、`背景音乐`、`这首歌`、`音乐` → 加 `--music`。
**用户没提音频就不要加这两个参数**——默认只下原片/原图,一个音频文件都不产出。
要音频时把参数加在**同一条命令**上,一次跑完,不要先下视频再单独跑一遍。
动图/实况默认会转成 `_01.gif` 一起存;用户明确说"只要图/不要动图"时才加 `--still-only`。
用户要原声/原画质的动图时加 `--motion-format mp4`——GIF 没有声音。
**路径**:`scripts/douyin_dl.py`、`scripts/douyin_cdp.py`、`scripts/下载抖音视频.bat`、`scripts/README.md`。
把前两个 `.py` 拷到同一目录即可运行;`README.md` 可以直接给用户看。
## 安装(三步,无需 pip)
1. 把 `scripts/douyin_dl.py` 和 `scripts/douyin_cdp.py` 放进**同一个文件夹**。
`douyin_dl.py` 通过 `os.path.dirname(__file__)` 定位 `douyin_cdp.py`,两个文件不能分开。
2. 装一个 Chromium 内核浏览器。Windows 一般已有 Chrome 或 Edge,直接可用。
找不到时设置环境变量:
```bash
# Windows (cmd)
set CHROME_PATH=D:\Chrome\chrome.exe
# Linux/macOS
export CHROME_PATH=/usr/bin/google-chrome
```
3. 可选:装 ffmpeg,用于图片转 JPG、视频转 GIF、**从视频里抽音轨**、以及下载后的时长校验。
```bash
winget install ffmpeg # Windows
brew install ffmpeg # macOS
sudo apt install ffmpeg # Debian/Ubuntu
```
没装也能跑,只是 webp 原图保持原格式、`--to-gif` 不可用、动图 GIF 转不了会退回 mp4、
`--audio` 退化为直接下载音乐轨(见「音频与配乐」)、校验退化为读文件头。
## 用法