Content
<div align="center">
# EDITIA
### Edit TikToks with AI. Locally. Open source.
**The free, local-first video editor with voice cloning, karaoke subtitles, auto-reframe and an MCP brain.**
**Your videos never leave your computer.**
[](LICENSE)
[](#)
[](#)
[](https://github.com/pixelshelps-cloud/Editia/stargazers)
</div>
---
## Why EDITIA?
> **CapCut alternative. Open source. Runs on YOUR machine. AI included.**
Everyone wants viral content. Nobody wants their footage uploaded to a stranger's
server. EDITIA gives you a professional video editor that lives on your laptop,
clones voices on your GPU, generates karaoke subtitles in your local Whisper,
and lets **Claude, Cursor or any MCP agent edit your timeline by chat**.
No subscriptions. No telemetry. No accounts. **Yours.**
---
## What you get out of the box
### 🎬 Pro editing
- Multi-track timeline with snap, drag, ripple delete, undo/redo
- 11 LUT presets (Cinematic · Vintage · Cold · Warm · B&W · Vivid · Faded · Noir · Sunset · Dramatic)
- Color grading + crop manual + speed control (0.25x → 4x · slow-mo & time-lapse)
- PIP (picture-in-picture) with TL/TR/BL/BR presets
- Fade in/out + 10 transition types (cross-fade, slide, wipe, dip)
### 🎤 AI voice cloning (local)
- **Clone any voice** via XTTS-v2 on your GPU
- Generate dubs in PT/ES/EN in seconds
- Two built-in voices: `nuno` (M) · `clara` (F) — bring your own
### 📝 Karaoke subtitles (local)
- **faster-whisper** transcription on CUDA
- 5 viral presets: **Karaoke · MrBeast · Broadcast · Neon · Minimal**
- Word-by-word timing for that TikTok-style highlight
### 🎯 Auto-reframe 9:16 with face tracking
- **MediaPipe FaceDetector** local
- Real face detection → auto crop → never lose your subject
- Aspect targets: 9:16 · 1:1 · 4:5
### ✂️ Smart cuts
- Detects silences + filler words in PT/ES (eh, ah, tipo, sabes, pronto, vale…)
- One click to remove them all
### 🔥 Viral clipping
- Detects the 5 best moments of a 1h video
- Auto-export as 9:16 ready-to-upload Shorts
### 🌊 Audio that mixes itself
- **Auto-ducking**: your music drops automatically when there's voice
- Master volume + VU meter + per-clip volume
- Waveforms rendered live on the timeline
### 🥁 Beat detection
- FFT analysis on your soundtrack
- Auto-cut your video **on the beat**
### 🧠 MCP brain — agents can edit your timeline
- Standard MCP server with 8 tools
- Works with **Claude Code/Desktop, Cursor, Cline, Continue, Goose…**
- Type "make this 9:16 with karaoke subs" and watch it happen
### 📤 Export
- H.264 / H.265 / VP9 (MP4 or WebM)
- 6 social presets: TikTok / Reels / Shorts / IG Feed / YouTube 1080p / 4K
- Custom resolution + fps
### 🔒 Local-first by design
- Zero telemetry. Zero accounts. Zero servers.
- Your media never leaves your machine.
- Open source MIT.
---
## Quick start (Windows)
```bash
git clone https://github.com/pixelshelps-cloud/Editia.git
cd Editia
npm install
# double-click ABRIR-EDITIA.bat
```
The launcher spins up:
- Editor on `http://localhost:5173`
- Local transcription engine on `127.0.0.1:9173` (faster-whisper · CUDA)
- Local voice engine on `127.0.0.1:9174` (XTTS)
- MCP brain on `ws://127.0.0.1:9175`
A built-in 30-second interactive tour walks you through everything on first run.
Reopen it any time with **Shift+T**.
## Quick start (Linux/Mac)
```bash
npm install
npm run dev
```
For the sidecars (Python + CUDA): see [`sidecar/transcribe/README.md`](sidecar/transcribe/README.md).
---
## Connect an MCP agent
Drop this in your `.mcp.json` (Claude Code, Cursor, Cline, Continue…):
```json
{
"mcpServers": {
"editia": {
"command": "node",
"args": ["./sidecar/mcp/server.mjs"]
}
}
}
```
Tools your agent gets:
`editia_get_timeline` · `editia_add_text` · `editia_split_clip` ·
`editia_delete_clip` · `editia_move_clip` · `editia_generate_captions` ·
`editia_generate_voice` · `editia_import_media`
Then say things like:
- *"Add 'Bem-vindos' at second 2 in MrBeast style"*
- *"Cut on every beat of this song"*
- *"Make this 9:16 with karaoke subs in Portuguese"*
---
## Keyboard
| Key | Action |
|---|---|
| `Space` | Play / Pause |
| `J / K / L` | Rewind / Pause / Forward (accelerates on repeat) |
| `S` | Split clip at playhead |
| `D` | Duplicate clip |
| `M` | Add marker |
| `,` / `.` | Previous / Next marker |
| `Tab` / `Shift+Tab` | Next / Previous clip |
| `Del` / `Shift+Del` | Delete / Ripple delete |
| `Ctrl+Z` / `Ctrl+Y` | Undo / Redo |
| `←` / `→` | 1 frame |
| `Shift+←` / `Shift+→` | 1 second |
| `Alt+←` / `Alt+→` | Nudge clip by 1 frame |
| `Z` | Zoom-to-fit timeline |
| `G` | Toggle rule-of-thirds grid |
| `Shift+T` | Reopen 30-second tour |
| `?` | Show all shortcuts |
| `Esc` | Clear selection / close dialogs |
---
## Stack
| Layer | Library | License |
|---|---|---|
| Editor | React 18 + TypeScript + Vite + Tailwind + Zustand | MIT |
| Encoder | **mediabunny** + WebCodecs | MIT |
| Face tracking | `@mediapipe/tasks-vision` | Apache 2.0 |
| Transcription | **faster-whisper** (local · CUDA) | MIT |
| Voice cloning | **XTTS-v2** (local · GPU) | MPL 2.0 |
| Agent protocol | `@modelcontextprotocol/sdk` | MIT |
| Display font | **Bricolage Grotesque** | OFL |
Everything's MIT/Apache. No attribution required in your fork's LICENSE.
---
## Structure
```
editia/
├─ ABRIR-EDITIA.bat # one-click Windows launcher
├─ src/
│ ├─ components/ # UI (layout / preview / timeline / panels / inspector / onboarding)
│ ├─ stores/ # Zustand (project · ui · playback · onboarding)
│ ├─ services/ # transcribe / tts / export / smart-cut / viral / autoreframe /
│ │ # agent-bridge / persistence / transitions / ducking / beat-detection /
│ │ # text-anim / thumbnail / waveform / media-probe / media-fetch / recorder
│ ├─ hooks/ # keyboard / drop-import / render-preview / engine-status
│ ├─ lib/ # time · id · snap · luts · text-presets
│ ├─ data/ # onboarding-steps
│ └─ types/ # project (the entire data model)
└─ sidecar/
├─ transcribe/ # faster-whisper (9173) + XTTS (9174)
└─ mcp/ # WebSocket bridge + MCP wrapper (9175)
```
---
## Roadmap
- [ ] Color curves & wheels (DaVinci-style)
- [ ] Motion tracking (lock text to subject)
- [ ] Chroma key / green screen
- [ ] Stabilization
- [ ] AI upscaling (4K)
- [ ] Multi-language UI
PRs welcome. Issues bring beer.
---
## Author
Built by **Enrique Fernández**.
MIT © 2026 Enrique Fernández.
---
<div align="center">
**If EDITIA saves you 10 minutes, give it a ⭐.**
**Made with ❤️ and zero servers.**
</div>
