Skip to content

sweepies/tok-dl

Repository files navigation

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

via mise with ubi (recommended):

mise use -g ubi: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 alreadty actioned urls (default: false)
   --debug                    show debug logs (default: false)
   --help, -h                 show help                Show this message and exit.

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.

About

Tok-DL: A TikTok Downloader that actually works

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages