Skip to content

DouyinLiveRecorder

Records live streams from 40+ platforms in a loop, watching a list of rooms you set.

Stars
11.1k
Forks
1.5k
Licence
MIT
Language
Python
Last update
7 months ago
Type
App

What it is

DouyinLiveRecorder is a tool that watches a list of live-stream room addresses and saves the video when those streams go live. The README says it is built on FFmpeg, supports many platforms including Douyin, TikTok, YouTube, Kuaishou, Huya and Douyu, and can send live-status notifications. It is mainly documented for Windows users who download a zip, with source-code running also described.

  • Add room URLs to URL_config.ini, one per line, and let the program save recordings to the downloads folder
  • Record a stream in a chosen quality by prefixing the URL with the quality name and a comma
  • Pause monitoring of one room by adding # before its URL, without deleting the link
  • Stop all recording on Windows using the included StopRecording.vbs script

Great for

  • People who want to archive streams from specific streamers on the listed platforms
  • Users who want to keep the recorder running unattended and check back later
  • Windows users who prefer a downloadable zip over setting up a development environment
  • Developers who want to run the Python source and customize its configuration

Not ideal for

  • Users who only want to watch streams live; this tool saves recordings instead
  • Anyone expecting full support for every listed platform without checking the README, since some (such as Taobao) need cookies and overseas platforms need a proxy
  • People who need a polished graphical app, since the README describes a simple tool driven by text config files
Step-by-step guide: how to use DouyinLiveRecorderInstall, first run, examples, tips and FAQs

How to get it

  1. 1

    Download the app

    You'll need: Python 3.10 or newer, if running from source (the README recommends uv, which can manage Python for you)

    Clone the repository

    git clone https://github.com/ihmily/DouyinLiveRecorder.git

    Enter the project folder

    cd DouyinLiveRecorder

    Install dependencies with pip

    pip3 install -U pip && pip3 install -r requirements.txt
  2. 2

    Run it

    • Download the latest zip from the Releases page and extract it (for the packaged Windows version)
    • Add live room URLs to config/URL_config.ini, one per line
    • Run DouyinLiveRecorder.exe
    • Find recordings in the downloads folder in the same directory
  3. 3

    Get the most out of it

    • Set the recording format to ts in config.ini, as the README recommends
    • Add a proxy address in the config file when recording overseas platforms such as TikTok
    • Use a longer loop interval to reduce the risk of an IP ban
    • Use the message-push feature (msg_push.py) to get notified when a streamer goes live

Downloads

Strengths

  • The README lists a large number of supported platforms, with many added over time
  • Offers a zip download for non-technical users and a source-code path for developers
  • Configuration is file-based, with per-room quality and a per-room pause option

Trade-offs

  • The README warns that frequent requests may get your IP banned, so long loop intervals are recommended
  • Some platforms require extra setup such as a proxy or cookies, and antivirus tools may flag the download
  • The README is written mostly in Chinese and the documentation shown is truncated, so some details may be missing for non-Chinese readers

How it compares

ProjectStarsTypeLevelUpdatedBest for
DouyinLiveRecorder (this)11.1kAppbeginner7 months agoPeople who want to archive streams from specific streamers on the listed platforms
AiToEarn27.2kAppintermediate4 days agoCreators who post the same content to many platforms
social-auto-upload16kCLIintermediate14 days agoContent creators posting the same video to several platforms
MoneyPrinterTurbo137kAppintermediate4 days agoCreators who want quick draft short videos from a topic
spider-flow11.4kAppintermediate3.4 years agoNon-programmers who need to collect data from websites and prefer visual flow definitions
VidBee11kAppbeginner5 days agoPeople who save videos or podcasts from supported sites and want them organized in one library

Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.