ai-video-editor
Open-source, local-first video editor where creators and AI agents edit the same real timeline.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/MartinDelophy/ai-video-editor with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/MartinDelophy/ai-video-editor'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/martindelophy--ai-video-editor)HTML
<a href="/listings/martindelophy--ai-video-editor"><img src="/api/listings/martindelophy--ai-video-editor/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
Requirements: Node.js 20+ and a modern Chromium browser. WebGPU is recommended for the heaviest AI workflows.
git clone https://github.com/MartinDelophy/ai-video-editor.git cd ai-video-editor npm install npm run dev
Open the local URL printed by Vite. The first AI run may download model files; later runs reuse the browser cache.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 249 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Timeline Studio — Browser AI Video Editor
- **English** | [中文](README.zh-CN.md) | [日本語](README.ja.md) | [한국어](README.ko.md) | [Español](README.es.md) | [Français](README.fr.md) | [Deutsch](README.de.md) | [Português](README.pt-BR.md) | [ไทย](README.th.md) | [Tiếng Việt](README.vi.md) | [Русский](README.ru.md)
- [](https://video-editor.ai-creator.top/)
- [](LICENSE)
- [](https://skills.sh/MartinDelophy/ai-video-editor)
- [](CONTRIBUTING.md) [](https://linux.do)
- <a href="https://toolindex.net/tools/timeline-studio?ref=badge" target="_blank" rel="noopener">
- <img src="https://toolindex.net/badge/timeline-studio/small.svg?theme=dark" alt="Timeline Studio - Listed on Tool Index" width="130" height="30" />
- </a>
- ## Create with Anna
- Try the Anna edition for AI-assisted editing and project continuity:
- - Describe your edit to Anna, review a plan based on your brief and clip metadata, then apply supported clip ordering and simple 1× video trims.
- - Projects and media save automatically to Anna cloud storage and can resume with the same Anna account in another browser. Local project checkpoints provide an additional recovery option.
- - Refine the editable multi-track timeline, add AI voiceovers and manual captions, and export MP4 using an available browser encoder.
- This desktop preview plans from metadata, without analyzing video frames or audio; local AI features depend on the Anna container’s capabilities.
- → [Try Timeline Studio on Anna](https://anna.partners/store/@martindelophy/timeline-studio)
- 遇到任何问题,欢迎扫码进群交流。我们急需你的建议和反馈!
- Run into any issues? Scan the QR code to join our WeChat group. We really need your suggestions and feedback!
- <img src="docs/images/wechat-feedback-qr-2026-11-14.png" alt="WeChat group QR code" width="280" />
- ## Responsible use of deep synthesis
- This tool uses deep-synthesis technology and is intended solely for technical research and learning.
- Users must ensure that they:
- - use only facial images or videos of themselves or people who have provided lawful authorization;
- - do not create or distribute any illegal, infringing, false, or misleading content;
- - do not present generated content as authentic footage or impersonate another person without their consent.
- Users are solely responsible for any legal liability arising from violations of these requirements.
- ## Project updates
- - **2026-11-13** — Video imports extract timeline thumbnails in batches. Preview updates follow playhead dragging more closely, with the same frame timing. The playhead does less work while dragging, especially in projects with many clips.
- - **2026-11-10** — The Media library now has 120 sound effects to search, preview, and add to the timeline. Sound effects and music share one curve. Drag its middle to adjust volume and the two end points to set fade-in and fade-out. Memory Vortex Beats adds sound effects at key beats. Dragging a selection shows an alignment guide and snaps the group without changing clip spacing.
- - **2026-11-09** — Added two editable beat templates. 3D Perspective Beats uses four opening strips and 16 independently replaceable picture-in-picture cards. Memory Vortex Beats assembles a stained-glass tunnel from the 48 slots’ photos or video stills, then plays those shots in full. Desktop Color Wheels now includes an RGB parade for checking graded SDR levels. Offline 4K export loads active media on demand and reduces memory pressure when writing large MP4 and MOV files.
- - **2026-11-08** — Drag either handle in the Replace Clip dialog to adjust its source boundary, or drag the selected range to move it without changing its length or playback speed. The close icon stays centered on desktop and mobile. The properties panel follows the selected clip in the timeline and preview, and picture-in-picture settings scroll through the available panel height. Visual clip selections are outlined in the preview, and diamonds mark keyframe times on Visuals and Overlay clips. VFX lane labels fit the sidebar, and dragging the playhead uses a lighter effects preview. Added Spinning Cards, an editable square template with a four-suit neon intro, ten replaceable beat cuts and a tempo-matched soundtrack. Drag a diamond on a Visuals or Overlay clip to retime that keyframe. Spinning Cards can now display photos or video on each rotating suit. Four new editable templates add a seven-panel intro, neon film orbit, concentric ripple cuts, and staggered mask cuts. WebMCP can now preview and append beat templates, inspect timeline effects, and set mask transitions. The Timeline Studio Skill documents the workflow.
- - **2026-11-07** — Added a Templates workspace after Special Effects. Use your own pictures, video and optional music in the editable three-panel montage, and set its tempo before adding it to the timeline. Halftone and multi-panel preview now play more smoothly. The template settings are in the right inspector, with a built-in soundtrack that follows the BPM. Right-click a main or picture-in-picture clip to replace it with a selected range from another source while keeping its timeline timing. Preview decodes the next shot and upcoming picture-in-picture clips ahead of their cuts for smoother playback. The replacement dialog shows thumbnail cards, a custom horizontal scrollbar for more than four assets, and the playback rate needed to fit the selected source range.
- See the public [Roadmap](ROADMAP.md) for planned work, [Releases](https://github.com/MartinDelophy/ai-video-editor/releases) for shipped changes, and [Issues](https://github.com/MartinDelophy/ai-video-editor/issues) for focused tasks and bugs.
- ## What can it produce?
- Explore reproducible before/after examples and editing recipes:
- → [AI Video Editing Skills Handbook](https://github.com/MartinDelophy/timeline-studio-handbook)
- <p align="center">
- <a href="https://trendshift.io/repositories/77422?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-77422" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/77422/daily?language=JavaScript" alt="MartinDelophy%2Fai-video-editor | Trendshift" width="250" height="55"/></a>
- <a href="https://trendshift.io/repositories/77422?utm_source=trendshift-badge&utm_medium=badge&utm_campaign=badge-trendshift-77422" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/trendshift/repositories/77422/weekly?language=JavaScript" alt="MartinDelophy%2Fai-video-editor | Trendshift" width="250" height="55"/></a>
- </p>
- Timeline Studio is a local-first AI video editor that runs in the browser. It combines a CapCut-style multi-track timeline with WebGPU AI music and repair, multilingual voiceovers, automatic captions, talking-avatar generation, and deterministic offline export.
- [Open the editor](https://video-editor.ai-creator.top/) · [Watch on YouTube](https://youtu.be/bqKhpPPa-qo) · [Hugging Face Space](https://huggingface.co/spaces/haixin/timeline-studio)
- ## Video demo
- ### Codex edits a three-panel beat template
- Codex proposes a three-panel beat edit through WebMCP. Review and apply the plan, adjust a picture-in-picture keyframe by hand, and export the result. This 37-second demo uses Chinese narration generated locally in Timeline Studio.
- https://github.com/user-attachments/assets/b290de2c-4ca8-46c2-b099-cb9d7f231fcb
- ### Auto Edit
- Visual analysis, keyframes, captions, and export.
- https://github.com/user-attachments/assets/e8327caa-429e-40ff-a7fe-a59e6cf7a464
- ### AI Repair
- Timed watermark removal with before/after review.
- https://github.com/user-attachments/assets/aea9f5b4-c720-4b0c-9067-5ec124eef982
- ### AI Voiceover
- https://github.com/user-attachments/assets/304a744e-d620-4380-9c17-19af3726f5a4
- 
- ## AI capabilities
- - **Multilingual voiceover:** Chinese and mixed Chinese/English Hojo TTS Light 80M FP16 reference voices (晴岚 and 若溪), with autoregressive generation on WebGPU and stable waveform decoding on WASM; English Kokoro 82M; and browser Piper voices for German, Spanish, French, Italian, and Brazilian Portuguese.
- - **Local AI music:** Stable Audio 3 Small Q4 ONNX runs through WebGPU with translated free-form prompts, 30/60/90/120-second choices, waveform-aware long-track looping, persistent model caching, and automatic insertion into My Assets.
- - **Automatic captions:** Whisper small q8 ONNX with waveform-aware timing and conservative Chinese recognition cleanup.
- - **Smart framing:** YOLOS tiny subject detection and MODNet portrait matting for smart crop, caption avoidance, and background removal across images and complete videos.
- - **AI Repair:** browser-local MI-GAN watermark/object removal with multiple timed repair regions, plus NanoVSR 644K WebGPU 4× restoration for images and videos with synchronized before/after comparison.
- - **AI vocal separation:** isolate vocals and place the instrumental stem on the music track without leaving the browser workflow.
- - **Digital human:** JoyVASA audio-to-motion and LivePortrait neural rendering with WebGPU, 256px preview and 512px quality paths.
- - **Local-first inference:** large models are lazy-loaded, revision-pinned, and cached by the service worker; supported workflows run without uploading project media to an editing backend.
- ## Resilient model delivery
- Browser AI models are mirrored on both Hugging Face and ModelScope. Timeline Studio uses ModelScope first for Chinese interfaces and domestic sessions, uses Hugging Face first elsewhere, remembers the first working source for the current runtime, and automatically falls back to the other source when needed. Cache identities are shared across both providers, so switching routes does not download the same revision twice.
- - Stable Audio: [Hugging Face](https://huggingface.co/haixin/stable-audio-3-small-music-onnx) · [ModelScope](https://www.modelscope.cn/models/martindelophy/stable-audio-3-small-music-onnx/files?version=main)
- - Voice models: [Hugging Face](https://huggingface.co/haixin/timeline-studio-voice-models/tree/074a57bc4dac9c58568b031898ea79da6f36b282) · [ModelScope](https://www.modelscope.cn/models/martindelophy/timeline-studio-voice-models/files?version=9cb5ab964c014b182701153bd00f7a2202f5dce8) (mixed upstream licenses; see the repository model card)
- - Timeline Studio ONNX models: [Hugging Face](https://huggingface.co/haixin/timeline-studio-onnx-models) · [ModelScope](https://www.modelscope.cn/models/martindelophy/timeline-studio-onnx-models/files?version=main)
- - Depth Anything V2 Small Q4F16: [Hugging Face](https://huggingface.co/haixin/timeline-studio-onnx-models/tree/a0806c6fb9484894dcb78df523156d244461515d/depth-anything-v2-small) · [ModelScope](https://www.modelscope.cn/models/martindelophy/timeline-studio-onnx-models/files?version=4cc757f80330e22cb8f82b628c53ceca6307fd12&subpath=depth-anything-v2-small) (Apache-2.0)
- - Vocal remover: [Hugging Face](https://huggingface.co/haixin/timeline-studio-vocal-remover) · [ModelScope](https://www.modelscope.cn/models/martindelophy/timeline-studio-vocal-remover/files?version=main)
- ## Editing and export
- - Contiguous main Visuals track plus timed picture-in-picture overlays.
- - Direct canvas selection, movement, proportional resize, rotation, masks, filters, effects, animation, speed, and explicit keyframes, plus desktop four-way color grading with fully keyframeable temperature, tint, saturation, hue, wheel saturation, and luminance controls.
- - Captions, stickers, voiceover, separated source audio, and music on independent timed tracks.
- - CapCut-style snapping, alignment guides, clip menus, split/duplicate/delete, timeline zoom, undo/redo, and portable `.timeline` projects.
- - Native media playback for a responsive preview; export uses a separate deterministic offline rendering path.
- - WebCodecs MP4/WebM composition with shared preview/export geometry, audio mixing, captions, overlays, effects, and MediaRecorder fallback.
- - Installable PWA with a cached app shell and multilingual UI.
- ## Agent Skill
- The repository includes the [AI Video Editing Skill for Codex, Claude Code, Copilot and Gemini CLI](skills/edit-timeline-studio/README.md), backed by [`edit-timeline-studio`](skills/edit-timeline-studio/SKILL.md) for planning, executing, and verifying editable video timelines.
- It helps an agent:
- - inspect media and preserve the user's editing brief;
- - describe reversible edits with stable clip IDs and explicit timestamps;
- - operate the hosted or local editor through the browser compatibility path;
- - validate declarative edit plans with `skills/edit-timeline-studio/scripts/validate_edit_plan.mjs`;
- - verify track placement, transitions, captions, overlays, audible audio, and final export artifacts;
- - keep the editable `.timeline` project as the source of truth instead of returning only an opaque render.
- The versioned headless command runner loads and inspects portable projects, validates revisioned JSON plans, applies supported operations transactionally, supports dry runs and idempotent operation IDs, and writes a new `.timeline` archive without rewriting its media files. It also renders the documented portable Visuals + Voiceover + Music subset to a verified H.264/AAC MP4. Browser control remains the compatibility path for operations that are not in the command registry yet. The [browser WebMCP integration](docs/webmcp.md) provides 21 tools for the open project: structured inspection, 26 reviewed visual/caption/audio/marker/framing operations, existing-asset and picture-in-picture insertion, rendered frame/audio sampling, local voiceover/transcription jobs, guarded undo, project saving, and real video export with prepared settings, progress, output receipts and cancellation.
- ```bash
- npm run agent -- project.inspect /absolute/path/project.timeline
- npm run agent -- track.inspect /absolute/path/project.timeline visuals
- npm run agent -- clip.inspect /absolute/path/project.timeline visual-123
- npm run agent -- transcript.inspect /absolute/path/project.timeline voice-123
- npm run agent -- project.diff /absolute/path/edit-plan.json
- npm run agent -- project.run /absolute/path/edit-plan.json
- npm run agent -- project.render /absolute/path/render-request.json
- ```
- The legacy `inspect` and `run` aliases remain available. The write registry supports ffprobe-backed, hashed visual/audio import to Visuals, Music, or the portable Voiceover slot, plus transactional timed edits, captions, source-accurate Visuals/Overlays, transitions, validated properties, track state, and ratio changes. Read commands return project, track, clip, transcript, media-inventory, and field-level predicted diffs. See the [command contract](skills/edit-timeline-studio/references/command-contract.md) for the plan envelope.
- Install through the public [skills.sh](https://skills.sh/MartinDelophy/ai-video-editor) directory (the current CLI requires Node.js 22.20.0 or later):
- ```bash
- npx skills add MartinDelophy/ai-video-editor --skill edit-timeline-studio
- ```
- Or install it with GitHub CLI 2.90.0 or later:
- ```bash
- # Claude Code
- gh skill install MartinDelophy/ai-video-editor edit-timeline-studio --agent claude-code --scope user
- # Codex
- gh skill install MartinDelophy/ai-video-editor edit-timeline-studio --agent codex --scope user
- ```
- To install the tested release instead of following the latest release, add `--pin v1.0.8`. Preview the Skill before installing with:
- ```bash
- gh skill preview MartinDelophy/ai-video-editor edit-timeline-studio
- ```
- ## Roadmap
- - **Now:** expand the versioned command registry, harden deterministic offline export, and improve timeline editing reliability.
- - **Next:** expand headless render parity and the reviewed browser WebMCP command subset.
- - **Later:** add collaborative review workflows, a plugin extension surface, and more locally verified AI models.
- Roadmap priorities are shaped in [GitHub Discussions](https://github.com/MartinDelophy/ai-video-editor/discussions). Feature requests and real-world workflow feedback are welcome.
- ## Help wanted
- Timeline Studio is looking for contributors interested in browser media, WebCodecs, WebGPU/ONNX, timeline UX, localization, testing, and documentation.
- - Try the [live editor](https://video-editor.ai-creator.top/) and report reproducible bugs in [Issues](https://github.com/MartinDelophy/ai-video-editor/issues).
- - Join [Discussions](https://github.com/MartinDelophy/ai-video-editor/discussions) to propose features, share projects, or help prioritize the roadmap.
- - Read the [contribution guide](CONTRIBUTING.md) for setup, validation, and first-contribution guidance.
- - Contributions of focused fixes, tests, translations, documentation, and example projects are especially useful.
- ## Quick start
- Requirements: Node.js 20+ and a modern Chromium browser. WebGPU is recommended for the heaviest AI workflows.
- ```bash
- git clone https://github.com/MartinDelophy/ai-video-editor.git
- cd ai-video-editor
- npm install
- npm run dev
- ```
- Open the local URL printed by Vite. The first AI run may download model files; later runs reuse the browser cache.
- ## Validate and build
- ```bash
- npm run build
- npm run preview
- ```
- Run the complete repository check with:
- ```bash
- npm run check
- ```
- ## Deploy
- The included [`netlify.toml`](netlify.toml) builds with `npm run build`, publishes `dist`, enables the cross-origin isolation headers required by browser AI/media workers, and provides the SPA fallback.
- ```bash
- npx netlify-cli deploy --prod --dir=dist
- ```
- ## Support and feedback
- If this project helps you, please consider giving it a ⭐ Star. If you encounter a problem, please [open an Issue](https://github.com/MartinDelophy/ai-video-editor/issues).
- Join our [Discord community](https://discord.gg/uq2uvUTBr) to ask questions, share feedback, and connect with other users and contributors.
- ## License
- Timeline Studio's original source code is licensed under the [MIT License](LICENSE).
- The MIT License does **not** automatically apply to third-party models, model
- weights, datasets, fonts, stock media, or other bundled or remotely downloaded
- assets. Those materials remain subject to their respective upstream licenses
- and terms, regardless of where they are hosted or how they are downloaded or
- integrated. Review [MODEL_LICENSES.md](MODEL_LICENSES.md) before redistribution
- or commercial use.
- ## Star History
- <a href="https://www.star-history.com/?repos=MartinDelophy/ai-video-editor">
- <picture>
- <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=MartinDelophy/ai-video-editor&type=date&theme=dark&legend=top-left" />
- <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=MartinDelophy/ai-video-editor&type=date&legend=top-left" />
- <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=MartinDelophy/ai-video-editor&type=date&legend=top-left" />
- </picture>
- </a>
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.