简介

​StreamCap​ 是一个开源的多平台直播流自动录制工具，基于FFmpeg和StreamGet技术构建。它支持40+个国内外主流直播平台，能够自动监控、录制和转码直播内容，是直播内容存档、离线观看和内容创作的理想解决方案。

🔗 ​GitHub地址​：

https://github.com/ihmily/StreamCap

🚀 ​核心价值​：

多平台录制 · 自动监控 · 定时任务 · 开源免费

​项目背景​：

• ​直播普及​：响应直播行业快速发展带来的内容保存需求

• ​技术整合​：基于FFmpeg和StreamGet等成熟技术

• ​开源精神​：遵循开源理念，促进技术共享和创新

• ​用户需求​：解决用户手动录制直播的繁琐和不便

​技术特色​：

• 🌐 ​广泛支持​：覆盖40+个国内外直播平台

• 🤖 ​智能监控​：实时监控直播间状态，开播即录

• ⏰ ​定时任务​：支持按时间范围自动检查录制

• 🔄 ​自动转码​：录制完成后自动转码为MP4格式

• 📨 ​消息推送​：支持开播通知和状态推送

​设计理念​：

• ​用户友好​：简洁直观的界面和操作流程

• ​高效稳定​：可靠的录制性能和稳定性

• ​隐私保护​：本地运行，保护用户数据安全

• ​持续更新​：跟随平台变化及时适配

• ​社区驱动​：开源社区共同维护和发展

---

主要功能

1. ​核心功能体系​

2. ​功能详情​

​平台支持能力​：

• ​国内平台​：抖音、快手、虎牙、斗鱼、B站、小红书、YY等30+平台

• ​海外平台​：TikTok、Twitch、YouTube、LiveMe等10+平台

• ​扩展性​：支持通过配置添加新平台

• ​兼容性​：适应各平台API变化和更新

​录制功能​：

• ​批量录制​：同时监控和录制多个直播间

• ​高质量录制​：支持高清和超清画质录制

• ​实时录制​：低延迟实时流媒体捕获

• ​中断恢复​：网络中断后自动恢复录制

• ​进度保存​：录制进度自动保存和恢复

​监控方式​：

• ​循环监控​：持续监控直播间状态变化

• ​定时监控​：在指定时间范围内监控

• ​状态检测​：智能检测直播开始和结束

• ​消息通知​：通过多种方式发送开播通知

​输出处理​：

• ​格式支持​：TS、FLV、MKV、MOV、MP4、MP3、M4A等

• ​自动转码​：录制完成后自动转码为MP4格式

• ​文件管理​：智能文件命名和组织

• ​元数据保存​：保存直播时间和平台信息

​高级功能​：

• ​自定义配置​：可调整录制参数和质量设置

• ​计划任务​：创建复杂的录制计划

• ​API集成​：提供API接口用于集成

• ​日志记录​：详细的运行日志和错误记录

• ​性能优化​：资源使用优化和效率提升

---

安装与配置

1. ​环境准备​

​系统要求​：

# 操作系统
Windows: 7/8/10/11 (64位)
macOS: 10.12+
Linux: Ubuntu 16.04+, CentOS 7+
其他: 支持Docker的系统

# 硬件要求
内存: 4GB+ RAM (推荐8GB+)
存储: 10GB+ 可用空间(录制文件需要额外空间)
网络: 稳定互联网连接
处理器: 多核现代处理器

# 软件依赖
FFmpeg: 必需，用于视频处理
Python: 3.10+ (如从源码运行)
Node.js: (某些平台需要)
Docker: (如使用容器运行)

​下载选项​：

# 预构建版本
Windows: StreamCap.zip (解压运行)
macOS: StreamCap.dmg (安装运行)
Linux: 使用Docker或源码运行

# 源码版本
从GitHub Releases下载源码
或使用git克隆仓库

# Docker版本
使用Docker Hub上的官方镜像
或自行构建镜像

2. ​安装步骤​

​Windows安装​：

1. 访问GitHub Releases页面
2. 下载StreamCap.zip文件
3. 解压到任意目录
4. 运行StreamCap.exe
5. 按照向导完成初始配置

​macOS安装​：

1. 下载StreamCap.dmg文件
2. 打开磁盘镜像
3. 拖拽应用到Applications文件夹
4. 在启动台中打开应用
5. 授予必要的系统权限

​Linux安装​：

# 使用Docker（推荐）
docker pull ihmily/streamcap
docker run -it --name streamcap ihmily/streamcap

# 或从源码运行
git clone https://github.com/ihmily/StreamCap.git
cd StreamCap
pip install -r requirements.txt
python main.py

