127 lines
3.3 KiB
Markdown
127 lines
3.3 KiB
Markdown
# 火炬格式转换器 0.1.0
|
||
|
||
基于 FFmpeg 和 Tauri 2.0 的跨平台媒体格式转换工具。
|
||
|
||
## 特性
|
||
|
||
- 🎬 支持多种视频格式：MP4、AVI、MKV、MOV、WebM 等
|
||
- 🎵 支持多种音频格式：MP3、WAV、AAC、FLAC、OGG 等
|
||
- ⚙️ 丰富的转换参数：编码器、分辨率、帧率、比特率等
|
||
- 📊 实时进度显示
|
||
- 🖥️ 跨平台支持：Windows、macOS、Linux
|
||
- 🚀 基于 Rust + Tauri 2.0，性能优异
|
||
|
||
## 系统要求
|
||
|
||
### 必需依赖
|
||
|
||
1. **FFmpeg** - 核心转换引擎
|
||
- Windows: 从 [ffmpeg.org](https://ffmpeg.org/download.html) 下载并添加到 PATH
|
||
- macOS: `brew install ffmpeg`
|
||
- Linux: `sudo apt install ffmpeg` 或对应包管理器
|
||
|
||
2. **Rust** - 编译 Tauri 后端
|
||
- 从 [rustup.rs](https://rustup.rs/) 安装
|
||
|
||
3. **Node.js** - 前端构建工具
|
||
- 从 [nodejs.org](https://nodejs.org/) 安装 (推荐 v18+)
|
||
|
||
### Tauri 2.0 系统依赖
|
||
|
||
请参考 [Tauri 2.0 官方文档](https://v2.tauri.app/start/prerequisites/) 安装对应平台的系统依赖。
|
||
|
||
## 快速开始
|
||
|
||
### 1. 克隆项目
|
||
|
||
```bash
|
||
git clone <your-repo>
|
||
cd format-converter
|
||
```
|
||
|
||
### 2. 安装依赖
|
||
|
||
```bash
|
||
npm install
|
||
```
|
||
|
||
### 3. 开发模式运行
|
||
|
||
```bash
|
||
npm run dev
|
||
```
|
||
|
||
### 4. 构建发布版本
|
||
|
||
```bash
|
||
npm run build
|
||
```
|
||
|
||
构建完成后，安装包位于 `src-tauri/target/release/bundle/` 目录。
|
||
|
||
## 使用说明
|
||
|
||
1. **选择文件**：点击"选择文件"按钮或拖拽文件到窗口
|
||
2. **设置参数**：
|
||
- 选择输出格式
|
||
- 配置编码器、分辨率、帧率等（可选）
|
||
- 选择输出路径
|
||
3. **开始转换**：点击"开始转换"按钮
|
||
4. **查看进度**：在任务列表中查看转换进度
|
||
|
||
## 支持的格式
|
||
|
||
### 视频格式
|
||
- **MP4** - 通用视频格式，兼容性好（支持 H.264、HEVC 编码）
|
||
- **AVI** - Windows 视频格式
|
||
- **MKV** - Matroska 格式，支持多音轨
|
||
- **MOV** - QuickTime 视频格式
|
||
- **WebM** - 网页视频格式
|
||
|
||
### 音频格式
|
||
- **MP3** - 通用音频格式
|
||
- **WAV** - 无损音频格式
|
||
- **AAC** - 高级音频编码
|
||
- **FLAC** - 无损音频压缩
|
||
- **OGG** - 开源音频格式
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
format-converter/
|
||
├── src/ # 前端源代码
|
||
│ ├── index.html # 主页面
|
||
│ ├── style.css # 自定义样式文件
|
||
│ └── main.js # 前端逻辑 (ES6 模块)
|
||
├── src-tauri/ # Tauri 2.0 后端
|
||
│ ├── src/
|
||
│ │ ├── main.rs # Rust 后端代码
|
||
│ │ └── ffmpeg_installer.rs # FFmpeg 安装器
|
||
│ ├── Cargo.toml # Rust 依赖
|
||
│ └── tauri.conf.json # Tauri 2.0 配置
|
||
├── package.json # Node.js 配置
|
||
└── README.md # 项目说明
|
||
```
|
||
|
||
## 技术栈
|
||
|
||
- **前端**: HTML5 + Tailwind CSS + ES6 JavaScript (模块化)
|
||
- **后端**: Rust + Tauri 2.0
|
||
- **核心引擎**: FFmpeg
|
||
- **插件系统**: Tauri 2.0 插件架构
|
||
|
||
### 调试
|
||
|
||
- 后端日志会在终端中输出
|
||
- 前端控制台可以通过 DevTools 查看（开发模式下按 F12）
|
||
- 使用 `console.log` 进行前端调试
|
||
|
||
## 许可证
|
||
|
||
MIT
|
||
|
||
## 致谢
|
||
|
||
- [FFmpeg](https://ffmpeg.org/) - 强大的多媒体处理框架
|
||
- [Tauri 2.0](https://v2.tauri.app/) - 下一代桌面应用开发框架
|
||
- [Tailwind CSS](https://tailwindcss.com) - 只需书写 HTML 代码即可快速构建美观的网站 |