commit ff4b6a149ac09573f55db5d1f9a0bd4228ed3d21 Author: William Date: Fri Feb 6 12:29:52 2026 +0600 first commit diff --git a/README.md b/README.md new file mode 100644 index 0000000..91cf431 --- /dev/null +++ b/README.md @@ -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 +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] () - \ No newline at end of file