explaingit

johnserf-seed/tiktokdownload

8,617PythonAudience · generalComplexity · 2/5Setup · moderate

TLDR

Python command-line tool for bulk-downloading TikTok and DouYin videos, images, and audio without watermarks, with async downloads, date filtering, and proxy support. Now deprecated in favour of F2.

Mindmap

mindmap
  root((TikTokDownload))
    What it does
      Bulk video download
      Watermark removal
      Async downloads
    Platforms
      TikTok
      DouYin
    Content types
      Videos
      Images
      Audio
      Subtitles
    Features
      Proxy support
      Date filtering
      Notifications
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Download all of a DouYin user's posted videos without watermarks in a single command to a local folder.

USE CASE 2

Archive a TikTok account's liked or favorited content with a custom file naming template.

USE CASE 3

Schedule daily downloads of new content from specific accounts using date-range filtering.

USE CASE 4

Route downloads through a proxy to access content regardless of regional restrictions.

Tech stack

Python

Getting it running

Difficulty · moderate Time to first run · 30min

Requires authentication cookies from TikTok or DouYin, the active project has moved to the F2 package.

In plain English

TikTokDownload is a Python tool for downloading videos and other content from TikTok and its Chinese counterpart DouYin, with watermarks removed. The README is primarily in Chinese, but an English version is also available. The tool works from the command line and is aimed at users who want to save content from these platforms in bulk. For DouYin, the tool can fetch and save a user's posted videos, liked videos, favorited items, image collections, short dramas, livestream recordings, and playlist content. It can also download the original audio, cover images, and subtitles for each post. The TikTok side covers a similar set: posted videos, favorites, liked videos, image collections, playlists, and search results. Both platforms require the user to provide authentication cookies so the tool can access account data. Downloads run asynchronously, meaning the tool can process and retrieve multiple files at the same time rather than waiting for each one to finish before starting the next. Other configurable options include choosing a custom save folder, setting file naming templates, applying proxy settings, filtering by date range, and controlling how many items to fetch in a single run. The project includes local implementations of the signature algorithms that TikTok and DouYin use to validate API requests. These are reverse-engineered parameters with names like ABogus, XBogus, and x-tt-params that the platforms check when serving content to apps and browsers. This repository represents an older version of the project. The active development has moved to a related package called F2, which is available separately on PyPI and covers the same platforms with a more modular structure. Installation instructions and documentation are linked from the repository to an external documentation site. The tool supports Windows, macOS, and common Linux distributions.

Copy-paste prompts

Prompt 1
Show me how to set up TikTokDownload, provide my DouYin cookies, and download all videos from a specific user to a folder.
Prompt 2
Walk me through configuring TikTokDownload to filter downloads by date so I only get videos from the last 30 days.
Prompt 3
How do I run TikTokDownload on GitHub Actions on a schedule to archive a TikTok account automatically?
Prompt 4
TikTokDownload is deprecated, help me migrate to the F2 package and replicate my existing download configuration.
Open on GitHub → Explain another repo

← johnserf-seed on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.