first commit
This commit is contained in:
127
README.md
Normal file
127
README.md
Normal 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] () -
|
||||||
Reference in New Issue
Block a user