tok-dl

README

Tok-DL: A TikTok Downloader that actually works

Features

• Saves both video and gallery posts, including all of their metadata
• Highest quality, no watermarks
• Caches already-downloaded and unavailable posts to avoid fetching them again

Installation

Cross platform

via mise (recommended):

mise use -g ubi:sweepies/tok-dl

Run in Docker:

docker run --rm -u "$(id -u):$(id -g)" -v "$(pwd):$(pwd)" -w "$(pwd)" ghcr.io/sweepies/tok-dl

Usage

Tok-DL takes input in the form of newline-separated links. This format is the same as is contained in TikTok personal data downloads. It will ignore commented lines.

NAME:
   tok-dl - A TikTok Downloader that actually works

USAGE:
   tok-dl [global options] INPUT_FILE

GLOBAL OPTIONS:
   --metadata-only, -m        only download metadata (default: false)
   --out-dir value, -o value  output directory (default: "./tiktok")
   --no-cache                 bypass the cache; don't skip already actioned urls (default: false)
   --cache-dir value          directory for cache database (default: OS user cache dir)
   --debug                    show debug logs (default: false)
   --help, -h                 show help

Limitations

• Since Tok-DL utilizes the TiKWM API, there is a limit of 5,000 requests per day, and 1 per second. Tok-DL automatically handles this on a second-by-second basis, but the program will stop if you hit the daily limit. Thankfully, you can easily pick up where you left off.