A simple tiktok video downloader written in go
Go to file
Pijus Kamandulis 673bbe1340 TTDL-3 Add `deadline` flag 2020-01-30 19:05:33 +02:00
.github/workflows Update build script to minimize js 2020-01-20 21:22:14 +02:00
client TTDL-3 Add `deadline` flag 2020-01-30 19:05:33 +02:00
models TTDL-3 Add `deadline` flag 2020-01-30 19:05:33 +02:00
unitTestUtil Added more unit tests 2020-01-22 01:06:35 +02:00
utils Added option to download items from list 2020-01-24 19:02:50 +02:00
workflows Fix issue with batch files 2020-01-27 20:46:10 +02:00
.gitignore Added option to download items from list 2020-01-24 19:02:50 +02:00
README.md TTDL-3 Add `deadline` flag 2020-01-30 19:05:33 +02:00
main.go Added option to download items by music 2020-01-26 19:45:58 +02:00
package-lock.json Update build script to minimize js 2020-01-20 21:22:14 +02:00
package.json Update build script to minimize js 2020-01-20 21:22:14 +02:00
scraper.js Added option to download items by music 2020-01-26 19:45:58 +02:00

README.md

TikTok-DL

Go Report Card GitHub Workflow Status

A simple tiktok video downloader written in go

Basic usage

Download the executable from https://github.com/pikami/tiktok-dl/releases
You can download all videos from user by running ./tiktok-dl [Options] TIKTOK_USERNAME
You can download single video by running ./tiktok-dl [Options] VIDEO_URL
You can download all videos by music by running ./tiktok-dl [Options] MUSIC_URL
You can download items listed in a text file by running ./tiktok-dl [OPTIONS] -batch-file path/to/items.txt

Build instructions

Clone this repository and run go build to build the executable.

Available options

  • -debug - enables debug mode
  • -output some_directory - Output path (default "./downloads")
  • -metadata - Write video metadata to a .json file
  • -batch-file - File containing URLs/Usernames to download, one value per line. Lines starting with '#', are considered as comments and ignored.
  • -deadline - Sets the timout for scraper logic in seconds (used as a workaround for context deadline exceeded error) (default 1500)

Acknowledgments

This software uses the chromedp for web scraping, it can be found here: https://github.com/chromedp/chromedp
For releases the JS code is minified by using terser toolkit, it can be found here: https://github.com/terser/terser