KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #dsh #dsh-plugin #ai-agent #codex #ai-agents #deepseek-harness #claude-code #cli #react #mcp

tok-dl

★ 60 Open GitHub ↗

Tok-DL: A TikTok Downloader that actually works

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">
  Tok-DL: A TikTok Downloader that actually works
</h1>
<p align="center">
  <img src="https://github.com/user-attachments/assets/9d57a8a9-18d2-4751-b573-466f57607840" />
</p>

## 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](https://mise.jdx.dev) (recommended):
```shell
mise use -g ubi:sweepies/tok-dl
```

Run in Docker:
```shell
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](https://www.tikwm.com/) 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.

tok-dl

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README