
DouK-Downloader 音乐下载music 开关、三种用法与常见坑一次讲清【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader想把爆款短视频的 BGM 设成手机铃声不用下载完视频再手动剪出来DouK-Downloader 的音乐下载功能打开 music 开关后下载作品时会把它的 BGM 直接存成 mp3 文件。先搞懂音乐下载是怎么回事抖音 / TikTok 平台返回作品数据时会附带音乐信息字段音乐标题、作者、播放地址music_url。DouK-Downloader 的音乐下载就是围绕这个链接做的当配置文件里music参数为true时程序处理每个作品后都会把对应 BGM 下载为 mp3 文件不需要 FFmpeg 参与转码。适用边界作品数据里必须带music_url没有就跳过FFmpeg 在本项目只用于录制直播与这个功能无关参数定义见 默认配置参数。动手前准备好这几样按清单逐项确认即可Python 不低于 3.12项目源码需要本地源码时执行git clone https://gitcode.com/GitHub_Trending/ti/TikTokDownloader安装依赖uv sync --no-dev或pip install -r requirements.txtCookie 已写入配置文件cookie抖音、cookie_tiktokTikTok是必需参数获取方式看 Cookie 获取教程配置文件位置项目根目录下的Volume/settings.json首次运行自动生成Cookie 只需在失效后重新写入不必每次运行都填Cookie 过期是后续数据拿不到的最常见原因。三种方式提取音乐单个作品链接下载进入终端交互界面依次选择终端交互模式→批量下载链接作品→手动输入待采集的作品链接粘贴作品链接回车即可程序会同时下载作品文件和它的 BGM。如果不想每次都点菜单可以把这条流程写进run_command参数程序启动时会自动执行。整个账号批量下载想拿走某个账号全部视频的 BGM把账号写进配置文件的accounts_urls数组mark用于区分账号、enable控制是否启用{ accounts_urls: [ {mark: 目标账号, url: https://www.douyin.com/user/xxxxxx, tab: post, enable: true} ] }保存后重启程序选择批量下载账号作品即可。TikTok 账号对应accounts_urls_tiktok需要限定时间范围时用earliest/latest子参数完整字段说明见 配置文件参数表。Web API 接口调用适合开发者集成启动Web API 模式服务起来后访问http://127.0.0.1:5555/docs查看自动生成的接口文档用/douyin/detail接口可以拿到单作品数据里面就含音乐标题、作者等信息from httpx import post api http://127.0.0.1:5555/douyin/detail data {detail_id: 0123456789} response post(api, jsondata, headers{token: }) print(response.json())接口主要用于获取数据如果目标是让音乐文件直接落盘建议还是走前两种模式并打开music开关。音乐文件存在哪里音乐文件统一存到root参数指定路径下的Music子目录root默认是Volume。文件名不遵循name_format固定为音乐作者-音乐标题-作品ID扩展名.mp3。程序会按文件路径自动跳过已下载的作品重复运行不会产生重复文件。确认是否成功任务跑完后去Music目录看有没有新 mp3把storage_format设成csv、xlsx或sql采集数据里还会带上music_author、music_title、music_url字段方便核对实现细节可看 音乐下载逻辑。出问题了先查这三处music 开了却没出现 mp3→ 原因该作品数据里没有可用的music_url或全局下载开关download被关掉了 → 处理确认download为true换一个带音乐的作品再试。请求失败、响应里缺音乐字段→ 原因Cookie 过期 → 处理按 Cookie 获取教程 重新写入 Cookie 并重启程序。重新运行后文件没有更新→ 原因程序按路径判断并跳过已存在的文件 → 处理检查Music目录里旧文件是否完整文件正常时跳过是预期行为。进阶设置与使用边界max_size作品文件大小上限字节超出的作品直接跳过可用来过滤过大文件max_pages批量模式下限制数据请求的最大次数storage_format设为csv/xlsx/sql可把采集数据持久化方便后续整理音乐文件⚠️ README 中说明内置加密参数算法已过期失效若更新 Cookie 后仍持续取数失败先确认平台接口是否变化版权提醒音乐下载仅建议用于个人学习研究不要用于商业传播或任何侵犯知识产权的行为详见 README.md 的免责声明。如果你在提取某些特殊类型作品合拍、纯音频内容时拿不准程序能拿到什么数据欢迎在评论区贴出作品链接和终端输出一起分析。【免费下载链接】TikTokDownloader抖音 / TikTok 平台作品下载/数据采集工具项目地址: https://gitcode.com/GitHub_Trending/ti/TikTokDownloader创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考