TikTok Live Recorder

A CLI tool for recording TikTok live streams

Installation & Usage

So far, only tested on MacOS and Linux.

To run this application, you'll need Git and Python3 installed. Installing FFmpeg and using the -ffmpeg option is recommended. From your command line:

Clone this repository

git clone https://github.com/roju/tiktok-live-recorder && cd tiktok-live-recorder

Install dependencies
```
pip install -r requirements.txt
```
Run the app
```
python3 ttlr.py -h
```

Example:

python3 ttlr.py -user tv_asahi_news -ffmpeg -combine

Recording Private Streams

Recording private streams is supported via web browser with a helper extension installed. This is an experimental feature.

Install Google Chrome or other browser supported by the extension
Install the extension from the browser-extension folder
In the browser, log in to your TikTok account which has permission to view the private stream
Run ttlr.py using the browser_exec argument, specifying the path to your browser executable

Proxy Server

In automatic mode, we make many repeated requests at a fixed interval. TikTok may at some point in the future decide to flag such requests as bot activity and blacklist your IP (this assumption is purely speculative at this point). Using a proxy should hopefully prevent this. Also, the proxy may allow you to bypass restrictions in certain countries (untested). The proxy is only used for certian requests, not for downloading the video data.

Use the -proxy argument to specify a proxy server. Defaults to TOR proxy which requires TOR to be installed and configured on your system.

To-Do List

Record private live streams with browser extension
Handle stream lagging and interruptions
Log console output to file
Automatic Recording
Recording by room_id
Using proxy to avoid bot detection and geographical restrictions
Automatically change TOR IP when receiving certain errors
Test on Windows platform and add support if needed

Legal

This code is in no way affiliated with, authorized, maintained, sponsored or endorsed by TikTok or any of its affiliates or subsidiaries. Use at your own risk.

roju / tiktok-live-recorder