vbase
VBASE: an AI video editing studio for Claude Code. Raw take in, edited video out.
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 19 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/ekanshvcpkg/VBASE 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/ekanshvcpkg/VBASE'
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/ekanshvcpkg--vbase)HTML
<a href="/listings/ekanshvcpkg--vbase"><img src="/api/listings/ekanshvcpkg--vbase/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.
**1. Install** — paste into your terminal:
claude plugin marketplace add ekanshvcpkg/VBASE && claude plugin install vbase@vbase
**2. Set up** — once, inside Claude Code (about 5–10 minutes):
/vbase:setup
**3. Edit** — any video:
/vbase:edit ~/Downloads/take.mov
You get `take-vbase.mp4` next to your video, and the VBASE review room opens in your browser at `http://localhost:4400`.
<details> <summary>Prefer installing from inside Claude Code?</summary>
Run these one at a time:
/plugin marketplace add ekanshvcpkg/VBASE
/plugin install vbase@vbase
</details>
> [!TIP] > You can also just talk to Claude: *"edit ~/Downloads/take.mov with vbase, make it vertical, my name is Ada"*. > Then run `/vbase:review ~/Downloads/take.mov` to pin notes on frames and get the next take.
<sub>The walkthrough above is illustrated; the setup table and stage results are real output from a VBASE test run.</sub>
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.
.claude-plugin/marketplace.json · Manifest · 15 lines
- {
- "name": "vbase",
- "description": "VBASE: an AI video editing studio for Claude Code. Raw take in, edited video out.",
- "owner": {
- "name": "Ekansh",
- "url": "https://github.com/ekanshvcpkg"
- },
- "plugins": [
- {
- "name": "vbase",
- "source": "./",
- "description": "AI video editing studio for Claude Code: raw take in, edited video out."
- }
- ]
- }
README.md · README · 191 lines
- <div align="center">
- <img src="docs/images/vbase-logo.svg" width="72" alt="VBASE">
- # VBASE
- **Raw take in. Edited video out.**<br>
- A Claude Code plugin that edits your talking-head videos: word-timed cuts, captions, 3D objects in your hands,<br>graphics that live behind you, a 3D buddy that joins in, music made in code, and a review room for your notes.
- [](#install)
- [](LICENSE)
- [](#requirements)
- <img src="docs/images/vbase-review-room.png" width="860" alt="The VBASE review room: a video player with a timeline and a comments panel with pinned notes">
- <sub>The VBASE review room: pin notes on exact frames, then send them to Claude for the next take.</sub>
- </div>
- ---
- > **A starting point, not a black box.** VBASE gets a raw take to a polished first cut on its own, then you steer it:
- > pin notes on frames in the review room and every note becomes the next take. Everything is plain scripts and
- > React scenes in this repo, so you can change any part of it. Its own launch video was edited this way, over 16 takes.
- ## Quick start
- <img src="docs/images/vbase-install.gif" width="860" alt="Terminal walkthrough: add the VBASE marketplace, install the plugin, run setup, then edit a video">
- **1. Install** — paste into your terminal:
- ```bash
- claude plugin marketplace add ekanshvcpkg/VBASE && claude plugin install vbase@vbase
- ```
- **2. Set up** — once, inside Claude Code (about 5–10 minutes):
- ```text
- /vbase:setup
- ```
- **3. Edit** — any video:
- ```text
- /vbase:edit ~/Downloads/take.mov
- ```
- You get `take-vbase.mp4` next to your video, and the VBASE review room opens in your browser at `http://localhost:4400`.
- <details>
- <summary>Prefer installing from inside Claude Code?</summary>
- Run these one at a time:
- ```text
- /plugin marketplace add ekanshvcpkg/VBASE
- ```
- ```text
- /plugin install vbase@vbase
- ```
- </details>
- > [!TIP]
- > You can also just talk to Claude: *"edit ~/Downloads/take.mov with vbase, make it vertical, my name is Ada"*.
- > Then run `/vbase:review ~/Downloads/take.mov` to pin notes on frames and get the next take.
- <sub>The walkthrough above is illustrated; the setup table and stage results are real output from a VBASE test run.</sub>
- ## What it does
- | | |
- |---|---|
- | **Cuts that sound human** | Word-level timing (WhisperX) plus speech detection (Silero VAD). Pauses are compressed, not chopped; fumbles, filler and tangents go. |
- | **Captions** | Word-by-word, highlighted on the words that matter, kept clear of panels. |
- | **3D in your hands** | A real WebGL object (pebbled leather, seams, room lighting, motion blur) tracked to your palms with MediaPipe, thrown and caught. |
- | **Camera moves** | Spring-eased push-ins and pull-outs, jump-zoom punches, whip pans, zoom-blur transitions. |
- | **Graphics behind you** | Glass cards, chips and whole screens (a GitHub page, an app) sit in the room *behind* you: a clean cut-out of you (Robust Video Matting) goes on top, and each element is placed in the free wall beside your head, never on your face. |
- | **A 3D buddy that joins in** | An original clay character that peeks in from the corners, runs across the room, hugs a title card, stomps the Star button on your repo and presses the call-to-action on the end card. |
- | **Floating windows** | Screen recordings and code open as angled 3D windows on the side you point to. |
- | **A clone of you** | Your own cut-out, placed behind you with a cast shadow and light wrap, appearing on the word you say. |
- | **Proof, not decoration** | Scenes show real output: a grid of frames from the edit, raw vs edited side by side, the actual numbers of the run. |
- | **Open + end card** | Built with [Take One](https://github.com/talsiach/take-one): a raw-to-edit wipe under your voice from frame 0, your name, and an end card with a call to action. |
- | **Studio audio** | Neural denoise (DeepFilterNet), vocal chain, two-pass loudness to −14 LUFS. |
- | **Music and sound, made in code** | An original under-voice music bed composed in code and fitted to the exact length (free, no licence worries), kept low and steady; quiet pop sounds only where something appears, on its exact frame. |
- | **Hand-off** | An OpenTimelineIO timeline (`.otio`) to keep editing in DaVinci Resolve or Premiere. |
- ## The review room
- <img src="docs/images/vbase-review-room.gif" width="860" alt="Pinning a note on a frame, leaving a whole-film note, resolving a note and sending notes to Claude in the VBASE review room">
- It opens by itself after every edit at `http://localhost:4400` (or run `/vbase:review ~/Downloads/my-take.mov`). Click any frame to pin a note, filter open and resolved notes, then press **Send notes to Claude**. Claude reads every note with its snapshot and answers it in the next take. It runs only on `localhost`; nothing is uploaded.
- ## How it works
- ```mermaid
- flowchart LR
- A[Raw video] --> B[Analyze<br/>WhisperX · Silero VAD<br/>auto-editor · PySceneDetect]
- B --> C[Claude directs<br/>edit plan + EDL]
- C --> D[Cut · grade · audio<br/>FFmpeg · DeepFilterNet]
- D --> E[In-footage FX<br/>zoom · clone · hands]
- E --> M[Speaker cut-out<br/>Robust Video Matting]
- M --> F[3D + captions<br/>Remotion · Three.js]
- F --> G[Open + end card<br/>Take One]
- G --> H[QC → my-take-vbase.mp4]
- H --> I[Review room<br/>notes → next take]
- I -.-> C
- ```
- Claude writes the creative decisions (the hook, what to cut, which scenes, which words to highlight) into an edit decision list; the scripts do the frame-accurate arithmetic. A self-review pass checks loudness, black frames, text size and composition before you see anything.
- ## Commands
- | Command | What it does |
- |---|---|
- | `/vbase:setup [--check]` | Install or check dependencies. |
- | `/vbase:edit <video> [notes]` | Edit a video end to end. Add notes in plain words: *"make it vertical"*, *"my name is Ada"*, *"no open"*. |
- | `/vbase:review <video>` | Open the review room and turn your notes into the next take. |
- You can also just ask: *"edit ~/Downloads/take.mov with vbase"*.
- <details>
- <summary><b>Options</b> (Claude sets these from what you say; you can too)</summary>
- | Env | Effect |
- |---|---|
- | `ZOOM_WORD=zoom` | Camera pushes in on the word's first use, pulls out on its second. |
- | `CLONE_AT=<seconds> CLONE_WORD=<word>` | A clone cut from that moment of the raw take appears behind you on that word. |
- | `BRAND`, `LINE1`, `LINE2`, `TAGLINE`, `END1`, `END2`, `CTA`, `FOOT` | Words of the open and end card. |
- | `MUSIC=code` | Compose VBASE's own background bed in code: free, fitted to the exact length, at one steady, low level under your voice. |
- | `SFX=1` | Quiet pop sounds only where a visual pops in, timed to its frame and tuned to the bed (off by default). |
- | `VBASE_GRADE=natural` | Keep the camera's own colours (no colour grade). |
- | `MUSIC_FILE=track.mp3` | Your own background music at one steady, low level under your voice (`MUSIC_LUFS`, default −44). |
- | `TAKEONE=0` | Skip the open and end card. |
- </details>
- ## Requirements
- - **Claude Code**
- - **macOS** (tested on Apple silicon). Linux should work but is untested.
- - **Homebrew**, plus a Chromium browser for rendering: **Google Chrome, Brave, Edge or Chromium**.
- - About **5 GB** of disk for models and tools. Setup installs: ffmpeg, Node, uv, auto-editor, Python 3.11 tools (WhisperX, Silero VAD, PySceneDetect, OpenTimelineIO), MediaPipe models, the Robust Video Matting model, DeepFilterNet and Take One.
- No paid API is needed. Music and voice from ElevenLabs are optional and off unless you add a key.
- ## Project layout
- ```text
- .claude-plugin/ plugin.json, marketplace.json
- commands/ /vbase:edit, /vbase:setup, /vbase:review
- skills/vbase/ the editing skill: stages, scene library, Remotion template, scripts
- pipeline/ in-footage FX, editor FX timeline, Take One finish, OTIO export
- review-room/ the VBASE review room (local server + page)
- scripts/ setup.sh (one-time install), run.sh (analyze / render / review)
- ```
- ## Honest limits
- - It edits one continuous talking-head take best. Multi-camera footage and B-roll libraries are not supported yet.
- - The 3D object rests on your palm; your fingers do not wrap in front of it.
- - Effects such as the clone and the zoom need you to say the trigger words, so they appear where you talk about them.
- - The first take is a strong start, not a final cut: expect a few rounds of notes in the review room.
- - Elements behind you need a clear outline of you; very busy backgrounds or people walking behind you make the cut-out less clean.
- - Rendering a 1-minute video takes a few minutes on an M-series Mac.
- ## Credits
- VBASE stands on excellent open-source work. It installs these from their own sources; none are redistributed here.
- | Project | Used for | License |
- |---|---|---|
- | [WhisperX](https://github.com/m-bain/whisperX) | word-level timestamps | BSD-2-Clause |
- | [Silero VAD](https://github.com/snakers4/silero-vad) | speech detection | MIT |
- | [auto-editor](https://github.com/WyattBlue/auto-editor) | silence pass | Unlicense |
- | [PySceneDetect](https://github.com/Breakthrough/PySceneDetect) | scene cuts | BSD-3-Clause |
- | [OpenTimelineIO](https://github.com/AcademySoftwareFoundation/OpenTimelineIO) | timeline export | Apache-2.0 |
- | [FFmpeg](https://github.com/FFmpeg/FFmpeg) | cutting, grading, audio | LGPL/GPL |
- | [Take One](https://github.com/talsiach/take-one) | open, end card, audits, sound | MIT |
- | [Remotion](https://www.remotion.dev) + [Three.js](https://threejs.org) | 3D scenes and captions | [Remotion License](https://www.remotion.dev/license) (free for individuals and small teams) · MIT |
- | [MediaPipe](https://github.com/google-ai-edge/mediapipe) | hand tracking, face boxes | Apache-2.0 |
- | [Robust Video Matting](https://github.com/PeterL1n/RobustVideoMatting) | speaker cut-out (elements behind you) | GPL-3.0 (model downloaded by setup, not redistributed) |
- | [DeepFilterNet](https://github.com/Rikorose/DeepFilterNet) | denoise | MIT / Apache-2.0 |
- | [video-use](https://github.com/browser-use/video-use) | editing rules that shaped the cut | MIT |
- Take One renders through Chrome only by default; `setup.sh` applies a one-line patch so it can use any Chromium browser (`CHROME_PATH`).
- ## License
- [MIT](LICENSE) © Ekansh
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.