2020-01-19 15:54:16 +00:00
|
|
|
# TikTok-DL
|
|
|
|
|
|
|
|
[![Go Report Card](https://goreportcard.com/badge/github.com/pikami/tiktok-dl)](https://goreportcard.com/report/github.com/pikami/tiktok-dl)
|
2020-01-19 16:24:07 +00:00
|
|
|
![GitHub Workflow Status](https://img.shields.io/github/workflow/status/pikami/tiktok-dl/tiktok-dl_CI)
|
2020-01-19 15:54:16 +00:00
|
|
|
|
|
|
|
A simple tiktok video downloader written in go
|
|
|
|
|
|
|
|
## Basic usage
|
2020-01-19 16:24:07 +00:00
|
|
|
Download the executable from `https://github.com/pikami/tiktok-dl/releases`\
|
2020-01-19 15:54:16 +00:00
|
|
|
You can download all videos from user by running `./tiktok-dl [Options] TIKTOK_USERNAME`\
|
2020-01-24 17:02:50 +00:00
|
|
|
You can download single video by running `./tiktok-dl [Options] VIDEO_URL`\
|
2020-01-26 17:44:25 +00:00
|
|
|
You can download all videos by music by running `./tiktok-dl [Options] MUSIC_URL`\
|
2020-01-24 17:02:50 +00:00
|
|
|
You can download items listed in a text file by running `./tiktok-dl [OPTIONS] -batch-file path/to/items.txt`
|
2020-01-19 15:54:16 +00:00
|
|
|
|
2020-01-19 16:24:07 +00:00
|
|
|
## Build instructions
|
|
|
|
Clone this repository and run `go build` to build the executable.
|
|
|
|
|
2020-01-19 15:54:16 +00:00
|
|
|
## Available options
|
|
|
|
* `-debug` - enables debug mode
|
|
|
|
* `-output some_directory` - Output path (default "./downloads")
|
2020-01-20 19:29:42 +00:00
|
|
|
* `-metadata` - Write video metadata to a .json file
|
2020-01-24 17:02:50 +00:00
|
|
|
* `-batch-file` - File containing URLs/Usernames to download, one value per line. Lines starting with '#', are considered as comments and ignored.
|
2020-01-19 15:54:16 +00:00
|
|
|
|
|
|
|
## Acknowledgments
|
2020-01-24 17:14:52 +00:00
|
|
|
This software uses the **chromedp** for web scraping, it can be found here: https://github.com/chromedp/chromedp \
|
2020-01-24 17:02:50 +00:00
|
|
|
For releases the JS code is minified by using **terser** toolkit, it can be found here: https://github.com/terser/terser
|