​Docker安装​：

# 使用docker-compose
git clone https://github.com/ihmily/StreamCap.git
cd StreamCap
docker-compose up -d

# 或直接运行
docker run -d \
  --name=streamcap \
  -v /path/to/config:/app/config \
  -v /path/to/recordings:/app/recordings \
  ihmily/streamcap

​FFmpeg安装​：

# 如果提示缺少FFmpeg
# Windows: 下载并添加PATH
# macOS: brew install ffmpeg
# Linux: sudo apt install ffmpeg

# 验证安装
ffmpeg -version

3. ​配置说明​

​基本配置​：

# 配置文件 (.env)
PLATFORM=desktop  # 或 web
LANGUAGE=zh-CN
RECORDING_PATH=./recordings
LOG_LEVEL=info

# 网络配置
PROXY_URL=  # 如有需要
TIMEOUT=30
RETRY_ATTEMPTS=3

# 录制设置
DEFAULT_FORMAT=mp4
AUTO_CONVERT=true
QUALITY=best

​平台配置​：

# 平台特定设置
DOUYIN_ENABLED=true
DOUYIN_QUALITY=high
BILIBILI_ENABLED=true
TWITCH_ENABLED=true

# Cookie配置（某些平台需要）
BILIBILI_COOKIE=
YOUTUBE_COOKIE=

​监控配置​：

# 监控设置
CHECK_INTERVAL=60  # 检查间隔(秒)
MAX_CONCURRENT=5   # 最大并发录制
NOTIFICATION_ENABLED=true

# 定时任务
SCHEDULE_ENABLED=true
SCHEDULE_START=20:00
SCHEDULE_END=24:00

​通知配置​：

# 通知方式
EMAIL_NOTIFICATION=false
DISCORD_NOTIFICATION=false
TELEGRAM_NOTIFICATION=false
WEBHOOK_NOTIFICATION=false

# 通知内容
NOTIFY_ON_START=true
NOTIFY_ON_COMPLETE=true
NOTIFY_ON_ERROR=true

---

使用指南

1. ​基本工作流​

使用StreamCap的基本流程包括：添加直播间 → 配置录制选项 → 启动监控 → 查看录制文件。整个过程设计为简单直观，用户无需复杂操作即可开始录制。

2. ​基本使用​

​添加直播间​：

1. 打开StreamCap应用
2. 点击"添加直播间"按钮
3. 输入直播间URL或ID
4. 选择平台类型（如自动检测）
5. 设置录制选项（质量、格式等）
6. 保存配置并启动监控

​监控管理​：

# 查看监控状态
- 主界面显示所有监控中的直播间
- 显示实时状态（在线、离线、录制中）
- 显示最近开播时间和录制时长

# 管理监控任务
- 启用/禁用特定直播间监控
- 编辑录制配置选项
- 删除不再监控的直播间
- 导出/导入监控列表

​录制管理​：

# 查看录制文件
- 录制文件按日期和平台组织
- 显示文件大小和录制时长
- 支持文件预览和播放

# 文件处理
- 自动转码为MP4格式
- 可选保留原始格式
- 文件命名可自定义
- 自动清理旧文件（可选）

​通知设置​：

# 配置通知
1. 进入设置页面
2. 选择通知方式（如邮件、Webhook）
3. 配置通知参数
4. 测试通知功能
5. 保存设置

# 通知内容
- 开播通知：直播间开始直播时
- 录制完成：录制文件保存时
- 错误报警：录制过程中出现错误时

3. ​高级用法​

​批量操作​：

# 批量添加直播间
1. 准备直播间列表文件（每行一个URL）
2. 使用批量导入功能
3. 设置统一的录制选项
4. 启动批量监控

# 计划任务
- 设置特定时间段的监控
- 按星期几配置不同计划
- 设置假期或特殊日期排除

​API使用​：

# REST API接口
GET /api/status       # 获取系统状态
POST /api/add         # 添加直播间
GET /api/list         # 获取监控列表
POST /api/control     # 控制录制任务

# 使用示例
curl -X POST http://localhost:6006/api/add \
  -H "Content-Type: application/json" \
  -d '{"url": "https://live.bilibili.com/123", "platform": "bilibili"}'

​命令行操作​：

# 命令行参数
python main.py --web    # 以Web模式运行
python main.py --debug  # 调试模式
python main.py --config /path/to/config  # 指定配置

# 后台运行
nohup python main.py > streamcap.log 2>&1 &

​Docker高级配置​：

# 自定义Docker运行
docker run -d \
  --name=streamcap \
  -p 6006:6006 \
  -v /host/config:/app/config \
  -v /host/recordings:/app/recordings \
  -e TZ=Asia/Shanghai \
  ihmily/streamcap:latest

