OpenCut 中文版 免费、开源的网页端、桌面端和移动端视频编辑器（中文汉化版）

(群号: 83958598)

🌐

在线预览地址： https://v.sparkbazaar.cn/

本项目是 OpenCut 的中文汉化版本。

汉化目的：

• 为中文用户提供更友好的使用体验
• 降低中文用户的使用门槛
• 推广开源视频编辑解决方案在中文社区的应用
• 保持与原项目同步更新

原项目地址： https://github.com/OpenCut-app/OpenCut

• 隐私保护：视频完全保存在本地设备，不会上传到云端
• 完全免费：所有功能免费使用，没有付费墙限制（不像剪映的很多功能需要付费）
• 简单易用：注重用户体验，操作简单直观

• ✨ 基于时间轴的编辑功能
• 🎬 多轨道支持
• ⚡ 实时预览
• 🚫 无水印、无订阅
• 📊 由 Databuddy 提供匿名化分析
• 📝 博客功能由 Marble 无头 CMS 驱动

• apps/web/ – 主要的 Next.js Web 应用
• src/components/ – UI 和编辑器组件
• src/hooks/ – 自定义 React Hooks
• src/lib/ – 工具函数和 API 逻辑
• src/stores/ – 状态管理（Zustand 等）
• src/types/ – TypeScript 类型定义

在开始之前，请确保你的系统已安装以下工具：

• Node.js (v18 或更高版本)
• Bun (npm 的替代方案)
• Docker 和 Docker Compose

注意： Docker 是可选的，但对于运行本地数据库和 Redis 服务是必需的。如果你只是想运行前端或贡献前端功能，可以跳过 Docker 设置。

1. Fork 本仓库

2. 克隆到本地

3. 进入 Web 应用目录：cd apps/web

4. 复制环境配置文件 .env.example 到 .env.local：

   # Unix/Linux/Mac
   cp .env.example .env.local
   
   # Windows 命令提示符
   copy .env.example .env.local
   
   # Windows PowerShell
   Copy-Item .env.example .env.local

5. 安装依赖：bun install

6. 启动开发服务器：bun dev

1. 启动数据库和 Redis 服务：

   # 在项目根目录
   docker-compose up -d

2. 进入 Web 应用目录：

   cd apps/web

3. 复制环境配置文件：

   # Unix/Linux/Mac
   cp .env.example .env.local
   
   # Windows 命令提示符
   copy .env.example .env.local
   
   # Windows PowerShell
   Copy-Item .env.example .env.local

4. 在 .env.local 中配置必需的环境变量：

   必需变量：

   # 数据库配置（与 docker-compose.yaml 一致）
   DATABASE_URL="postgresql://opencut:opencutthegoat@localhost:5432/opencut"
   
   # 生成一个安全密钥用于 Better Auth
   BETTER_AUTH_SECRET="your-generated-secret-here"
   BETTER_AUTH_URL="http://localhost:3000"
   
   # Redis 配置（与 docker-compose.yaml 一致）
   UPSTASH_REDIS_REST_URL="http://localhost:8079"
   UPSTASH_REDIS_REST_TOKEN="example_token"
   
   # Marble 博客配置
   MARBLE_WORKSPACE_KEY=cm6ytuq9x0000i803v0isidst # 示例组织密钥
   NEXT_PUBLIC_MARBLE_API_URL=https://api.marblecms.com
   
   # 开发环境
   NODE_ENV="development"

   生成 BETTER_AUTH_SECRET：

   # Unix/Linux/Mac
   openssl rand -base64 32
   
   # Windows PowerShell
   [System.Web.Security.Membership]::GeneratePassword(32, 0)
   
   # 跨平台方式（使用 Node.js）
   node -e "console.log(require('crypto').randomBytes(32).toString('base64'))"
   
   # 或使用在线生成器：https://generate-secret.vercel.app/32

5. 运行数据库迁移：bun run db:migrate（在 apps/web 目录内）

6. 启动开发服务器：bun run dev（在 apps/web 目录内）

应用将在 http://localhost:3000 上运行。

我们欢迎各种形式的贡献！目前我们正在积极开发和重构某些功能模块。

🎯 重点贡献方向： 时间轴功能、项目管理、性能优化、Bug 修复以及预览面板之外的 UI 改进。

⚠�� 暂时避免： 预览面板增强功能（字体、贴纸、特效）和导出功能 - 我们正在使用新的二进制渲染方法重构这些功能。

查看我们的 贡献指南 了解详细的设置说明、开发指南和完整的贡献方向。

贡献者快速入门：

• Fork 本仓库并克隆到本地
• 按照 CONTRIBUTING.md 中的设置说明操作
• 创建功能分支并提交 PR

如果你想为汉化工作做出贡献，欢迎：

• 改进现有翻译
• 翻译新增功能
• 修正翻译错误
• 优化用户界面的中文表达

MIT LICENSE

如有问题或建议，欢迎：

• 提交 Issue
• 发起 Pull Request
• 参与讨论

让我们一起让 OpenCut 在中文社区更好用！ 🎉