lumen-ai-video-editor
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 6 GitHub stars
Code Fail
- process.env — Environment variable access in electron/collect.ts
- fs.rmSync — Destructive file system operation in electron/export.ts
- process.env — Environment variable access in electron/export.ts
- fs.rmSync — Destructive file system operation in electron/files.test.ts
- exec() — Shell command execution in electron/files.ts
- network request — Outbound network request in electron/files.ts
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
Open-source AI video editor for Windows: timeline editing, frame-exact export, on-device Whisper captions, Blender and HyperFrames motion graphics, and an AI Copilot (Claude Code, Codex, OpenAI, Gemini or any MCP agent) that can see, hear and edit your video.
Lumen — the open-source AI video editor
Edit video with an AI that can see, hear and cut.
Vibecoded with Claude Opus 5.5 by Mas-Inx at AsyncTech
Lumen is a desktop video editor where the AI isn't a chatbot bolted onto a timeline. It watches your edit frame by frame, listens to the mix, reads what's said — and makes real, undoable edits with the same tools you use. Bring your own brain: Claude Code, Codex, or a model with your OpenAI, Anthropic, Gemini, OpenRouter or local Ollama / LM Studio key.
Why Lumen
- An AI that edits, not just chats. Every edit in Lumen is a typed command, and the AI gets all of them — plus tools to look and listen. More than 100 tools in all, each change a normal undo step. See them all →
- It sees what you'll export. When the AI checks a frame, it's rendered exactly as the export will be: every track, title, effect and transition. It can watch the whole edit as a contact sheet, look inside footage, and hear loudness, silences and speech.
- Bring your own brain. Use the Claude Code or Codex you already pay for, an API key from any major provider, or a local model. Lumen is also an MCP server, so any agent can drive it.
- Local-first. Media is edited in place and never uploaded. Speech-to-text runs on your GPU with Whisper. No account, no watermark, no telemetry.
- A real editor underneath. A magnetic timeline, keyframes, 3D titles and transitions, colour looks, frame-exact export with hardware encoding — so you can finish by hand whatever the AI starts.
It's an open-source alternative to editors like CapCut, Filmora and Descript — built so an AI can do anything you can.
Made in Lumen, frame for frame: Blender backgrounds and a chrome 3D title, HyperFrames motion graphics, Whisper captions, and a 3D cube transition the Copilot added and checked.
Contents
- Features — editing · Copilot · smart edits · generation · export · integrations
- Download · Build from source · Documentation · Roadmap · Contributing · Credits
Features
A real editor
- Magnetic main track that keeps your story edge to edge, with free tracks above and below for B-roll, overlays, titles, captions, voice, music and sound effects.
- Split, trim, ripple, slide into gaps, snapping, markers, speed and reverse, and keyframes with easing on every property.
- Pro editing tools: roll, slip and slide; ripple trim and insert or overwrite on any track; in and out points to play, lift, extract or export a stretch; copy, cut, paste and paste attributes; crop with rounded corners; freeze frames and speed ramps; detached sound for J- and L-cuts; groups; and solo and reorder for tracks.
- 2D and 3D transitions (cube, flip, door, page curl, shatter…), effects, colour looks and grading, and extruded 3D titles rendered live.
- Real colour grading on the GPU: tone curves, lift / gamma / gain wheels, HSL by colour range, imported .cube LUTs, and scopes (waveform, RGB parade, vectorscope, histogram) beside the program monitor.
- Compositing: chroma and luma keys with an eyedropper and spill suppression; feathered rectangle and ellipse masks you drag on the canvas (on adjustment layers too, to grade just part of the frame); outlined titles in any font — imported, or picked from those installed on your computer, and embedded in the project.
- Sound that drives the picture: a Web Audio mix with per-clip volume, fades and keyframes, Studio voice clean-up, on-device noise reduction and 15 built-in sound effects.
- A real mixer: a channel per track and a master bus, each with a fader, pan, a draggable EQ curve, a compressor and a limiter, with live meters. Transitions crossfade the sound too, and exports can be loudness-normalized to −14 LUFS for YouTube and Spotify, −16 for Apple, or broadcast's −23 and −24.
- Import MP4, MOV, WebM, MKV, MP3, WAV, FLAC, PNG, JPEG, WebP, GIF and more — by dialog, folder or drag and drop. Files stay where they are; missing ones can be relinked.
.lumenproject files that survive moving folders between drives, crash recovery, and undo for everything.Ctrl+Kreaches every command.- Built for long, heavy projects: proxies for 4K footage (made automatically in the background; exports always use the originals), hour-long recordings that stream instead of filling memory, version history (every save, plus a snapshot every ten minutes while you edit, restorable any time) and Collect project to gather a project and all its media into one folder.
- Multiple timelines and nesting: as many timelines per project as you like — another cut, or a vertical copy reframed in one click — and nest any clips into a timeline of their own to grade, speed up or cut them as one piece (double-click to step inside; picture and sound both play through).
- Multicam: pick the camera recordings and Lumen lines them up by their sound (to about a millisecond), then press
1–9while it plays to cut between angles, with every camera live in a strip under the preview. - Reads the footage: scene detection splits or marks a clip at every shot change; stabilization smooths away camera shake with just enough zoom; motion tracking pins a title, sticker or mask to something moving — including a blur that follows a face.
The Copilot sees, hears and edits
![]() |
Ask in plain words — or talk to it. The Copilot plans, uses Lumen's tools, and checks its own work:
You see every step, including the frames it looked at, and Undo all reverts a whole answer. |
What the AI sees when it watches your edit — one call to get_contact_sheet:
Brains: your own Claude Code or Codex (Lumen runs them headless, with only Lumen's tools), or a model with your key: Anthropic, OpenAI, Google Gemini, OpenRouter, OpenCode Zen, OpenCode Go, Ollama, LM Studio or any OpenAI-compatible endpoint. Pick the model and the effort — how hard it thinks, from Low to Max (Ultra on Codex) — for every one of them, Claude Code's Fable, Opus, Sonnet and Haiku and Codex's own model list included. Keys are encrypted by Windows (DPAPI) and never leave the app's main process.
Smart edits
One-click suggestions on the timeline, and tools for every AI:
- Transcribe on the device with Whisper (GPU via WebGPU, or CPU), or with OpenAI or ElevenLabs.
- Remove pauses — the whole timeline closes up around each cut, so captions, B-roll and markers stay in sync while music plays on; with several speakers it only cuts where everyone is quiet.
- Captions from the transcript, on their own track — or import SRT / WebVTT files (drop them on the timeline), and export the captions as SRT or WebVTT, on their own or next to the video.
- Duck music under speech with volume keyframes.
- Reframe between landscape, vertical, square and portrait.
- Hear the mix — loudness in LUFS against the −14 streaming target, peaks, clipping and silences.
Generate 3D, motion graphics, images, video and voice
- Blender — real extruded 3D titles, looping abstract backgrounds and AI-written scenes, rendered in the background and dropped into your media.
- HyperFrames motion graphics — lower thirds, title cards, kinetic type, stat counters or any HTML + GSAP composition — rendered inside Lumen.
- Images and video from your OpenAI key (GPT Image) or Gemini key (Gemini image models, Veo video), with model lists fetched live — new models show up without an update.
- Voiceovers, sound effects and music with ElevenLabs.
- Anything from an MCP server — Higgsfield, Runway, Replicate, fal.ai or your own.
Effects, transitions and looks

2D and 3D transitions, 15 effects (glow, grain, shake, RGB split, 3D tilt, curved screen…), one-click colour looks and full grading — each previewed on your own footage before you apply it.
Export
| Format | Codecs |
|---|---|
| MP4 | H.264, HEVC, AV1 |
| MOV | H.264, HEVC |
| WebM | VP9 (with transparency), AV1 |
| PNG | numbered frames, with transparency |
| GIF | animated, palette-optimised |
| WAV · M4A | audio only |
From 480p to 4K in your timeline's shape, 24–60 fps, with hardware encoding where your GPU supports it, a live file-size estimate and progress in the taskbar. Export any timeline, burn captions in or save them as an SRT / WebVTT file beside the video, and line several exports up in the render queue to render one after another while you keep editing.
Connect anything
Lumen is an MCP server. Turn it on and any agent — Claude Code, Claude Desktop, your own — gets the same 100-plus tools, pictures included:
claude mcp add --transport http lumen http://127.0.0.1:47910/mcp --header "Authorization: Bearer <token from Lumen>"Lumen is an MCP client. Add any server by URL or command; generator tools show up as models in the Generate panel.
Download
Download the latest Lumen for Windows →
Windows 10 or 11, 64-bit. The installer lets you install just for yourself (no admin needed) or for everyone, and associates .lumen project files.
Lumen keeps itself up to date: it checks the Releases page, downloads a new version in the background and installs it when you restart (or choose Check for updates in the Lumen menu).
[!NOTE]
The installer isn't code-signed yet, so Windows SmartScreen may say “Windows protected your PC”. Choose More info → Run anyway. Every release lists SHA-256 checksums.
Optional: Blender 4.2+ for 3D renders. Everything else is built in; the Whisper speech model downloads once (about 200 MB) the first time you transcribe on your device.
Build from source
You need Windows 10/11 and Node.js 24.
git clone https://github.com/Mas-inx/lumen-ai-video-editor.git
cd lumen-ai-video-editor
npm install
npm run dev # the app, with hot reload
| Command | What it does |
|---|---|
npm run dev |
Electron app with hot reload |
npm run dev:web |
The UI in a browser tab (no desktop features) |
npm test |
Unit tests (Vitest) |
npm run typecheck |
TypeScript, renderer and main process |
npm run dist |
Windows installer in release/ |
Documentation
- AI tools reference — every tool the AI can use, with parameters
- Architecture — how the editor, media engine, AI and integrations fit together
- Contributing · Changelog · Security · Third-party notices
| Keys | Action |
|---|---|
Space · J K L |
Play / pause · shuttle |
← → · ↑ ↓ |
Frame step · previous / next edit point |
S · Del · Shift+Del |
Split · delete · ripple delete |
V · B · N · M |
Select tool · blade · snapping · marker |
R · Y · U |
Roll · slip · slide tools |
I · O · X · Alt+X |
Mark in · out · around the selection · clear |
Shift+Space · ; · ' |
Play in to out · lift · extract |
Ctrl+C · Ctrl+X · Ctrl+V · Ctrl+Alt+V |
Copy · cut · paste · paste attributes |
Shift+F · Ctrl+L · Ctrl+G |
Freeze frame · detach audio · group |
Ctrl+Shift+D |
Crossfade with the clip before |
Ctrl+Alt+N · Ctrl+Alt+Enter |
Nest the selection · open a nested clip's timeline |
1 – 9 |
Multicam: cut to that camera at the playhead |
Drag + Ctrl · Shift |
Insert · overwrite (on a trim handle, Ctrl ripples) |
= - · Shift+Z |
Zoom · zoom to fit |
Ctrl+Z · Ctrl+Shift+Z |
Undo · redo |
Ctrl+I · Ctrl+E · Ctrl+S · Ctrl+O |
Import · export · save · open |
Ctrl+Shift+E |
Render queue |
Ctrl+K · Ctrl+J · ? |
Command palette · Copilot · all shortcuts |
Roadmap
Ideas the project is heading towards — contributions welcome:
- macOS and Linux builds
- Code-signed installer
- More languages for the interface
Contributing
Bug reports, ideas and pull requests are welcome — start with CONTRIBUTING.md. Every edit in Lumen is a command in src/editor/commands.ts, and every AI tool lives in src/integrations/tools/, so adding a feature for people usually adds it for the AI too.
Credits
Lumen was vibecoded with Claude Opus 5.5 in Claude Code by Mas-Inx at AsyncTech.
License
MIT © 2026 Mas-Inx. Lumen builds on excellent open-source work — see THIRD-PARTY-NOTICES.md.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found
