base on TikTok 主页/合辑/直播/视频/图集/原声；抖音主页/视频/图集/实况/收藏/直播/原声/合集/评论/账号/搜索/热榜数据采集工具 <div align="center"> <img src="https://github.com/JoeanAmier/TikTokDownloader/blob/master/static/images/TikTokDownloader.png" alt="TikTokDownloader" height="256" width="256"><br> <h1>TikTokDownloader</h1> <p>简体中文 | <a href="README_EN.md">English</a></p> <img alt="GitHub" src="https://img.shields.io/github/license/JoeanAmier/TikTokDownloader?style=for-the-badge&color=ff6348"> <img alt="GitHub forks" src="https://img.shields.io/github/forks/JoeanAmier/TikTokDownloader?style=for-the-badge&color=ffa502"> <img alt="GitHub Repo stars" src="https://img.shields.io/github/stars/JoeanAmier/TikTokDownloader?style=for-the-badge&color=ffee6f"> <img alt="GitHub code size in bytes" src="https://img.shields.io/github/languages/code-size/JoeanAmier/TikTokDownloader?style=for-the-badge&color=13c2c2"> <br> <img alt="Static Badge" src="https://img.shields.io/badge/Python-3.12-3498db?style=for-the-badge&logo=python&labelColor=fffa65"> <img alt="GitHub release (with filter)" src="https://img.shields.io/github/v/release/JoeanAmier/TikTokDownloader?style=for-the-badge&color=ff7675"> <img src="https://img.shields.io/badge/Sourcery-enabled-884898?style=for-the-badge&color=e056fd" alt=""> <img alt="GitHub all releases" src="https://img.shields.io/github/downloads/JoeanAmier/TikTokDownloader/total?style=for-the-badge&color=52c41a"> </div> <br> <p>🔥 <b>TikTok 主页/合辑/直播/视频/图集/原声；抖音主页/视频/图集/收藏/直播/原声/合集/<del>评论</del>/<del>账号</del>/<del>搜索</del>/热榜数据采集工具：</b>完全开源，基于 HTTPX 模块实现的免费工具；批量下载抖音账号发布、喜欢、收藏作品；批量下载 TikTok 账号发布、喜欢作品；下载抖音链接或 TikTok 链接作品；获取抖音直播推流地址；下载抖音直播视频；获取 TikTok 直播推流地址；下载 TikTok 直播视频；<del>采集抖音作品评论数据</del>；批量下载抖音合集作品；批量下载 TikTok 合辑作品；<del>采集抖音账号详细数据</del>；<del>采集抖音用户 / 作品 / 直播搜索结果</del>；采集抖音热榜数据。</p> <p>⚠️ 本项目 <code>5.5 Beta</code> 正在重构代码，部分功能可能无法正常使用，建议暂时使用 <code>5.4</code> 版本！</p> <p>⭐ 本项目完全免费开源，无任何收费功能，请勿上当受骗！</p> <hr> # 📝 项目功能\(Function\) * ✅ 下载抖音无水印视频/图集 * ✅ 下载 TikTok 无水印视频/图集 * ✅ 批量下载抖音账号发布/喜欢/收藏作品 * ✅ 批量下载 TikTok 账号发布/喜欢作品 * ✅ 采集抖音 / TikTok 详细数据 * ✅ 批量下载链接作品 * ✅ 多账号批量下载作品 * ✅ 自动跳过已下载的文件 * ✅ 持久化保存采集数据 * ✅ 下载动态/静态封面图 * ✅ 获取抖音直播推流地址 * ✅ 获取 TikTok 直播推流地址 * ✅ 调用 ffmpeg 下载直播 * ✅ Web UI 交互界面 * ✅ 采集抖音作品评论数据 * ✅ 批量下载抖音合集作品 * ✅ 批量下载 TikTok 合辑作品 * ✅ 记录点赞收藏等统计数据 * ✅ 筛选作品发布时间 * ✅ 支持账号作品增量下载 * ✅ 支持使用代理采集数据 * ✅ 支持局域网远程访问 * ✅ 采集抖音账号详细数据 * ✅ 作品统计数据更新 * ✅ 自动更新账号昵称 * ✅ 部署至私有服务器 * ✅ 部署至公开服务器 * ✅ 采集抖音搜索数据 * ✅ 采集抖音热榜数据 * ✅ 记录已下载作品 ID * ☑️ ~~扫码登陆获取 Cookie~~ * ✅ 从浏览器获取 Cookie * ✅ 支持 Web API 调用 * ✅ 支持多线程下载作品 * ✅ 文件完整性处理机制 * ✅ 自定义规则筛选作品 * ✅ 支持文件断点续传下载 # 💻 程序界面\(Screenshot\) **终端交互模式：** <br><br>  *****  *****  <br><br> **Web UI 交互模式：** <br><br>  *****  *****  <br><br> **Web API 接口模式：** <br><br>  # 📽 运行演示\(Example\) <p><b>🎥 点击图片观看演示视频，建议通过配置文件管理账号，更多介绍请查阅 <a href="https://github.com/JoeanAmier/TikTokDownloader/wiki/Documentation">文档</a></b></p> [](https://www.bilibili.com/video/BV1yr421K7qj/) # 📈 项目状态\(Status\) * 🟢 经过测试，[Releases](https://github.com/JoeanAmier/TikTokDownloader/releases/latest) 发布的源码已经验证所有功能正常可用 * 🟡 TikTokDownloader 开发计划及进度可前往 [Projects](https://github.com/users/JoeanAmier/projects/2) 查阅 * 🔴 请注意，最新源码\(Beta 版本\)可能存在一些不稳定的 Bug * 🔴 如果在使用过程中发现程序 Bug，请及时告知作者修复 # 📋 项目说明\(Instructions\) ## 快速入门 <p>⭐ Mac OS、Windows 10 及以上用户可前往 <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> 下载已编译的程序，开箱即用！</p> <p><strong>注意：Mac OS 平台可执行文件 <code>main</code> 可能需要从终端命令行启动；受设备限制，Mac OS 平台可执行文件尚未经过测试，无法保证可用性！</strong></p> <hr> <ol> <li><b>运行可执行文件</b> 或者 <b>配置环境运行</b> <ol><b>运行可执行文件</b> <li>下载 <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> 发布的可执行文件压缩包</li> <li>解压后打开程序文件夹，双击运行 <code>main</code></li> </ol> <ol><b>配置环境运行</b> <li>安装不低于 <code>3.12</code> 版本的 <a href="https://www.python.org/">Python</a> 解释器</li> <li>下载最新的源码或 <a href="https://github.com/JoeanAmier/TikTokDownloader/releases/latest">Releases</a> 发布的源码至本地</li> <li>运行 <code>python -m venv venv</code> 命令创建虚拟环境（可选）</li> <li>运行 <code>.\venv\Scripts\activate.ps1</code> 或者 <code>venv\Scripts\activate</code> 命令激活虚拟环境（可选）</li> <li>运行 <code>pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt</code> 命令安装程序所需模块</li> <li>运行 <code>python .\main.py</code> 或者 <code>python main.py</code> 命令启动 TikTokDownloader</li> </ol> </li> <li>阅读 TikTokDownloader 的免责声明，根据提示输入内容</li> <li>将 Cookie 信息写入配置文件 <ol><b>手动复制粘贴 Cookie（推荐）</b> <li>参考 <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/Cookie%E8%8E%B7%E5%8F%96%E6%95%99%E7%A8%8B.md">Cookie 提取教程</a>，复制所需 Cookie 至剪贴板</li> <li>选择 <code>复制粘贴写入 Cookie</code> 选项，按照提示将 Cookie 写入配置文件</li> </ol> <ol><b>从浏览器获取 Cookie（推荐）</b> <li>选择 <code>从浏览器获取 Cookie</code> 选项，按照提示选择浏览器类型</li> </ol> <ol><b>扫码登录获取 Cookie（弃用）</b> <li>选择 <code>扫码登录获取 Cookie</code> 选项，程序会显示登录二维码图片，并使用默认应用打开图片</li> <li>使用抖音 APP 扫描二维码并登录账号</li> <li>按照提示操作，将 Cookie 写入配置文件</li> </ol> </li> <li>返回程序界面，依次选择 <code>终端交互模式</code> -> <code>批量下载链接作品(通用)</code> -> <code>手动输入待采集的作品链接</code></li> <li>输入抖音作品链接即可下载作品文件（TikTok 平台需要更多初始设置，详见文档）</li> <li>更多详细说明请查看 <b><a href="https://github.com/JoeanAmier/TikTokDownloader/wiki/Documentation">项目文档</a></b></li> </ol> <p>⭐ 推荐使用 <a href="https://learn.microsoft.com/zh-cn/windows/terminal/install">Windows 终端</a>（Windows 11 自带默认终端）</p> ### Docker 容器 <ol> <li>获取镜像</li> <ul> <li>方式一：使用 <code>Dockerfile</code> 文件构建镜像</li> <li>方式二：使用 <code>docker pull joeanamier/tiktokdownloader</code> 命令拉取镜像</li> </ul> <li>创建容器：<code>docker run -it joeanamier/tiktokdownloader</code></li> <li>运行容器 <ul> <li>启动容器：<code>docker start -i 容器名称/容器 ID</code></li> <li>重启容器：<code>docker restart -i 容器名称/容器 ID</code></li> </ul> </li> </ol> <p>Docker 容器无法直接访问宿主机的文件系统，部分功能不可用，例如：<code>从浏览器获取 Cookie</code>；其他功能如有异常请反馈！</p> <hr> ## 关于 Cookie [点击查看 Cookie 获取教程](https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/Cookie%E8%8E%B7%E5%8F%96%E6%95%99%E7%A8%8B.md) | 程序功能 | 是否需要登录 | |:--------:|:------:| | 下载账号发布作品 | ⭕建议登录 | | 下载账号喜欢作品 | ⭕建议登录 | | 下载链接作品 | ⭕建议登录 | | 获取直播推流地址 | ❌无需登录 | | 下载直播视频 | ❌无需登录 | | 获取作品评论数据 | ⭕建议登录 | | 下载合集作品 | ⭕建议登录 | | 获取账号数据 | ⭕建议登录 | | 采集搜索结果 | ⭕建议登录 | | 采集热榜数据 | ❌无需登录 | | 下载收藏作品 | ✔️需要登录 | | 下载收藏夹作品 | ✔️需要登录 | | 获取收藏合集数据 | ✔️需要登录 | | 获取收藏音乐数据 | ✔️需要登录 | | 获取收藏短剧数据 | ✔️需要登录 | > * Cookie 仅需在失效后重新写入配置文件，并非每次运行程序都要写入配置文件！ > > * Cookie 会影响抖音平台下载的视频文件分辨率，如果无法下载 1080P 视频文件，请尝试更新 Cookie！ > > * 程序获取数据失败时，可以尝试更新 Cookie 或者使用已登录的 Cookie！ <hr> ## 其他说明 <ul> <li>程序提示用户输入时，直接回车代表返回上级菜单，输入 <code>Q</code> 或 <code>q</code> 代表结束运行</li> <li>由于获取账号喜欢作品和收藏作品数据仅返回喜欢 / 收藏作品的发布日期，不返回操作日期，因此程序需要获取全部喜欢 / 收藏作品数据再进行日期筛选；如果作品数量较多，可能会花费较长的时间；可通过 <code>max_pages</code> 参数控制请求次数</li> <li>获取私密账号的发布作品数据需要登录后的 Cookie，且登录的账号需要关注该私密账号</li> <li>批量下载账号作品或合集作品时，如果对应的昵称或标识发生变化，程序会自动更新已下载作品文件名称中的昵称和标识</li> <li>程序下载文件时会先将文件下载至临时文件夹，下载完成后再移动至储存文件夹；程序运行结束时会清空临时文件夹</li> <li><code>批量下载收藏作品模式</code> 目前仅支持下载当前已登录 Cookie 对应账号的收藏作品，暂不支持多账号</li> <li>如果想要程序使用代理请求数据，必须在 <code>settings.json</code> 设置 <code>proxy</code> 参数，否则程序不会使用代理</li> <li>退出程序时，请以正常方式结束运行或者按下 Ctrl + C 结束运行，不要直接点击终端窗口的关闭按钮结束运行，否则会导致数据丢失</li> <li>如果您的计算机没有合适的程序编辑 JSON 文件，建议使用 <a href="https://try8.cn/tool/format/json">JSON 在线工具</a> 编辑配置文件内容</li> <li>当程序请求用户输入内容或链接时，请注意避免输入的内容或链接包含换行符，这可能会导致预期之外的问题</li> <li>本项目不会支持付费作品下载，请勿反馈任何关于付费作品下载的问题</li> <li>Windows 系统需要以管理员身份运行程序才能读取 Chromium、Chrome、Edge 浏览器 Cookie</li> </ul> <hr> ## 程序更新 > **方案一：** 下载并解压文件，将旧版本的 `TikTokDownloader.db` 文件和 `settings.json` 文件复制到 `_internal` 文件夹。 > **方案二：** 下载并解压文件（不要运行程序），复制全部文件，直接覆盖旧版本文件。 # ⚠️ 免责声明\(Disclaimers\) <ul> <li>使用者对本项目的使用由使用者自行决定，并自行承担风险。作者对使用者使用本项目所产生的任何损失、责任、或风险概不负责。</li> <li>本项目的作者提供的代码和功能是基于现有知识和技术的开发成果。作者尽力确保代码的正确性和安全性，但不保证代码完全没有错误或缺陷。</li> <li>使用者在使用本项目时必须严格遵守 <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/license">GNU General Public License v3.0</a> 的要求，并在适当的地方注明使用了 <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/license">GNU General Public License v3.0</a> 的代码。 </li> <li>使用者在任何情况下均不得将本项目的作者、贡献者或其他相关方与使用者的使用行为联系起来，或要求其对使用者使用本项目所产生的任何损失或损害负责。</li> <li>使用者在使用本项目的代码和功能时，必须自行研究相关法律法规，并确保其使用行为合法合规。任何因违反法律法规而导致的法律责任和风险，均由使用者自行承担。</li> <li>本项目的作者不会提供 TikTokDownloader 项目的付费版本，也不会提供与 TikTokDownloader 项目相关的任何商业服务。</li> <li>基于本项目进行的任何二次开发、修改或编译的程序与原创作者无关，原创作者不承担与二次开发行为或其结果相关的任何责任，使用者应自行对因二次开发可能带来的各种情况负全部责任。</li> </ul> <b>在使用本项目的代码和功能之前，请您认真考虑并接受以上免责声明。如果您对上述声明有任何疑问或不同意，请不要使用本项目的代码和功能。如果您使用了本项目的代码和功能，则视为您已完全理解并接受上述免责声明，并自愿承担使用本项目的一切风险和后果。</b> # ✉️ 联系作者\(Contact\) <ul> <li>作者邮箱：[email protected]</li> <li>作者微信: Downloader_Tools</li> <li>微信公众号: Downloader Tools</li> <li><b>Discord 社区</b>: <a href="https://discord.com/invite/ZYtmgKud9Y">点击加入社区</a></li> <li>QQ 群聊(项目交流): <a href="https://github.com/JoeanAmier/TikTokDownloader/blob/master/docs/QQ%E7%BE%A4%E8%81%8A%E4%BA%8C%E7%BB%B4%E7%A0%81.png">扫码加入群聊</a></li> </ul> <p>✨ <b>作者的其他开源项目：</b></p> <ul> <li><b>XHS-Downloader（小红书）</b>：<a href="https://github.com/JoeanAmier/XHS-Downloader">https://github.com/JoeanAmier/XHS-Downloader</a></li> <li><b>KS-Downloader（快手）</b>：<a href="https://github.com/JoeanAmier/KS-Downloader">https://github.com/JoeanAmier/KS-Downloader</a></li> </ul> # ♥️ 支持项目\(Support\) <p>如果 <b>TikTokDownloader</b> 对您有帮助，请考虑为它点个 <b>Star</b> ⭐，感谢您的支持！</p> <table> <thead> <tr> <th align="center">微信(WeChat)</th> <th align="center">支付宝(Alipay)</th> </tr> </thead> <tbody><tr> <td align="center"><img src="./docs/微信赞助二维码.png" alt="微信赞助二维码" height="200" width="200"></td> <td align="center"><img src="./docs/支付宝赞助二维码.png" alt="支付宝赞助二维码" height="200" width="200"></td> </tr> </tbody> </table> <p>如果您愿意，可以考虑提供资助为 <b>TikTokDownloader</b> 提供额外的支持！</p> # 💰 项目赞助\(Sponsor\) ## JetBrains 工具  **JetBrains** 支持全球开源社区认可的活跃项目，并为非商业开发提供免费许可证。 *** ## TikHub <img src="docs/赞助商_TikHub_Logo.png" alt="TikHub"> <p><a href="https://tikhub.io/">TikHub</a> 是一家领先的数据接口服务供应商，专注于提供高质量的数据接口，涵盖了多个热门平台，包括 抖音、TikTok、小红书、Instagram、Twitter 和 快手 等平台。</p> <p>TikHub 还提供定制化的服务，如直播间监控、作品监控和达人监控，以满足不同业务场景的需求。</p> <p>通过每日签到，用户可以免费获取一定额度的使用量；可以使用我的 <strong>推荐链接</strong>：<a href="https://beta-web.tikhub.io/users/signup?referral_code=X084IATy">https://beta-web.tikhub.io/users/signup?referral_code=X084IATy</a> 或 <strong>推荐码</strong>：<code>X084IATy</code>，注册并充值即可获得 <code>$2</code> 额度！</p> <p><a href="https://tikhub.io/">TikHub</a> 提供以下服务：</p> <ul> <li>丰富的数据接口</li> <li>每日签到免费获取额度</li> <li>高质量的 API 服务</li> <li>官网：<a href="https://tikhub.io/">https://tikhub.io/</a></li> <li>项目地址：<a href="https://github.com/TikHubIO/">https://github.com/TikHubIO/</a></li> <li>用户登陆地址：<a href="https://beta-web.tikhub.io/">https://beta-web.tikhub.io/</a></li> </ul> # 💡 项目参考\(Refer\) * https://github.com/Johnserf-Seed/f2 * https://github.com/Johnserf-Seed/TikTokDownload * https://github.com/Evil0ctal/Douyin_TikTok_Download_API * https://github.com/NearHuiwen/TiktokDouyinCrawler * https://github.com/ihmily/DouyinLiveRecorder * https://github.com/encode/httpx/ * https://github.com/Textualize/rich * https://github.com/omnilib/aiosqlite * https://github.com/Tinche/aiofiles * https://github.com/thewh1teagle/rookie * https://github.com/pyinstaller/pyinstaller * https://foss.heptapod.net/openpyxl/openpyxl * https://github.com/carpedm20/emoji/ * https://github.com/lxml/lxml * https://ffmpeg.org/ffmpeg-all.html * https://html5up.net/hyperspace ", Assign "at most 3 tags" to the expected json: {"id":"6222","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"