diff --git a/README.md b/README.md index 29bfeef..05f0790 100644 --- a/README.md +++ b/README.md @@ -9,15 +9,14 @@ The open-source AI video editor for Claude Code and any MCP client: remove silen

skills.sh + npm weekly downloads License: MIT Node 24+ - npm Tests: 859 passing - Telemetry: none

- MakeMyClip Editor — chat-driven video editing demo (real screencast coming soon) + Chat with your video editor: a request to cut the pauses and add captions, the reply, and the editor's monitor and timeline

**MakeMyClip Editor is a free, open-source (MIT) video editor that AI agents drive.** You ask Claude to edit a recording; it calls the editor's tools, and FFmpeg and a local whisper.cpp do the work on your computer. It ships as a Claude Code skill, the `clip` CLI, an MCP server, and a browser timeline editor. No cloud upload, no account, no API key, no telemetry, no generative AI. @@ -85,7 +84,7 @@ clip ui # opens http://127.0.0.1:5573 Put your videos in the extension's **Media folder** (by default `Documents/MakeMyClip`); the editor reads and writes only there. The extension doesn't include FFmpeg (see [License](#license)): it finds the one Homebrew, MacPorts, winget, Scoop or Chocolatey installed, or you pick it in the extension's settings, along with the optional whisper model. -**As an MCP server** (drive it from Claude Desktop / Cursor / any MCP client — no API key, on your existing Claude): +**As an MCP server** (drive it from Claude Desktop / Cursor / Codex / any MCP client — no API key, on the plan you already have): ```jsonc // claude_desktop_config.json → "mcpServers" @@ -101,6 +100,15 @@ Put your videos in the extension's **Media folder** (by default `Documents/MakeM } ``` +Codex (the CLI and the IDE extension) reads the same server from `~/.codex/config.toml`: + +```toml +[mcp_servers.makemyclip-editor] +command = "npx" +args = ["-y", "@makemyclip/editor", "mcp"] +env = { MAKEMYCLIP_WORKSPACE = "/path/to/your/media", MAKEMYCLIP_WHISPER_MODEL = "/path/to/ggml-base.en.bin" } +``` + It is listed in the [official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.MakeMyClip/editor) as `io.github.MakeMyClip/editor`, so MCP clients that browse the registry can install it from there. The Claude Code skill auto-discovers triggers and shells out via `npx -y` on demand. The MCP server exposes the timeline tools (show / edit / check / transcribe / undo / redo / export) and a `doctor` setup check over stdio; media stays confined to `MAKEMYCLIP_WORKSPACE`, and `MAKEMYCLIP_WHISPER_MODEL` is only needed for transcription and captions. Everything runs locally and offline — no API key. **Optional: local transcription** (for editing by transcript, removing retakes, and captions): @@ -187,6 +195,10 @@ Plus four meta-ops not in the registry: `snapshot`, `undo`, `inspect`, `delete`. The browser UI is a dark timeline editor: drag-drop import, a monitor (the composited frame at the playhead), an editable timeline (select a clip to trim / split / move / transition / remove, frame it (fill, zoom, position), cut its silences, or cut words and retakes from its transcript), the output shape (16:9, 9:16, 1:1 or 4:5) and loudness, captions from transcripts, one-click export (an mp4, or a project for Final Cut Pro, DaVinci Resolve or Premiere Pro), timeline undo/redo, snapshot, and keyboard shortcuts. +

+ The browser editor: imported clips, the monitor showing a captioned frame, and a timeline with video, title and caption tracks +

+ --- ## Why it exists diff --git a/docs/hero.png b/docs/hero.png index c95f5bf..d8d7c0b 100644 Binary files a/docs/hero.png and b/docs/hero.png differ diff --git a/docs/social-preview.jpg b/docs/social-preview.jpg new file mode 100644 index 0000000..422b696 Binary files /dev/null and b/docs/social-preview.jpg differ diff --git a/docs/ui-screenshot.jpg b/docs/ui-screenshot.jpg new file mode 100644 index 0000000..ba27828 Binary files /dev/null and b/docs/ui-screenshot.jpg differ diff --git a/src/ui/web/src/App.tsx b/src/ui/web/src/App.tsx index 8092dda..8f57d75 100644 --- a/src/ui/web/src/App.tsx +++ b/src/ui/web/src/App.tsx @@ -1,4 +1,4 @@ -import { useState } from 'react'; +import { useMemo, useState } from 'react'; import { ClipInspector } from './components/ClipInspector.js'; import { DetailPane } from './components/DetailPane.js'; import { DocTimeline } from './components/DocTimeline.js'; @@ -23,7 +23,7 @@ import { useKeyboardShortcuts } from './hooks/useKeyboardShortcuts.js'; import { useSession } from './hooks/useSession.js'; import { useSessionSafety } from './hooks/useSessionSafety.js'; import { useTimeline } from './hooks/useTimeline.js'; -import { findClip, nextClipOnTrack } from './lib/composition.js'; +import { findClip, mediaNames, nextClipOnTrack } from './lib/composition.js'; import { applyTimelineVerbs, type Verb } from './lib/verbs.js'; export function App() { @@ -42,6 +42,7 @@ export function App() { const selectedEntry = selectedId === null ? null : (session.entries.find((e) => e.id === selectedId) ?? null); const selected = selectedClipId === null ? null : findClip(composition, selectedClipId); + const names = useMemo(() => mediaNames(session.entries), [session.entries]); // Selecting an op and selecting a doc-clip are mutually exclusive — each owns // the inspector pane, so picking one clears the other. @@ -224,6 +225,7 @@ export function App() { ; playheadSec: number; hasNext: boolean; /** The timeline's fit, which a clip without its own follows. */ @@ -84,7 +87,7 @@ export function ClipInspector({
-

{clipLabel(clip)}

+

{clipLabel(clip, mediaNames)}

{clip.kind} · {clip.id} · {start.toFixed(2)}–{end.toFixed(2)}s ( {clipDuration(clip).toFixed(2)}s) diff --git a/src/ui/web/src/components/DocTimeline.tsx b/src/ui/web/src/components/DocTimeline.tsx index fe1f4dd..44b8158 100644 --- a/src/ui/web/src/components/DocTimeline.tsx +++ b/src/ui/web/src/components/DocTimeline.tsx @@ -21,6 +21,7 @@ const MAX_THUMBS = 16; // cap thumbnails per clip to bound requests */ export function DocTimeline({ composition, + mediaNames, selectedClipId, onSelectClip, playheadSec, @@ -33,6 +34,8 @@ export function DocTimeline({ verbError, }: { composition: Composition; + /** File name of each media id, for labeling media clips. */ + mediaNames: ReadonlyMap; selectedClipId: string | null; onSelectClip: (clipId: string | null) => void; playheadSec: number; @@ -156,6 +159,7 @@ export function DocTimeline({ @@ -205,10 +209,12 @@ export function DocTimeline({ function ClipBlock({ clip, + label, selected, onSelect, }: { clip: Clip; + label: string; selected: boolean; onSelect: (clipId: string | null) => void; }) { @@ -220,10 +226,10 @@ function ClipBlock({ className={`doc-tl-clip doc-tl-clip-${clip.kind}${selected ? ' selected' : ''}`} style={{ left, width }} onClick={() => onSelect(selected ? null : clip.id)} - title={`${clipLabel(clip)} · ${clip.startSec.toFixed(2)}–${clipEndSec(clip).toFixed(2)}s`} + title={`${label} · ${clip.startSec.toFixed(2)}–${clipEndSec(clip).toFixed(2)}s`} > {clip.kind === 'media' ? : null} - {clipLabel(clip)} + {label} {clipDuration(clip).toFixed(1)}s ); diff --git a/src/ui/web/src/lib/composition.ts b/src/ui/web/src/lib/composition.ts index fe0f2f3..9576d7a 100644 --- a/src/ui/web/src/lib/composition.ts +++ b/src/ui/web/src/lib/composition.ts @@ -1,4 +1,5 @@ -import type { Clip, Composition, Track } from '../types.js'; +import type { Clip, Composition, SessionEntry, Track } from '../types.js'; +import { shortName } from './playable-clips.js'; // Frontend mirror of the doc geometry helpers in src/timeline/composition.ts. // The timeline view positions clips by their DOCUMENT extent (startSec + @@ -23,9 +24,25 @@ export function compositionDuration(comp: Composition): number { return end; } -/** Short, human-readable label for a clip on the timeline. */ -export function clipLabel(clip: Clip): string { - if (clip.kind === 'media') return clip.mediaId; +/** File name of each ingested media id, read from the session log's `ingest` + * entries (`{ mediaId, ref: { path } }`) — the same registry export resolves + * media through. */ +export function mediaNames(entries: SessionEntry[]): Map { + const names = new Map(); + for (const entry of entries) { + if (entry.tool !== 'ingest') continue; + const { mediaId, ref } = entry.result as { mediaId?: unknown; ref?: { path?: unknown } }; + if (typeof mediaId === 'string' && typeof ref?.path === 'string') { + names.set(mediaId, shortName(ref.path)); + } + } + return names; +} + +/** Short, human-readable label for a clip on the timeline. A media clip shows its + * file name, or its media id when the session log doesn't name it. */ +export function clipLabel(clip: Clip, names: ReadonlyMap): string { + if (clip.kind === 'media') return names.get(clip.mediaId) ?? clip.mediaId; if (clip.kind === 'text') return `“${clip.text.slice(0, 20)}”`; return `color · ${clip.color}`; } diff --git a/src/ui/web/src/lib/playable-clips.ts b/src/ui/web/src/lib/playable-clips.ts index e34955b..a9452f5 100644 --- a/src/ui/web/src/lib/playable-clips.ts +++ b/src/ui/web/src/lib/playable-clips.ts @@ -26,7 +26,7 @@ function isVideoPath(path: string): boolean { return VIDEO_EXT.has(ext); } -function shortName(path: string): string { +export function shortName(path: string): string { const base = path.split('/').pop() ?? path; // Strip the 8-char random prefix (`xxxxxxxx-`) that we add to import // filenames and tool outputs, so cards show "demo.mp4" instead of diff --git a/src/ui/web/src/styles.css b/src/ui/web/src/styles.css index 2c1767f..94d3213 100644 --- a/src/ui/web/src/styles.css +++ b/src/ui/web/src/styles.css @@ -186,6 +186,14 @@ body, } .op-list .op { + /* Each op is a