rust-srec

Automated live-stream recorder for the platforms you actually watch.
Set it up once, and it captures your favorite streamers the moment they go live.

简体中文 · Documentation · Get Started · Docker · Release Notes

• Records streams automatically. Add a streamer, walk away. rust-srec watches and records when they go live.
• Captures chat too. Danmaku and live chat are saved alongside the video where the platform allows.
• Fixes broken recordings. Built-in repair for FLV and HLS streams handles timestamp drift, missing metadata, and similar issues.
• Stays out of your way. Lightweight, runs in Docker, and offers a web UI plus a REST API with Swagger docs.

Bilibili · Douyin · Douyu · Huya · Twitch · TikTok · AcFun · Picarto · Redbook · TwitCasting · Weibo · PandaTV (legacy)

The fastest way to try it — Linux and macOS:

curl -fsSL https://docs.srec.rs/install.sh | bash

Windows PowerShell:

irm https://docs.srec.rs/install.ps1 | iex

The installer downloads the Compose and environment files, generates the required secrets, detects optional NVIDIA support, and offers to start the services. Then open the web UI and follow the getting-started guide.

To pin a release instead of tracking latest, pass VERSION — image tags use a leading v:

curl -fsSL https://docs.srec.rs/install.sh | VERSION=v0.5.1 bash

Piping a remote script to a shell runs whatever the server returns. To review it first, download install.sh and run your local copy, or follow the manual Compose steps in the Docker guide.

Prefer a binary or to build from source? See the installation guide.

• Multi-platform — 12 streaming sites supported out of the box.
• Three download engines — pick ffmpeg, streamlink, or the built-in Rust engine (mesio).
• Post-processing pipelines — automatically transcode, segment, or hand off recordings to your own scripts.
• Web UI + REST API — manage streamers from the browser; automate with the API (JWT-protected, OpenAPI docs at /api/docs).
• Persistent and reliable — SQLite-backed state; schema upgrades happen on startup.

Two standalone tools ship in the same repo:

• Configuration reference
• Architecture overview
• Engines explained
• FAQ

This is a Cargo workspace. The main pieces:

• rust-srec/ — the recorder backend (API, scheduler, pipeline, database)
• strev-cli/, mesio-cli/ — the CLI tools above
• crates/ — reusable libraries: platform extractors, FLV / HLS / TS parsers, the mesio download engine, and stream-repair utilities

Common commands:

cargo build                       # build everything
cargo test                        # run tests
cargo clippy -- -D warnings       # lint
cargo fmt                         # format

Contributions welcome — see CONTRIBUTING.md.

Released under the MIT License.