first commit

This commit is contained in:
2026-02-06 12:29:52 +06:00
commit ff4b6a149a

127
README.md Normal file
View File

@@ -0,0 +1,127 @@
# 火炬格式转换器 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] () -