# johnserf-seed/tiktokdownload

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/johnserf-seed-tiktokdownload).**

8,673 stars · 1,492 forks · Python · MIT

## Links

- GitHub: https://github.com/Johnserf-Seed/TikTokDownload
- Homepage: https://github.com/Johnserf-Seed/f2
- awesome-repositories: https://awesome-repositories.com/repository/johnserf-seed-tiktokdownload.md

## Topics

`api` `douyin` `plugin` `python` `tiktok` `utools` `xbogus`

## Description

TikTokDownload is a configurable batch video downloader for TikTok and Douyin that strips watermarks and supports automated downloads from user profiles, likes, and collections. It functions as a social media content archiving tool, enabling users to download videos and audio from these platforms for offline viewing or personal backup.

The project distinguishes itself through a modular download pipeline that combines audio extraction, batch scheduling, config-driven workflows, cookie-based authentication, URL parsing, paginated API scraping, and watermark removal. It uses a settings file to control output paths, skip logic, and batch behavior, and reuses browser cookies to authenticate API requests without requiring OAuth tokens or login credentials.

The tool supports both batch user profile downloads and single video link downloads, with the ability to extract watermark-free video streams by intercepting and reassembling CDN fragments before the platform applies overlay watermarks. It also separates audio tracks from video containers by parsing MP4/M4A metadata and downloading independent audio streams.

The project is configured through a local settings file that controls download options such as output directory and skip-downloaded file logic, with a batch-queue scheduler managing concurrent download tasks using a producer-consumer pattern with configurable rate limiting and retry logic.

## Tags

### Graphics & Multimedia

- [Douyin Video Downloads](https://awesome-repositories.com/f/graphics-multimedia/video-downloaders/douyin-video-downloads.md) — Downloads videos from TikTok and Douyin without watermarks for offline viewing or archiving.
- [Share Link to Video Resolvers](https://awesome-repositories.com/f/graphics-multimedia/share-link-to-video-resolvers.md) — Extracts user and media identifiers from share links by resolving redirect chains and parsing query parameters.
- [Watermark-Free Media Retrieval](https://awesome-repositories.com/f/graphics-multimedia/watermark-free-media-retrieval.md) — Downloads TikTok and Douyin videos stripped of watermarks from user profiles, likes, collections, and audio. ([source](https://cdn.jsdelivr.net/gh/johnserf-seed/tiktokdownload@main/README.md))
- [Download Behavior Configurations](https://awesome-repositories.com/f/graphics-multimedia/download-output-configuration/download-behavior-configurations.md) — Configures download options like output folder and skip-downloaded files through a configuration file. ([source](https://cdn.jsdelivr.net/gh/johnserf-seed/tiktokdownload@main/README.md))
- [Audio Track Extraction](https://awesome-repositories.com/f/graphics-multimedia/video-content-repurposing/video-clip-extraction/audio-track-extraction.md) — Extracts audio tracks from video containers by parsing MP4/M4A metadata and downloading independent audio streams.
- [Single Video Imports](https://awesome-repositories.com/f/graphics-multimedia/video-downloaders/youtube-archiving/single-video-imports.md) — Downloads a single video by pasting its share link directly into the application. ([source](https://cdn.jsdelivr.net/gh/johnserf-seed/tiktokdownload@main/README.md))

### Content Management & Publishing

- [Social Media Archival Tools](https://awesome-repositories.com/f/content-management-publishing/social-media-archival-tools.md) — Archives videos and audio from social media platforms for personal backup or analysis.

### Data & Databases

- [Profile Batch Downloaders](https://awesome-repositories.com/f/data-databases/bulk-data-operations/atomic-batch-operations/profile-batch-downloaders.md) — Downloads all videos from a user's profile, likes, or collections in a single batch operation. ([source](https://cdn.jsdelivr.net/gh/johnserf-seed/tiktokdownload@main/README.md))

### Security & Cryptography

- [Session-Cookie Persistences](https://awesome-repositories.com/f/security-cryptography/session-cookie-handlers/session-cookie-persistences.md) — Reuses browser cookies to authenticate API requests without requiring OAuth tokens or login credentials.

### User Interface & Experience

- [Watermark Removal](https://awesome-repositories.com/f/user-interface-experience/content-rendering-components/image-overlays/media-watermarking-tools/watermark-removal.md) — Extracts raw video streams by intercepting and reassembling CDN fragments before the platform applies overlay watermarks.

### Web Development

- [Paginated Profile Scrapers](https://awesome-repositories.com/f/web-development/user-profiles/paginated-profile-scrapers.md) — Iterates through paginated API endpoints to collect all media items from a user's profile, likes, or collections.

### Development Tools & Productivity

- [CLI Config File Readers](https://awesome-repositories.com/f/development-tools-productivity/project-configuration/automated-config-generation/cli-config-file-readers.md) — Reads download parameters from a local settings file to control output paths, skip logic, and batch behavior.

### DevOps & Infrastructure

- [Producer-Consumer Download Schedulers](https://awesome-repositories.com/f/devops-infrastructure/task-queues/batch-dispatching/custom-batch-dispatch-schedulers/producer-consumer-download-schedulers.md) — Implements a producer-consumer scheduler with rate limiting and retry logic for managing concurrent download tasks.