# video

**Repository Path**: chy2948331536/video

## Basic Information

- **Project Name**: video
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-04
- **Last Updated**: 2025-12-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Video Tool - 视频处理工具

一个简单的命令行视频处理工具，支持裁剪、压缩和播放功能，基于 ffmpeg 和 mpv。

## 安装

### 1. 安装系统依赖（自动安装）

```bash
# 进入项目目录
cd video_process

# 运行自动安装脚本（会自动检测系统并安装 ffmpeg 和 mpv）
./install_dependencies.sh
```

### 2. 安装 Python 包

```bash
# 安装为可执行命令
pip install -e .
```

### 手动安装依赖（如果自动安装失败）

```bash
# Ubuntu/Debian
sudo apt install ffmpeg mpv

# macOS
brew install ffmpeg mpv

# CentOS/RHEL
sudo yum install epel-release
sudo yum install ffmpeg mpv

# Fedora
sudo dnf install ffmpeg mpv
```

## 使用方法

### 视频裁剪

```bash
# 进入包含视频的目录
cd /path/to/videos

# 启动裁剪模式
video cut
```

程序会：
1. 列出当前目录下所有视频文件（按日期排序）
2. 提示选择要裁剪的视频
3. 提示输入开始时间和裁剪时长
4. 输出文件名为：`原文件名_cut.mp4`

### 视频压缩

```bash
# 进入包含视频的目录
cd /path/to/videos

# 启动压缩模式
video compress
```

程序会：
1. 列出当前目录下所有视频文件（按日期排序）
2. 提示选择要压缩的视频
3. 选择压缩质量（高质量/推荐/中等/高压缩/自定义）
4. 输出文件名为：`原文件名_compressed.mp4`

**压缩质量参考：**
- 高质量 (CRF=18) - 接近无损，文件较大
- 推荐 (CRF=23) - 质量与大小平衡（默认）
- 中等 (CRF=28) - 适合网络分享
- 高压缩 (CRF=32) - 文件小，画质有损失

### 视频播放

```bash
# 进入包含视频的目录
cd /path/to/videos

# 启动播放模式
video play
```

程序会：
1. 列出当前目录下所有视频文件（按日期排序）
2. 提示选择要播放的视频
3. 使用 mpv 播放器打开视频

**播放控制：**
- `空格键` - 暂停/播放
- `,` (逗号) - 上一帧
- `.` (点) - 下一帧
- `q` - 退出播放

### 时间格式（裁剪模式）

支持多种时间格式：
- `HH:MM:SS` - 如 `01:30:00`（1小时30分）
- `MM:SS` - 如 `5:30`（5分30秒）
- 秒数 - 如 `90`（90秒）

### 帮助

```bash
video help
```

## 支持的视频格式

- MP4
- AVI
- MOV
- MKV
- WMV
- FLV

## 卸载

```bash
pip uninstall video-tool
```