Skip to content
Get packs

Douyin Downloader

Open-source tool to download Douyin videos, photos, and profile posts without watermarks, via a desktop app or

GitHub Download desktop-v0.12.5
Stars
12.5k
Forks
1.9k
Licence
MIT
Language
Python
Last update
5 days ago
Type
App

What it is

This project downloads Douyin (TikTok's Chinese counterpart) videos and photos without watermarks. It offers a desktop app called Douzy for everyday use, and a Python command-line tool for scripts and batch jobs. The README says the CLI currently only handles Douyin and is blocked by Douyin's request verification for many single-item downloads, so the desktop app is the recommended route.

  • Save a creator's recent profile posts to a local folder using the CLI with a post limit
  • Skip already-downloaded items on repeat runs using the incremental setting
  • Filter profile downloads to a date range using start and end dates
  • Use the Douzy desktop app to paste links and browse a local archive

Great for

  • People who want to archive their own or a creator's public Douyin posts for personal reference
  • Users comfortable running Python commands who want scripted profile downloads
  • Anyone who wants a desktop interface covering several platforms, such as TikTok or YouTube, alongside Douyin

Not ideal for

  • Users who need guaranteed CLI downloads of individual videos, collections, music, likes, or favorites, because the README says Douyin's verification currently blocks these
  • People who are not comfortable with terminal setup, cookies, and a browser automation dependency
  • Anyone planning to redistribute downloaded content, since the README asks users to respect copyright and platform rules
Step-by-step guide: how to use Douyin DownloaderInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Clone and build from source

    You'll need: Python 3.9+ · Playwright with Chromium (installed by the README steps)

    Clone the repository

    git clone https://github.com/jiji262/douyin-downloader.git

    Install Python dependencies

    python -m pip install -r requirements.txt

    Install Playwright

    python -m pip install playwright

    Install Chromium for Playwright

    python -m playwright install chromium
  2. 2

    Run it

    • Copy config.example.yml to config.yml
    • Run python -m tools.cookie_fetcher --config config.yml and sign in to Douyin in the browser, then press Enter
    • Replace the sample link in config.yml with a profile URL and adjust the number and mode settings
    • Run python run.py -c config.yml
  3. 3

    Get the most out of it

    • Use the increase.post setting to skip already-downloaded items on repeat runs
    • Set start_time and end_time to limit profile downloads to a date range
    • Use -u to add URLs from the command line without editing the config
    • Use -v for detailed logs when troubleshooting
    • Try the optional REST API with --serve if you want programmatic access

Downloads

Source code (.zip)main branch · straight from GitHubRelease desktop-v0.12.58 files incl. Douzy-0.12.5-arm64.dmg

Strengths

  • Supports single-item and profile batch downloads, with retries and download history
  • Includes a desktop app (Douzy) for Windows and macOS, so no terminal is needed for basic use
  • MIT licensed and open source, with a large community following on GitHub

Trade-offs

  • The README states that Douyin's verification currently blocks many CLI downloads, and retrying or refreshing cookies does not fix this
  • Some desktop features and batch features require activation or plugins, per the README
  • Depends on your own cookies and browser fallback, which can break when the platform changes

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.