RomanNum3ral
/
OpenCut
mirror of https://github.com/OpenCut-app/OpenCut.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
The open-source CapCut alternative
1,366 Commits 31 Branches 4 Tags 43 MiB
TypeScript 97.2%
CSS 2.1%
Rust 0.7%
Go to file
anh doan 81adac6e1e
feat(effects): add @opencut/effects package with 24 effects and presets 
Add a standalone effects package that extracts effect definitions,
GLSL shaders, and registry from @opencut/web into a reusable package.

## Package (@opencut/effects)

- Registry: register/get/has/getAll effects with Map-based lookup
- Categories: COLOR_TONE, ARTISTIC, BEAUTY with display metadata
- Types: Effect, EffectDefinition, EffectContext, WebGLEffectPass

### Effects (24 total)

**Color & Tone (8):** brightness, contrast, saturation, hue-shift,
temperature, exposure, gamma, color-balance

**Artistic (10):** blur, vignette, film-grain, sharpen, pixelate,
chromatic-aberration, glitch (2-pass), neon-glow (2-pass),
sketch (2-pass), oil-paint (2-pass)

**Beauty (6):** skin-smooth (bilateral filter), face-brighten,
eye-enhance, teeth-whiten, blush, slim-face

### Presets (12)

- Instagram: clarendon, juno, lark, gingham, valencia, nashville
- Cinematic: teal-and-orange, vintage-film, noir, bleach-bypass
- Beauty: soft-glow, portrait

## Web App Integration

- Migrate blur effect from web app to package
- Update imports via re-export pattern (backward compatible)
- Pass time param for animated effects (film-grain, glitch)
- Add face-mesh service using MediaPipe Face Mesh (lazy-loaded)
- Beauty effects auto-detect faces and pass EffectContext
- Async renderVisual for face detection pipeline

## Tests

152 unit tests covering registry, all effect definitions, and presets
 		2026-03-23 13:32:46 +07:00
.cursor update cursor rule 2026-03-02 10:32:46 +01:00
.github feat: major editor overhaul (assets, properties, timeline, fonts) (#709) 2026-02-23 03:24:02 +01:00
.vscode feat: major editor overhaul (assets, properties, timeline, fonts) (#709) 2026-02-23 03:24:02 +01:00
apps/web feat(effects): add @opencut/effects package with 24 effects and presets 2026-03-23 13:32:46 +07:00
docs docs: keyframes system 2026-03-02 16:02:32 +01:00
packages feat(effects): add @opencut/effects package with 24 effects and presets 2026-03-23 13:32:46 +07:00
.dockerignore docker + update readme 2026-02-23 09:38:38 +01:00
.gitignore feat: changelog page 2026-02-28 23:58:54 +01:00
.npmrc fix: CDN instead of app for databooty 2025-07-02 16:25:08 +03:00
AGENTS.md codebase overhaul (#697) 2026-01-31 00:20:04 +01:00
LICENSE change app name from AppCut to OpenCut 2025-06-22 22:22:08 +02:00
README.md docs: move sponsors near the top 2026-02-25 01:40:12 +01:00
biome.json feat: major editor overhaul (assets, properties, timeline, fonts) (#709) 2026-02-23 03:24:02 +01:00
bun.lock feat(effects): add @opencut/effects package with 24 effects and presets 2026-03-23 13:32:46 +07:00
docker-compose.yml docker + update readme 2026-02-23 09:38:38 +01:00
package.json feat: introduce WebGL effects system and Blur effect 2026-02-28 18:41:22 +01:00
tsconfig.json feat: major editor overhaul (assets, properties, timeline, fonts) (#709) 2026-02-23 03:24:02 +01:00
turbo.json feat: major editor overhaul (assets, properties, timeline, fonts) (#709) 2026-02-23 03:24:02 +01:00

README.md

OpenCut Logo

OpenCut

A free, open-source video editor for web, desktop, and mobile.

Sponsors

Thanks to Vercel and fal.ai for their support of open-source software.

Vercel OSS Program Powered by fal.ai

Why?

  • Privacy: Your videos stay on your device
  • Free features: Most basic CapCut features are now paywalled
  • Simple: People want editors that are easy to use - CapCut proved that

Features

  • Timeline-based editing
  • Multi-track support
  • Real-time preview
  • No watermarks or subscriptions
  • Analytics provided by Databuddy, 100% Anonymized & Non-invasive.
  • Blog powered by Marble, Headless CMS.

Project Structure

  • apps/web/ – Main Next.js web application
  • src/components/ – UI and editor components
  • src/hooks/ – Custom React hooks
  • src/lib/ – Utility and API logic
  • src/stores/ – State management (Zustand, etc.)
  • src/types/ – TypeScript types

Getting Started

Prerequisites

Note: Docker is optional but recommended for running the local database and Redis. If you only want to work on frontend features, you can skip it.

Setup

  1. Fork and clone the repository

  2. Copy the environment file:

    # Unix/Linux/Mac
cp apps/web/.env.example apps/web/.env.local

# Windows PowerShell
Copy-Item apps/web/.env.example apps/web/.env.local

  3. Start the database and Redis:

    docker compose up -d db redis serverless-redis-http

  4. Install dependencies and start the dev server:

    bun install
bun dev:web

The application will be available at http://localhost:3000.

The .env.example has sensible defaults that match the Docker Compose config — it should work out of the box.

Self-Hosting with Docker

To run everything (including a production build of the app) in Docker:

docker compose up -d

The app will be available at http://localhost:3100.

Contributing

We welcome contributions! While we're actively developing and refactoring certain areas, there are plenty of opportunities to contribute effectively.

🎯 Focus areas: Timeline functionality, project management, performance, bug fixes, and UI improvements outside the preview panel.

⚠️ Avoid for now: Preview panel enhancements (fonts, stickers, effects) and export functionality - we're refactoring these with a new binary rendering approach.

See our Contributing Guide for detailed setup instructions, development guidelines, and complete focus area guidance.

Quick start for contributors:

  • Fork the repo and clone locally
  • Follow the setup instructions in CONTRIBUTING.md
  • Create a feature branch and submit a PR

License

MIT LICENSE

Star History Chart