Repolode
Submit
Michele0303

Michele0303/tiktok-live-recorder

A Python command-line tool that records TikTok live streams, including audio and video, in manual, automatic, or followers mode.

View on GitHub
Stars
920
Forks
237
Open issues
140
Last commit
2 months ago

What is it?

TikTok Live Recorder is a Python command-line tool for capturing TikTok live streams and saving them to local files. It records both audio and video, so users can revisit or archive live sessions after they end.

Recording is controlled by flags such as -user, -url, or -room_id to choose the broadcast, and -mode to pick how it starts: manual records immediately if the user is live, automatic polls at a set interval and records whenever the user goes live, and followers records streams from all accounts the logged-in user follows. Options also cover output directory, maximum duration, HTTP proxy, post-processing bitrate, and uploading finished recordings to Telegram.

The project runs on Windows, Linux, macOS, and Android through Termux, and can also be started from a Docker image. It requires Python 3.11 or newer and FFmpeg.

Key features

  • 01Records TikTok live streams with both audio and video.
  • 02Supports manual, automatic (interval polling), and followers recording modes.
  • 03Accepts a username, live URL, or room ID to pick the broadcast.
  • 04Can set output directory, maximum duration, HTTP proxy, and output bitrate.
  • 05Optionally uploads finished recordings to Telegram.
  • 06Available as a Docker image in addition to local installation.

Use cases

  • Archiving TikTok live sessions from creators you follow for later viewing.
  • Collecting live streams for content analysis or research.
  • Automatically capturing a favorite streamer's broadcasts whenever they go live.
  • Running unattended on a server or in a container to record streams around the clock.

Quick start

  1. 1

    Install prerequisites: Git, Python 3.11+ and FFmpeg

  2. 2

    Clone the repository

    git clone https://github.com/Michele0303/tiktok-live-recorder
  3. 3

    Install dependencies with uv

    uv sync
  4. 4

    Check the command-line options

    uv run python src/main.py -h

Things to know

  • The project is not affiliated with TikTok and is provided use at your own risk.
  • Setup requires Python 3.11+, FFmpeg and uv, and some features need cookies.json or a Telegram config file.

Topics

#tiktok#live-streaming#video-recording#python#cli#downloader#ffmpeg#bot#live#livestreaming

FAQ

What is tiktok-live-recorder?
A Python command-line tool that records TikTok live streams, including audio and video, in manual, automatic, or followers mode. TikTok Live Recorder is a Python command-line tool for capturing TikTok live streams and saving them to local files. It records both audio and video, so users can revisit or archive live sessions after they end.
Is tiktok-live-recorder free to use? What license does it have?
tiktok-live-recorder is open source under the MIT license. Check the license terms before using it in commercial products.
Is tiktok-live-recorder still maintained?
Updated within 6 months. The last commit to tiktok-live-recorder was on Aug 12, 2026.
What can I use tiktok-live-recorder for?
Archiving TikTok live sessions from creators you follow for later viewing. Collecting live streams for content analysis or research. Automatically capturing a favorite streamer's broadcasts whenever they go live. Running unattended on a server or in a container to record streams around the clock.
How do I install tiktok-live-recorder?
Install prerequisites: Git, Python 3.11+ and FFmpeg Clone the repository: git clone https://github.com/Michele0303/tiktok-live-recorder Install dependencies with uv: uv sync Check the command-line options: uv run python src/main.py -h
Where can I get tiktok-live-recorder?
The source code and installation instructions are on GitHub: https://github.com/Michele0303/tiktok-live-recorder

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects