Video Converter TypeScript

视频转换工具 - TypeScript 实现版本，支持多种输出格式。

功能特性

- 支持三种输出格式：MJPEG、AVI-MJPEG、H264
- 自动检测视频信息（分辨率、帧率、时长等）
- 进度显示
- AVI 文件 8 字节对齐处理
- H264 自定义头部封装

系统要求

- Node.js 18+
- FFmpeg（需要在系统 PATH 中可用）

安装

``bash
cd video-converter-ts
npm install
npm run build
`

使用方法

$3

`bash
node dist/cli.js --info -i <输入视频路径>
`

示例：
`bash
node dist/cli.js --info -i ../test_video/birds.mp4
`

$3

基本语法：
`bash
node dist/cli.js -i <输入文件> -o <输出文件> -f <格式> [选项]
`

#### 支持的格式

| 格式 | 参数值 | 说明 |
|------|--------|------|
| MJPEG | mjpeg | Motion JPEG 格式，连续 JPEG 帧 |
| AVI-MJPEG | avi_mjpeg | AVI 容器封装的 MJPEG，8 字节对齐 |
| H264 | h264 | H.264 裸流，带自定义头部 |

#### 转换示例

转换为 MJPEG：
`bash
node dist/cli.js -i ../test_video/birds.mp4 -o output.mjpeg -f mjpeg -v
`

转换为 AVI-MJPEG：
`bash
node dist/cli.js -i ../test_video/birds.mp4 -o output.avi -f avi_mjpeg -v
`

转换为 H264：
`bash
node dist/cli.js -i ../test_video/birds.mp4 -o output.h264 -f h264 -v
`

#### 命令行参数

| 参数 | 简写 | 说明 |
|------|------|------|
| --input | -i | 输入视频文件路径（必需） |
| --output | -o | 输出文件路径（必需） |
| --format | -f | 输出格式：mjpeg, avi_mjpeg, h264（必需） |
| --fps | -r | 目标帧率（可选，默认保持原帧率） |
| --quality | -q | 质量参数（可选，MJPEG: 1-31，H264 CRF: 0-51） |
| --verbose | -v | 显示详细信息 |
| --debug | -d | 调试模式：保留中间文件 |
| --info | | 仅显示视频信息，不转换 |
| --help | -h | 显示帮助信息 |

$3

使用 -d 或 --debug 参数启用调试模式，转换过程中的中间文件将被保留：

`bash
node dist/cli.js -i ../test_video/birds.mp4 -o output.avi -f avi_mjpeg -v -d
`

对于 AVI-MJPEG 转换，调试模式会保留以下文件：
- output.ffmpeg.avi - FFmpeg 直接输出（后处理前）
- output.pass1.avi - 第一遍对齐后（JUNK 块调整，首帧对齐）
- output.avi - 最终输出（所有帧 8 字节对齐）

$3

`typescript
import { VideoConverter, OutputFormat } from './dist/index.js';

const converter = new VideoConverter((current, total) => {
console.log(进度: ${current}/${total});
});

// 获取视频信息
const info = await converter.getVideoInfo('input.mp4');
console.log(info);

// 转换视频
const result = await converter.convert(
'input.mp4',
'output.mjpeg',
OutputFormat.MJPEG,
{ frameRate: 25, quality: 2 }
);
`

测试

$3

`bash
npm test -- --run
`

$3

`bash
npm test -- --run tests/avi-aligner.test.ts
npm test -- --run tests/mjpeg-packer.test.ts
npm test -- --run tests/parser.test.ts
npm test -- --run tests/ffmpeg-builder.test.ts
npm test -- --run tests/ffmpeg-executor.test.ts
`

$3

`bash
npm test -- --run --coverage
`

项目结构

`
video-converter-ts/
├── src/
│ ├── cli.ts # 命令行入口
│ ├── converter.ts # 主转换器
│ ├── parser.ts # 视频信息解析
│ ├── ffmpeg-builder.ts # FFmpeg 命令构建
│ ├── ffmpeg-executor.ts # FFmpeg 执行器
│ ├── models.ts # 数据模型
│ ├── errors.ts # 错误定义
│ ├── index.ts # 模块导出
│ └── postprocess/
│ ├── avi-aligner.ts # AVI 8字节对齐
│ ├── mjpeg-packer.ts # MJPEG 打包
│ ├── h264-packer.ts # H264 封装
│ └── index.ts
├── tests/
│ ├── avi-aligner.test.ts
│ ├── mjpeg-packer.test.ts
│ ├── parser.test.ts
│ ├── ffmpeg-builder.test.ts
│ ├── ffmpeg-executor.test.ts
│ └── h264-packer.test.ts
├── dist/ # 编译输出
├── package.json
├── tsconfig.json
└── vitest.config.ts
`

输出格式说明

$3

- 连续的 JPEG 帧，每帧以 SOI (0xFFD8) 开始，EOI (0xFFD9) 结束
- 仅包含 baseline JPEG 帧

$3

- 标准 AVI 容器格式
- 所有帧数据 8 字节对齐（通过 JUNK 块和 APP1 段填充）
- 包含 idx1 索引块

$3

- 自定义 32 字节头部
- 包含分辨率、帧数、帧时间等信息
- 后跟 H.264 裸流数据

常见问题

$3

确保 FFmpeg 已安装并在系统 PATH 中：
`bash
ffmpeg -version
`

$3

如果遇到脚本执行问题，可以使用 cmd 包装：
`bash
cmd /c "npm run build"
cmd /c "npm test -- --run"
``

许可证

MIT