TikTook

Take TikTok videos to your local machine

Table of Contents

• Features
• Dependency
• Usage
  • Example
• How to run tests
• Disclaimer

Features

• No need to sign in TikTok account
• No need to register TikTok API
• Download covers and videos from TikTok directly
• Download json data, including profile data, cover/video data...
• Toggle cover image download, or/and video download, or/and json data download
• Download only contents published in any time period

Dependency

• curl
• jq

Usage

Usage:
  ./tiktook.sh -u <username> [-d] [-c] [-v] [-f <yyyymmdd>] [-t <yyyymmdd>]

Options:
  -u               required, TikTok username
  -d               optional, skip json data download
  -c               optional, skip cover download
  -v               optional, skip video download
  -f <yyyymmdd>    optional, from date, format yyyymmdd
  -t <yyyymmdd>    optional, to date, format yyyymmdd

Example

• Download all videos since 1 Jun 2016, from @tiktok account:

$ ./tiktook.sh -u tiktok -f 20200601

How to run tests

$ bats test/tiktook.bats

Disclaimer

The purpose of this script is to download media contents from TikTok in order to backup and archive them. Please do NOT copy or distribute downloaded contents to others. Please do remember that the copyright of contents always belongs to the owner of TikTok account. Please use this script at your own responsibility.

---