jiji262 /douyin-downloader

A practical Douyin downloader for both single-item and profile batch downloads, with progress display, retries, SQLite deduplication, and browser fallback support. 抖音批量下载工具,去水印,支持视频、图集、合集、音乐(原声)。

★ 12,529⑂ 1,919👁 57▤ 2
PythonCreated 2023-05-25
+0
Daily
+0
Weekly
+257
Monthly
12,529
stars
1,919
forks
57
watchers
–
prs
–
issues
2
releases

README

Douyin Downloader


  


简体中文 · English

Download Douyin videos and photos without watermarks. Use Douzy for a desktop interface, or the Python CLI for scripts.

 Douzy Desktop

A desktop app for Douyin, TikTok, YouTube, Telegram, and X. Paste links, track downloads, and browse your local archive.

Download for Windows / macOS

Platform features depend on enabled plugins or local components. Some batch and advanced features require activation.

| Platform | Content |
|:---|:---|
| Douyin | Videos, photos, profiles, collections; following, subscriptions, favorites, and likes |
| TikTok | Public videos, photos, and profiles |
| YouTube | Videos, Shorts, channels, and playlists; audio and subtitles |
| Telegram | Media from accessible chats, groups, and channels; requires setup and sign-in |
| X | Posts, profile media, your bookmarks and likes; requires account cookies |

| Douyin | TikTok | YouTube |
|:---:|:---:|:---:|
|  |  |  |
| Telegram setup | X | Platform switcher |
|  |  |  |

_Screenshots: Douzy 0.11.6 on macOS. Telegram is shown before setup. Click an image to enlarge._

 CLI Status

The CLI supports Douyin only. It includes batch downloads, date filters, retries, download history, and optional comments, transcription, and notifications.

 Download limitations: Douyin's request verification currently blocks CLI downloads of individual videos/photos, collections, music, likes, and favorites. Profile posts can try the Playwright browser fallback, but success is not guaranteed. Use Douzy for everyday downloads.

Refreshing cookies or retrying does not fix this verification block. Live recording is experimental; HLS sources save a playlist, not a playable video.

 Quick Start

Requires Python 3.9+ on Windows, macOS, or Linux. Read the CLI limitations above first.

 1. Install

bash
git clone https://github.com/jiji262/douyin-downloader.git
cd douyin-downloader
python -m pip install -r requirements.txt
python -m pip install playwright
python -m playwright install chromium


 2. Configure and sign in

Copy config.example.yml to config.yml:

bash
cp config.example.yml config.yml
python -m tools.cookie_fetcher --config config.yml


On Windows PowerShell, use Copy-Item config.example.yml config.yml to copy the file. Sign in to Douyin in the browser, then return to the terminal and press Enter to save cookies.

Replace the sample link in config.yml with your creator's profile URL. Keep the saved cookies and adjust these fields:

yaml
link:
  - https://www.douyin.com/user/YOUR_SEC_UID
path: ./Downloaded/
mode: [post]
number:
  post: 10                  0 = unlimited
increase:
  post: true               skip downloaded items
redownload_missing_files: true


 3. Run

bash
python run.py -c config.yml


Use python run.py --help for all options.

| Option | Purpose |
|:---|:---|
| -c, --config | Config file |
| -u, --url | Append a URL to the links in the config; repeatable |
| -p, --path | Download folder |
| -t, --thread | Concurrent downloads |
| -v, 

Snapshot: 2026-11-04T14:00:00Z · Data license Apache-2.0 · JSON