# 使用docker-compose自定义
version: '3'
services:
  streamcap:
    image: ihmily/streamcap:latest
    ports:
      - "6006:6006"
    volumes:
      - ./config:/app/config
      - ./recordings:/app/recordings
    environment:
      - TZ=Asia/Shanghai
    restart: unless-stopped

---

应用场景实例

案例1：教育内容存档

​场景​：教育机构需要录制在线课程直播供学生回放

​解决方案​：使用StreamCap自动录制教育直播内容。

​实施方法​：

1. 收集所有课程直播间的URL
2. 批量添加到StreamCap监控列表
3. 设置课程时间表定时监控
4. 录制完成后自动转码并归档
5. 将录制文件上传到学习管理系统

​实施效果​：

• ​完整存档​：确保所有课程内容完整保存

• ​自动处理​：无需人工干预自动录制

• ​方便回放​：学生可随时观看录制内容

• ​资源管理​：系统化的课程资源管理

• ​成本节约​：减少人工录制成本和时间

案例2：游戏直播收藏

​场景​：游戏爱好者希望收藏喜欢的主播直播内容

​解决方案​：使用StreamCap监控和录制游戏直播。

​实施方法​：

1. 添加关注的主播直播间
2. 设置高质量录制选项
3. 启用开播通知及时知晓
4. 录制文件按主播和日期整理
5. 定期备份收藏内容

​实施效果​：

• ​不错过直播​：自动录制确保不错过任何直播

• ​高质量保存​：保存高清直播内容

• ​个人收藏​：建立个人游戏直播库

• ​分享方便​：方便与朋友分享精彩时刻

• ​长期保存​：长期保存珍贵直播内容

案例3：内容创作素材收集

​场景​：内容创作者需要录制直播内容作为创作素材

​解决方案​：使用StreamCap批量录制相关直播内容。

​实施方法​：

1. 识别相关领域的直播内容
2. 批量添加多个直播间
3. 设置关键词过滤和筛选
4. 自动转码和整理录制文件
5. 集成到创作工作流中

​实施效果​：

• ​素材丰富​：获取大量实时内容素材

• ​效率提升​：自动化收集提高效率

• ​内容更新​：始终保持内容新鲜度

• ​多平台覆盖​：覆盖多个平台内容

• ​版权管理​：合理使用录制内容

---

总结

StreamCap作为一个功能强大的开源直播录制工具，通过其多平台支持、智能监控和自动化处理能力，为用户提供了便捷的直播内容保存解决方案。其跨平台特性和开源理念，使其成为直播观众、内容创作者和教育机构的理想选择。

​核心优势​：

• 🌐 ​多平台支持​：覆盖40+个国内外直播平台

• 🤖 ​智能监控​：实时检测和自动录制

• ⏰ ​灵活调度​：支持定时和计划任务

• 🔄 ​自动处理​：自动转码和文件管理

• 🔒 ​隐私安全​：本地运行，数据安全

​适用场景​：

• 教育课程录制和存档

• 游戏直播收藏和分享

• 内容创作素材收集

• 直播内容分析和研究

• 个人兴趣内容保存

​技术特色​：

• ​基于FFmpeg​：成熟的视频处理技术

• ​跨平台运行​：支持Windows、macOS、Linux

• ​易于使用​：直观的界面和操作流程

• ​扩展性强​：支持新平台和功能扩展

• ​社区支持​：活跃的开源社区维护

🌟 ​GitHub地址​：

https://github.com/ihmily/StreamCap

🚀 ​快速开始​：

下载预构建版本或使用Docker运行

💬 ​社区支持​：

通过GitHub Issues获取帮助和支持

​立即体验StreamCap，轻松录制您喜爱的直播内容！​​

​最佳实践建议​：

• 🎓 ​教育用户​：系统化录制课程内容

• 🎮 ​游戏玩家​：收藏精彩游戏时刻

• 🎨 ​内容创作者​：收集创作素材和灵感

• 🔍 ​研究人员​：分析直播内容和趋势

• 💼 ​企业用户​：录制企业培训和活动

​注意事项​：

• ⚠️ ​版权尊重​：尊重内容创作者版权，合理使用录制内容

• 🔒 ​隐私保护​：避免录制和传播隐私敏感内容

• 💾 ​存储管理​：注意录制文件存储空间管理

• 📶 ​网络考虑​：确保稳定网络连接避免录制中断

• 🔄 ​定期更新​：保持软件更新以获得最新功能和支持

StreamCap持续演进和发展，欢迎用户反馈和贡献，共同打造更好的直播录制体验！