whatisgithub

What is tiktokdownload?

johnserf-seed/tiktokdownload — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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.

What is it built with?

Python

How does it compare?

johnserf-seed/tiktokdownloadhypothesisworks/hypothesispdm-project/pdm
Stars8,6178,6198,619
LanguagePythonPythonPython
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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.

Frequently asked questions

What is tiktokdownload?

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.

What language is tiktokdownload written in?

Mainly Python. The stack also includes Python.

How hard is tiktokdownload to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tiktokdownload for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.