douyin-downloader 抖音音频下载四步批量收集背景音乐附配置教程【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloaderdouyin-downloader 是一个开源的抖音音频下载工具给它一个创作者主页或单个作品链接它会把作品里的原声音频批量存到本地自动去重并保留元数据。适合要收集背景音乐的创作者也适合只想留声音、不留视频文件的普通用户。完成一次完整的音频收集按四步走备环境、取凭证、配参数、跑任务。每步给一条命令或一段配置并说明如何确认它生效。第一步 备环境装依赖、复制配置文件需要 Python 3.8 及以上Windows、macOS、Linux 均可。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装成功的标志是 pip 打印出Successfully installed一行耗时几分钟取决于网络。随后复制一份自己的配置cp config.example.yml config.yml后续所有修改都发生在这份副本上。完整字段与默认值注释见 config.example.yml。第二步 取凭证自动抓取或手动填写 Cookie抖音需要登录态才能拉取作品列表凭证就是 config.yml 里的cookies字段。两种获取方式自动抓取推荐需要先装 playwrightpip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml终端会打开浏览器窗口登录抖音后回到终端按回车Cookie 自动写回 config.yml全程不用手工复制。实现逻辑在 tools/cookie_fetcher.py。手动填写打开抖音网页版的开发者工具从 Cookie 中复制msToken、ttwid、odin_tt、passport_csrf_token、sid_guard五个值填进 config.yml 的cookies段。验证方式跑任意一个下载任务作品列表能正常翻页、不报登录错误说明凭证可用。Cookie 会过期失效后重跑一次上面的自动抓取命令即可。第三步 配参数完成抖音音频下载的 3 个开关默认行为只保存视频本体音频、封面、JSON 都是附带产物默认关闭。这份 douyin-downloader 配置教程只改三行其余保持默认配置项设置作用videofalse不下载视频文件musictrue保存每条作品的原声音频mp3jsontrue额外生成 data.json保留作者、标题、发布时间只收单个创作者全部音频的最小任务link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ video: false # 不下载视频 music: true # 只保留原声音频 json: true # 生成元数据 mode: - post number: post: 0 # 0 不限条数拿不准的字段以 config.example.yml 内注释为准。第四步 跑任务一条命令收集整个主页的抖音背景音乐在 douyin-downloader 目录下运行python run.py -c config.yml。也可以不写配置文件直接在命令行追加链接例如python run.py -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded-t可临时指定并发数。成功标志终端出现进度条结束时汇总成功与失败计数打开Downloaded/对应作者目录下出现..._music.mp3和..._data.json。到这里抖音背景音乐批量下载已经跑通。如果不想敲命令桌面端 Douzy 与命令行共用同一套后端粘贴链接、点下载即可任务中心逐条显示结果。三类批量场景多主页、指定音乐页、直播间一次收多个创作者的主页link: - https://www.douyin.com/user/创作者A_sec_uid - https://www.douyin.com/user/创作者B_sec_uid - https://www.douyin.com/user/创作者C_sec_uid path: ./Downloaded/ video: false music: true json: true thread: 5 # 并发数程序为每个作者自动创建独立子目录作者目录命名方式可用author_dir调整同一次任务中同一作品跨模式也不会重复下载。直接指向一首音乐链接形如https://www.douyin.com/music/{music_id}时优先取该音乐的原声文件原声缺失时回退到使用这首音乐的首条作品再提取音频。配置与第三步相同只需把link换成音乐页链接mode/number可以省略。录制直播间的声音link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播 idle_timeout_seconds: 30直播链接会触发录制产物是一份 FLV 文件和*_room.json元数据落在Downloaded/{作者}/live/下。主播下播、网络空闲或你按 CtrlC 中断时已录到的字节会被保留而不是丢弃。想要纯音频可再用本地 ffmpeg 将 FLV 转成 mp3。抖音音频去重、失败重试与浏览器兜底去重由 SQLite 数据库默认dy_downloader.db加本地文件双重判断。increase各模式默认true主媒体文件已在磁盘上就跳过该条反过来删掉本地文件下次运行会重新下载。把同一个主页连跑两遍第二遍几乎全部跳过这就是抖音音频去重生效的样子。重试按指数退避执行retry_times默认 3 次间隔 1s、2s、5s。下载完成后还会比对 Content-Length不完整的文件自动清理并重下。任务结束时的失败计数告诉你哪些没成直接重跑任务即可补齐。浏览器兜底API 翻页常被风控截断在 20 条左右。browser_fallback.enabled默认true受限时程序自动启动浏览器继续翻页headless: false意味着窗口可见弹出验证码时手动完成验证、不要急着关窗。整体是「API 为主、浏览器兜底」的双引擎先走接口受限时自动切换重试。排错下载慢、只拿到 20 条、Cookie 失效、定时任务下载慢先把thread调到 3–5网络不稳时降并发反而更快请求频率默认 2 次/秒rate_limit不建议调高容易被风控。只拿到约 20 条翻页被风控截断。确认browser_fallback.enabled: true、headless: false并在弹窗里手动完成验证。Cookie 失效、批量失败重跑python -m tools.cookie_fetcher --config config.yml仍失败时检查链接是否有效、磁盘是否还有空间。定时自动收集Linux 加一行 crontab0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml download.log 21Windows 用任务计划程序指向同一条命令即可。下载后的目录结构和使用边界工作目录/ ├── config.yml ├── dy_downloader.db # 去重与下载历史 └── Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_标题_aweme_id/ ├── 标题_aweme_id_music.mp3 └── 标题_aweme_id_data.json层级由作者、模式和命名模板决定filename_template支持{author}、{date}等变量但模板里必须保留{id}防止重名覆盖。使用边界三条仅用于个人学习、研究与个人数据管理不用于侵犯版权与隐私不做二次分发。保留默认的rate_limit限速不要为求快去掉频率控制。Cookie 属于个人凭证不要分享给他人平台接口变更可能导致功能失效属正常技术风险。下一步① 按第一步克隆并安装依赖② 跑一次 Cookie 自动抓取③ 复制第三步的 3 个开关填入你的主页链接运行任务。更多字段与限制说明见 README.zh-CN.md配置全量注释在 config.example.yml许可协议见 LICENSE。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
douyin-downloader 抖音音频下载：四步批量收集背景音乐（附配置教程）
douyin-downloader 抖音音频下载四步批量收集背景音乐附配置教程【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloaderdouyin-downloader 是一个开源的抖音音频下载工具给它一个创作者主页或单个作品链接它会把作品里的原声音频批量存到本地自动去重并保留元数据。适合要收集背景音乐的创作者也适合只想留声音、不留视频文件的普通用户。完成一次完整的音频收集按四步走备环境、取凭证、配参数、跑任务。每步给一条命令或一段配置并说明如何确认它生效。第一步 备环境装依赖、复制配置文件需要 Python 3.8 及以上Windows、macOS、Linux 均可。git clone https://gitcode.com/GitHub_Trending/do/douyin-downloader cd douyin-downloader pip install -r requirements.txt安装成功的标志是 pip 打印出Successfully installed一行耗时几分钟取决于网络。随后复制一份自己的配置cp config.example.yml config.yml后续所有修改都发生在这份副本上。完整字段与默认值注释见 config.example.yml。第二步 取凭证自动抓取或手动填写 Cookie抖音需要登录态才能拉取作品列表凭证就是 config.yml 里的cookies字段。两种获取方式自动抓取推荐需要先装 playwrightpip install playwright python -m playwright install chromium python -m tools.cookie_fetcher --config config.yml终端会打开浏览器窗口登录抖音后回到终端按回车Cookie 自动写回 config.yml全程不用手工复制。实现逻辑在 tools/cookie_fetcher.py。手动填写打开抖音网页版的开发者工具从 Cookie 中复制msToken、ttwid、odin_tt、passport_csrf_token、sid_guard五个值填进 config.yml 的cookies段。验证方式跑任意一个下载任务作品列表能正常翻页、不报登录错误说明凭证可用。Cookie 会过期失效后重跑一次上面的自动抓取命令即可。第三步 配参数完成抖音音频下载的 3 个开关默认行为只保存视频本体音频、封面、JSON 都是附带产物默认关闭。这份 douyin-downloader 配置教程只改三行其余保持默认配置项设置作用videofalse不下载视频文件musictrue保存每条作品的原声音频mp3jsontrue额外生成 data.json保留作者、标题、发布时间只收单个创作者全部音频的最小任务link: - https://www.douyin.com/user/MS4wLjABAAAAxxxx path: ./Downloaded/ video: false # 不下载视频 music: true # 只保留原声音频 json: true # 生成元数据 mode: - post number: post: 0 # 0 不限条数拿不准的字段以 config.example.yml 内注释为准。第四步 跑任务一条命令收集整个主页的抖音背景音乐在 douyin-downloader 目录下运行python run.py -c config.yml。也可以不写配置文件直接在命令行追加链接例如python run.py -u https://www.douyin.com/video/7604129988555574538 -p ./Downloaded-t可临时指定并发数。成功标志终端出现进度条结束时汇总成功与失败计数打开Downloaded/对应作者目录下出现..._music.mp3和..._data.json。到这里抖音背景音乐批量下载已经跑通。如果不想敲命令桌面端 Douzy 与命令行共用同一套后端粘贴链接、点下载即可任务中心逐条显示结果。三类批量场景多主页、指定音乐页、直播间一次收多个创作者的主页link: - https://www.douyin.com/user/创作者A_sec_uid - https://www.douyin.com/user/创作者B_sec_uid - https://www.douyin.com/user/创作者C_sec_uid path: ./Downloaded/ video: false music: true json: true thread: 5 # 并发数程序为每个作者自动创建独立子目录作者目录命名方式可用author_dir调整同一次任务中同一作品跨模式也不会重复下载。直接指向一首音乐链接形如https://www.douyin.com/music/{music_id}时优先取该音乐的原声文件原声缺失时回退到使用这首音乐的首条作品再提取音频。配置与第三步相同只需把link换成音乐页链接mode/number可以省略。录制直播间的声音link: - https://live.douyin.com/123456789 live: max_duration_seconds: 3600 # 0 录到主播下播 idle_timeout_seconds: 30直播链接会触发录制产物是一份 FLV 文件和*_room.json元数据落在Downloaded/{作者}/live/下。主播下播、网络空闲或你按 CtrlC 中断时已录到的字节会被保留而不是丢弃。想要纯音频可再用本地 ffmpeg 将 FLV 转成 mp3。抖音音频去重、失败重试与浏览器兜底去重由 SQLite 数据库默认dy_downloader.db加本地文件双重判断。increase各模式默认true主媒体文件已在磁盘上就跳过该条反过来删掉本地文件下次运行会重新下载。把同一个主页连跑两遍第二遍几乎全部跳过这就是抖音音频去重生效的样子。重试按指数退避执行retry_times默认 3 次间隔 1s、2s、5s。下载完成后还会比对 Content-Length不完整的文件自动清理并重下。任务结束时的失败计数告诉你哪些没成直接重跑任务即可补齐。浏览器兜底API 翻页常被风控截断在 20 条左右。browser_fallback.enabled默认true受限时程序自动启动浏览器继续翻页headless: false意味着窗口可见弹出验证码时手动完成验证、不要急着关窗。整体是「API 为主、浏览器兜底」的双引擎先走接口受限时自动切换重试。排错下载慢、只拿到 20 条、Cookie 失效、定时任务下载慢先把thread调到 3–5网络不稳时降并发反而更快请求频率默认 2 次/秒rate_limit不建议调高容易被风控。只拿到约 20 条翻页被风控截断。确认browser_fallback.enabled: true、headless: false并在弹窗里手动完成验证。Cookie 失效、批量失败重跑python -m tools.cookie_fetcher --config config.yml仍失败时检查链接是否有效、磁盘是否还有空间。定时自动收集Linux 加一行 crontab0 2 * * * cd /path/to/douyin-downloader python run.py -c config.yml download.log 21Windows 用任务计划程序指向同一条命令即可。下载后的目录结构和使用边界工作目录/ ├── config.yml ├── dy_downloader.db # 去重与下载历史 └── Downloaded/ ├── download_manifest.jsonl └── 作者名/ └── post/ └── 2024-02-07_标题_aweme_id/ ├── 标题_aweme_id_music.mp3 └── 标题_aweme_id_data.json层级由作者、模式和命名模板决定filename_template支持{author}、{date}等变量但模板里必须保留{id}防止重名覆盖。使用边界三条仅用于个人学习、研究与个人数据管理不用于侵犯版权与隐私不做二次分发。保留默认的rate_limit限速不要为求快去掉频率控制。Cookie 属于个人凭证不要分享给他人平台接口变更可能导致功能失效属正常技术风险。下一步① 按第一步克隆并安装依赖② 跑一次 Cookie 自动抓取③ 复制第三步的 3 个开关填入你的主页链接运行任务。更多字段与限制说明见 README.zh-CN.md配置全量注释在 config.example.yml许可协议见 LICENSE。【免费下载链接】douyin-downloaderA practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具去水印支持视频、图集、合集、音乐(原声)。项目地址: https://gitcode.com/GitHub_Trending/do/douyin-downloader创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
