CompressO开源视频压缩工具安装与配置指南

项目概述

CompressO是一款开源的跨平台视频压缩应用，能够将视频压缩至更小的尺寸。该项目基于FFmpeg进行视频压缩，使用Tauri框架构建跨平台桌面应用，并以Vite作为前端构建工具。CompressO完全在离线状态下工作，无需网络连接。

技术架构

CompressO采用现代化的技术栈构建：

• 前端框架: React 18 + TypeScript
• UI组件库: HeroUI（基于Tailwind CSS）
• 构建工具: Vite
• 桌面应用框架: Tauri（Rust）
• 视频处理: FFmpeg
• 状态管理: Valtio
• 动画库: Framer Motion

环境要求

在开始安装前，请确保系统满足以下要求：

• Node.js 18+ 版本
• Rust 工具链（用于 Tauri 构建）
• 系统依赖（根据操作系统不同）

安装步骤

1. 克隆项目代码

首先需要从GitCode获取项目源码：

git clone https://gitcode.com/gh_mirrors/co/compressO.git
cd compressO

2. 安装Node.js依赖

使用pnpm包管理器安装前端依赖：

pnpm install

3. 安装Rust依赖（Tauri构建）

确保Rust工具链已安装，然后构建Tauri后端：

cd src-tauri
cargo build

4. 开发环境启动

启动开发服务器：

pnpm tauri:dev

这将同时启动前端开发服务器和Tauri桌面应用。

项目配置

前端配置

前端配置位于项目根目录的配置文件中：

• vite.config.ts - Vite构建配置
• tailwind.config.ts - Tailwind CSS配置
• tsconfig.json - TypeScript配置
• biome.jsonc - 代码格式化配置

Tauri配置

Tauri相关配置位于 src-tauri/ 目录：

• tauri.conf.json - Tauri应用配置
• Cargo.toml - Rust项目配置
• capabilities/main.json - 应用权限配置

构建生产版本

构建所有平台

pnpm tauri:build

构建特定平台

构建Windows版本：

pnpm tauri:build --target x86_64-pc-windows-msvc

构建Linux版本：

pnpm tauri:build --target x86_64-unknown-linux-gnu

构建macOS版本：

pnpm tauri:build --target aarch64-apple-darwin

功能特性

CompressO提供以下核心功能：

• 视频压缩: 使用FFmpeg进行高效视频压缩
• 拖拽上传: 支持拖放文件到应用界面
• 实时预览: 压缩前后视频对比预览
• 多格式支持: 支持常见视频格式
• 离线工作: 完全离线运行，无需网络
• 跨平台: 支持Windows、Linux、macOS

项目结构

compressO/
├── src/                 # 前端源码
│   ├── components/      # React组件
│   ├── routes/         # 页面路由
│   ├── utils/          # 工具函数
│   └── types/          # TypeScript类型定义
├── src-tauri/          # Tauri后端
│   ├── src/           # Rust源码
│   ├── capabilities/   # 应用权限配置
│   └── icons/         # 应用图标
├── public/            # 静态资源
└── package.json       # 项目配置

常见问题解决

macOS系统问题

如果在macOS上遇到应用无法打开的问题，执行以下命令：

xattr -cr /Applications/CompressO.app

Windows Defender警告

Windows Defender可能会显示安全警告，这是因为应用未经过微软签名。点击"更多信息"然后选择"运行"即可。

Linux依赖问题

确保系统已安装必要的开发依赖：

# Ubuntu/Debian
sudo apt-get install libwebkit2gtk-4.0-dev build-essential curl wget libssl-dev libgtk-3-dev libayatana-appindicator3-dev librsvg2-dev

# Fedora
sudo dnf install webkit2gtk4.0-devel openssl-devel curl wget libappindicator-gtk3-devel librsvg2-devel

开发注意事项

1. 代码规范: 项目使用Biome进行代码格式化，提交前请运行 pnpm lint-staged
2. 类型安全: 充分利用TypeScript的类型系统
3. 性能优化: 视频处理操作应放在Tauri后端执行
4. 跨平台兼容: 确保代码在所有目标平台上正常工作

贡献指南

欢迎为CompressO项目贡献代码！提交PR前请确保：

1. 代码符合项目的编码规范
2. 所有测试通过
3. 更新相关文档
4. 遵循AGPL-3.0开源协议

许可证

CompressO采用AGPL-3.0许可证发布，同时使用了FFmpeg的LGPLv2.1许可库。使用本项目时请遵守相应的开源协议要求。

通过本指南，您应该能够成功安装、配置和开发CompressO视频压缩应用。如有任何问题，请参考项目文档或提交Issue。