Mastering Multi-Platform Live Recording with DouyinLiveRecorder
Automate your live stream archiving across 40+ platforms including TikTok, YouTube, and Douyin with this powerful, open-source Python-based recording engine.
In the world of content creation and digital archiving, capturing live streams can be a logistical nightmare. Different platforms use proprietary protocols, varying stream qualities, and aggressive anti-scraping measures. If you've ever tried to manually record multiple streams simultaneously, you know the pain of broken files, missed starts, and platform-specific quirks.
DouyinLiveRecorder is a robust, open-source solution designed to solve exactly this. It acts as a centralized engine for monitoring and recording live streams across over 40 platforms, including Douyin, TikTok, YouTube, Twitch, Bilibili, and many others.
Why Use a Dedicated Recorder?
Most screen recording software is resource-heavy and requires a GUI. DouyinLiveRecorder, however, is built on FFmpeg, the industry standard for video processing. By leveraging FFmpeg directly, the tool captures the raw stream data, ensuring high-quality, lossless recordings without the overhead of re-encoding your screen output.
Key advantages include:
- Cyclic Monitoring: The tool continuously checks if a streamer is live, automatically starting the recording when they go online and stopping when they finish.
- Multi-Platform Support: Whether it's a local platform like Douyin or an international one like Twitch, the logic is unified.
- Lightweight & Headless: Perfect for running on a VPS or a home server (like a Raspberry Pi or NAS) via Docker.
- Notification Integration: Get updates on stream status via PushPlus, Bark, or email.
Getting Started
For most users, the simplest way to get started is by downloading the latest release from the GitHub repository. However, for developers and power users, running from source provides the most flexibility.
Running with uv
The project now supports uv, a high-performance Python package manager. This is the recommended way to handle dependencies and virtual environments:
# Clone the repository
git clone https://github.com/ihmily/DouyinLiveRecorder.git
cd DouyinLiveRecorder
# Sync dependencies
uv sync
# Run the recorder
uv run main.py
Configuration Tips
The core of the application lies in the config/URL_config.ini file. This is where you define your targets.
Pro-tip for managing large lists:
- Commenting out: Use
#at the start of a line to temporarily disable a stream without deleting it. - Quality Control: You can specify quality per stream by prefixing the URL. For example:
超清,https://live.douyin.com/123456789. - Proxying: For international platforms like TikTok or AfreecaTV, ensure you configure the
proxy_addrin yourconfig.inito avoid geo-blocking or IP bans.
Deployment via Docker
If you want to "set it and forget it," Docker is your best friend. The repository includes a docker-compose.yaml file that makes deployment trivial:
# Simply run in the project directory
docker-compose up -d
Important Note on File Integrity: When running in a container, avoid killing the process abruptly. If the container is stopped forcefully, you may end up with corrupted video files. Always prefer the .ts (Transport Stream) format in your configuration, as it is much more resilient to stream interruptions and unexpected shutdowns compared to .mp4.
Final Thoughts
DouyinLiveRecorder is more than just a downloader; it is a mature ecosystem for stream management. With its active community and frequent updates—addressing everything from platform API changes to new feature requests—it remains the go-to tool for developers looking to build automated archiving pipelines.
If you find the project useful, consider supporting the maintainers by starring the repository on GitHub or contributing a PR for a new platform integration.