+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,