TikTok Live Recorder 🎥

TikTok Live Recorder is a tool for recording live streaming TikTok.

The TikTok Live Recorder is a tool designed to easily capture and save live streaming sessions from TikTok. It records both audio and video, allowing users to revisit and preserve engaging live content for later enjoyment and analysis. It's a valuable resource for creators, researchers, and anyone who wants to capture memorable moments from TikTok live streams.

Table of Contents

• Installation
• Usage
• Guide

Installation

Prerequisites: Git, Python 3.11+, FFmpeg

Windows 💻

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
git clone https://github.com/Michele0303/tiktok-live-recorder
cd tiktok-live-recorder
uv venv
uv sync
uv run python src/main.py -h

Linux 🐧

curl -LsSf https://astral.sh/uv/install.sh | sh
git clone https://github.com/Michele0303/tiktok-live-recorder
cd tiktok-live-recorder
uv venv
uv sync
uv run python src/main.py -h

macOS 🍎

curl -LsSf https://astral.sh/uv/install.sh | sh
brew install ffmpeg
git clone https://github.com/Michele0303/tiktok-live-recorder
cd tiktok-live-recorder
uv venv
uv sync
uv run python src/main.py -h

Android — Termux 📱

Install Termux from F-Droid (avoid the Play Store version).

pkg update && pkg upgrade
pkg install git ffmpeg uv tur-repo
pkg uninstall python
pkg install python3.11
git clone https://github.com/Michele0303/tiktok-live-recorder
cd tiktok-live-recorder
uv venv
uv sync
uv run python src/main.py -h

Docker 🐳

sudo docker run \
  -v ./output:/output \
  michele0303/tiktok-live-recorder:latest \
  -output /output \
  -user <username>

Command-Line Usage

uv run python src/main.py [options]

Options

Flag	Description
-user <USERNAME>	Username(s) to record. Separate multiple with commas.
-url <URL>	TikTok live URL to record from.
-room_id <ROOM_ID>	Room ID to record from.
-mode <MODE>	Recording mode: manual, automatic, followers.
-automatic_interval <MIN>	Polling interval in minutes (automatic mode only).
-output <DIRECTORY>	Directory where recordings will be saved.
-duration <SECONDS>	Stop recording after this many seconds.
-proxy <URL>	HTTP proxy to bypass regional restrictions.
-bitrate <BITRATE>	Output bitrate for post-processing (e.g. 1M, 1000k).
-telegram	Upload the recording to Telegram when done. Requires telegram.json.
-no-update-check	Skip the automatic update check on startup.

Recording Modes

• manual (default): Records immediately if the user is currently live.
• automatic: Polls at regular intervals and records whenever the user goes live.
• followers: Automatically records live streams from all followed users.

Guide

• How to set cookies in cookies.json
• How to get room_id
• How to enable upload to Telegram

Contributing

Contributions are welcome! Feel free to open an issue or submit a pull request.

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.