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.
TikRec is the hosted cloud version of this recorder. Same recording engine, running 24/7 on a server, delivering MP4s straight to your Telegram.
- No installation, no terminal, no FFmpeg
- Add TikTok usernames to a watchlist via @tikrec_live_bot on Telegram
- Recordings delivered automatically when creators go live
- Free for your watchlist. Past recordings from the archive available with Telegram Stars.
Open TikRec on Telegram | Browse the recording archive
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 -hLinux 🐧
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 -hmacOS 🍎
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 -hAndroid — 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 -hDocker 🐳
sudo docker run \
-v ./output:/output \
michele0303/tiktok-live-recorder:latest \
-output /output \
-user <username>uv run python src/main.py [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. |
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.
This CLI tool gives you full control - run it on your own machine, customize the output, pipe it into your own workflow. But it requires a computer running 24/7, FFmpeg installed, and manual setup per creator.
TikRec is the cloud version built by the same developer. It uses the same FFmpeg recording engine but runs on a server so you don't have to keep anything running.
| This CLI | TikRec Cloud | |
|---|---|---|
| Setup | Python + FFmpeg + terminal | Open Telegram, send /watch |
| Runs on | Your machine | Cloud (24/7) |
| Storage | Your disk | Telegram (unlimited) |
| Multi-creator | Comma-separated users or followers mode | Automatic for all watchlist |
| Monitoring | Automatic (if your machine runs 24/7) | 24/7 on cloud, detection < 3 min |
| Cost | Free + electricity | Free |
| Customizable | Full source code | No |
Use this CLI if you want full control, custom output, or integration with your own tools.
Use TikRec if you want recordings delivered to Telegram without maintaining anything.
Contributions are welcome! Feel free to open an issue or submit a pull request.
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.
