# LiveRecorder

**Repository Path**: dych/live-recorder

## Basic Information

- **Project Name**: LiveRecorder
- **Description**: 本项目是一款直播间录制工具，适用于需要回放、剪辑或二次利用直播内容的场景。目前仅支持抖音直播间。
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2025-01-23
- **Last Updated**: 2025-01-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Live Recorder

## 项目简介
本项目是一款直播间录制工具，适用于需要回放、剪辑或二次利用直播内容的场景。目前仅支持抖音直播间。

## 功能特性
1. **实时监控与下载**：本工具可以实时监测指定抖音直播间，一旦开播即刻自动下载视频片段。
2. **直播链接解析**：可复制链接到PotPlayer播放器播放，避免直播间特效干扰，减少资源占用。
3. **工具类**：可作为工具类导入项目中使用。
4. **使用方便**：下载打包后的JAR文件，可在任何安装了Java环境的机器上启动，无需ffmpeg。

### 核心类说明
#### `LiveM3U8Downloader`
- 直播TS文件的单线程下载器。
- 可实现DownloadProgress接口感知下载过程。
- 合并文件分片和重试。

#### `Recorder`
- 直播间录制器，可实现StreamFinder定制直播间视频流查找器。
- 监听直播间状态，自动下载视频片段。
- 可设置立即下载和监听两种模式。

## 使用指南
### JAR文件启动
#### 参数启动
1. 下载`jar`文件。
2. `java -jar liverecorder.jar <直播间URL> <监听起始时间（可选）> <监听结束时间（可选）> <监听时间间隔（可选）> &`
#### 直接启动
1. 下载`jar`文件。
2. `java -jar liverecorder.jar`
3. 控制台中根据提示输入直播间URL。
### 源码启动
1. 安装Maven。
2. `mvn package`
3. 参照JAR文件部分。
### 使用本项目作为工具类
1. 参照核心类说明。

## 注意事项
- 请遵守相关法律法规以及抖音平台的服务条款，不得非法获取和传播他人直播内容。
- 若在使用过程中遇到任何问题，请提交GitHub issue或联系项目维护者。

## 开发与贡献
欢迎开发者参与本项目的改进与优化，您可以fork项目并提交Pull Request。同时，我们也鼓励用户报告bug、提出新功能建议以及分享使用经验。

---