Loading repository dataβ¦
Loading repository dataβ¦
Michele0303 / repository
π₯β¨ A TikTok live streaming recorder tool written in Python. Capture and relive your favorite TikTok moments effortlessly. π₯β¨
A transparent discovery signal based on current public GitHub metadata.
This score does not audit code, security, maintainers, documentation quality, or suitability. Verify the repository and its current documentation before adoption.
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.

Prerequisites: Git, Python 3.11+, FFmpeg
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
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
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
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
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.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.