
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
How to get it
- 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.gitEnter the project folder
cd DouyinLiveRecorderInstall dependencies with pip
pip3 install -U pip && pip3 install -r requirements.txt - 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
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
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| DouyinLiveRecorder (this) | 11.1k | App | beginner | 7 months ago | People who want to archive streams from specific streamers on the listed platforms |
| AiToEarn | 27.2k | App | intermediate | 4 days ago | Creators who post the same content to many platforms |
| social-auto-upload | 16k | CLI | intermediate | 15 days ago | Content creators posting the same video to several platforms |
| MoneyPrinterTurbo | 137k | App | intermediate | 4 days ago | Creators who want quick draft short videos from a topic |
| spider-flow | 11.4k | App | intermediate | 3.4 years ago | Non-programmers who need to collect data from websites and prefer visual flow definitions |
| VidBee | 11k | App | beginner | 5 days ago | People 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.