StreamCap 多平台直播录制工具

StreamCap 是什么

StreamCap 是一个基于 FFmpeg 和 StreamGet 的多平台直播流自动录制客户端，覆盖 40+ 国内外主流直播平台。它的核心思路很简单：把直播间地址交给它，开播就自动录，录完还能自动转码。

项目使用 Python 编写，提供 Windows / macOS 桌面端以及 Web 端（含 Docker）两种使用形态，采用 Apache-2.0 许可证开源。

核心功能

• 多端支持：Windows、macOS 桌面运行，Linux 可通过 Web 方式运行，也支持 Docker 容器部署。
• 循环监控：实时检测直播间状态，主播一开播立即开始录制。
• 定时任务：按设定的时间范围检查直播间状态，适合固定时段的录制需求。
• 多种输出格式：支持 ts、flv、mkv、mov、mp4、mp3、m4a 等。
• 自动转码：录制结束后自动转码为 mp4，省去手动处理。
• 消息推送：支持直播状态推送，及时收到开播通知。

支持的平台

国内平台覆盖抖音、快手、虎牙、斗鱼、B 站、小红书、YY、映客、Acfun、网易 CC、微博、百度、酷狗、知乎等 30+ 家；海外平台包括 TikTok、Twitch、YouTube、CHZZK、SOOP、PandaTV、TwitCasting、LiveMe、Bigo、Shopee 等 10+ 家。

注意：小红书、淘宝、花椒等部分平台为一次性地址，暂不支持循环监控；YouTube 录制需要配置 Cookie。

快速开始

方式一：使用预构建程序

前往 Releases 页面下载对应系统的压缩包：

• Windows：下载 StreamCap.zip，解压后运行 StreamCap.exe。
• macOS：下载 StreamCap.dmg，按提示安装后在启动台运行。

方式二：从源码运行

需要 Python 3.10 或更高版本：

git clone https://github.com/ihmily/StreamCap.git
cd StreamCap
pip install -i https://pypi.org/simple streamget
pip install -r requirements.txt        # 桌面端
pip install -r requirements-web.txt    # Web 端
cp .env.example .env
python main.py

Linux 下建议以 Web 方式运行，可通过 python main.py --web 启动，然后访问 http://127.0.0.1:6006。

方式三：Docker 运行

确保已安装 Docker 与 Docker Compose，并准备好 .env 文件：

docker compose up -d
docker compose stop

容器默认时区为 Asia/Shanghai，可在 .env 中调整。

使用提示

• 如果提示缺少 FFmpeg，需要从 FFmpeg 官网下载预编译可执行文件并配置环境变量。
• 大多数平台直接使用直播间地址即可，部分平台支持主播主页地址或「前缀 + 房间号」的拼接写法。
• 完整配置与高级用法可参考项目 Wiki 文档。

适用人群

适合需要长期归档直播内容的主播粉丝、内容运营团队，以及希望在 NAS 或服务器上挂机录制的技术用户。