Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
44 commits
Select commit Hold shift + click to select a range
11926b1
fix(timeline): refuse colors that are not colors before they reach FF…
yultyyev Nov 15, 2026
df882f2
feat(timeline): add named timelines and make_short
yultyyev Nov 15, 2026
13adac9
fix(timeline): keep padding-only and replayed padding out of shorts
yultyyev Nov 15, 2026
b6688cb
docs(docs): describe shorts in the README, SKILL.md and llms.txt
yultyyev Nov 15, 2026
bc8e1d9
fix(timeline): tune short edges to whisper.cpp's word timing
yultyyev Nov 15, 2026
7dec1b1
fix(timeline): confine timeline folders and caption only the chosen w…
yultyyev Nov 15, 2026
638e0ff
fix(timeline): caption each piece of a short from its own range
yultyyev Nov 15, 2026
a2b0895
Merge pull request #73 from MakeMyClip/feat/timeline-shorts
yultyyev Nov 15, 2026
18c8cf0
perf(timeline): render a media frame from a short window of its source
yultyyev Nov 15, 2026
28529ff
fix(timeline): keep a sped-up clip on the canvas frame grid
yultyyev Nov 15, 2026
6488d7a
feat(timeline): outline a long recording as sentences
yultyyev Nov 15, 2026
7b3a321
Merge pull request #72 from MakeMyClip/fix/timeline-color-validation
yultyyev Nov 15, 2026
c7866bf
fix(timeline): seek frames down to the microsecond, keep replayed words
yultyyev Nov 15, 2026
390ad0c
fix(timeline): read a frame preview from a second before the frame
yultyyev Nov 16, 2026
d00188e
style(timeline): format the frame-plan test
yultyyev Nov 16, 2026
8d889cc
fix(timeline): take the canvas frame at or after an off-grid preview …
yultyyev Nov 16, 2026
59c957a
fix(timeline): keep a preview within the frames a segment encodes
yultyyev Nov 16, 2026
34b7f67
fix(timeline): keep held frames in previews, tie-safe outline pages
yultyyev Nov 16, 2026
9b8029d
fix(timeline): match export's frame timing tick for tick; outline ranges
yultyyev Nov 16, 2026
19e6220
fix(timeline): preroll slow-motion previews; end the sentence listing…
yultyyev Nov 16, 2026
c0feb62
Merge remote-tracking branch 'origin/feat/shorts' into feat/long-reco…
yultyyev Nov 16, 2026
7665a7f
feat(timeline): cut a short's edges in the pause the audio shows
yultyyev Nov 16, 2026
dabc615
fix(timeline): measure pauses on padded audio; keep pulled words in o…
yultyyev Nov 16, 2026
7d4da17
fix(ui): label media clips with their file name
yultyyev Nov 16, 2026
e876187
fix(ui): draw the op list in the dark theme
yultyyev Nov 16, 2026
c3a0a2d
fix(timeline): pause after the last word, not before; captions once, …
yultyyev Nov 16, 2026
59542e7
Merge pull request #84 from MakeMyClip/fix/op-list-dark-rows
yultyyev Nov 16, 2026
7c6110a
Merge pull request #78 from MakeMyClip/feat/long-recordings
yultyyev Nov 16, 2026
95cc72f
feat(timeline): keep captions inside the vertical feeds' safe area
yultyyev Nov 16, 2026
57b85dd
fix(timeline): fit caption lines by estimated width, shrink a too-wid…
yultyyev Nov 16, 2026
8f5f4b9
Merge pull request #83 from MakeMyClip/fix/ui-clip-file-names
yultyyev Nov 16, 2026
fc9d5cf
fix(timeline): keep the caption box inside the safe area; widen the e…
yultyyev Nov 16, 2026
f8cf02c
fix(timeline): count non-Latin letters at their widest
yultyyev Nov 16, 2026
7874b82
Merge remote-tracking branch 'origin/feat/shorts' into feat/caption-s…
yultyyev Nov 16, 2026
fe9ec3e
fix(timeline): count ASCII math signs at their width
yultyyev Nov 16, 2026
da5d65d
docs(docs): note caption width from font metrics as backlog
yultyyev Nov 16, 2026
6c94b5b
Merge pull request #85 from MakeMyClip/feat/caption-safe-zone
yultyyev Nov 16, 2026
95702ac
feat(ui): serve every timeline route for a named timeline, and export…
yultyyev Nov 16, 2026
d0fd45f
feat(ui): timeline tabs, Make short from the transcript, and Export a…
yultyyev Nov 16, 2026
41841ac
docs(docs): document export --all and shorts in clip ui
yultyyev Nov 16, 2026
4bb87a6
fix(ui): re-check each short's media in export-all, and tie missing t…
yultyyev Nov 16, 2026
bfd0839
Merge pull request #86 from MakeMyClip/feat/ui-shorts
yultyyev Nov 16, 2026
78aa9b2
docs(docs): update the test count and the Roadmap for 0.5.2
yultyyev Nov 16, 2026
72d3c31
ci(ci): release the shorts work as 0.5.2, a patch
yultyyev Nov 16, 2026
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
3 changes: 2 additions & 1 deletion .releaserc.json
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,8 @@
"preset": "angular",
"releaseRules": [
{ "type": "chore", "scope": "deps", "release": "patch" },
{ "type": "chore", "scope": "security", "release": "patch" }
{ "type": "chore", "scope": "security", "release": "patch" },
{ "type": "feat", "release": "patch" }
]
}
],
Expand Down
44 changes: 38 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ The open-source AI video editor for Claude Code and any MCP client: remove silen
<a href="https://www.npmjs.com/package/@makemyclip/editor"><img src="https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.npmjs.org%2Fdownloads%2Fpoint%2Flast-week%2F%40makemyclip%2Feditor&query=%24.downloads&label=npm&labelColor=CB3837&color=CB3837&logo=npm&logoColor=white" alt="npm weekly downloads"></a>
<a href="./LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="License: MIT"></a>
<a href="./package.json"><img src="https://img.shields.io/badge/node-%E2%89%A524-brightgreen" alt="Node 24+"></a>
<img src="https://img.shields.io/badge/tests-859%20passing-brightgreen" alt="Tests: 859 passing">
<img src="https://img.shields.io/badge/tests-965%20passing-brightgreen" alt="Tests: 965 passing">
</p>

<p align="center">
Expand Down Expand Up @@ -40,12 +40,13 @@ Version 0.5.0 turns a raw talking-head recording into a clean, captioned cut: ve
| **Captions** | Burned-in captions timed to the words, as short phrases or one word at a time | `clip timeline captions` |
| **Reframe** | Turns a landscape cut into 9:16, 1:1 or 4:5, filling the frame and choosing the part that shows; zoom and position per clip | `clip timeline reframe` |
| **Loudness** | Evens out the exported mp4's volume to a target (-14 LUFS for YouTube, Shorts, Reels and TikTok; -16 for podcasts), measured in two passes | `clip timeline loudness` |
| **Shorts from a long recording** | Turns ranges of words from a long recording into a vertical short on a timeline of its own: captioned, at -14 LUFS, with the cuts already made on the recording; the long cut stays as it is | `clip timeline short` |
| **Cut check** | Flags cuts where a word may be clipped, with a contact sheet of the frames on each side | `clip timeline check` |
| **Export to Final Cut Pro and DaVinci Resolve** | FCPXML 1.10 project | `clip timeline export --format fcpxml` |
| **Export to Premiere Pro** | Final Cut Pro 7 XML project, captions as `.srt` files | `clip timeline export --format xmeml` |
| **Render** | mp4 of the finished cut | `clip timeline export` |

All of it works from chat (the Claude Code skill or the MCP server), the CLI, and the browser UI; the cut check isn't in the UI yet. Every edit is one step on a non-destructive timeline that `undo` and `redo` walk through. Underneath sit [19 single-file FFmpeg tools](#all-19-tools) for everything else: trim, split, concat, transitions, text and title cards, zoom/pan, overlay, speed, color, chroma key, stabilize, and render.
All of it works from chat (the Claude Code skill or the MCP server), the CLI, and the browser UI; the cut check and shorts aren't in the UI yet. Every edit is one step on a non-destructive timeline that `undo` and `redo` walk through. Underneath sit [19 single-file FFmpeg tools](#all-19-tools) for everything else: trim, split, concat, transitions, text and title cards, zoom/pan, overlay, speed, color, chroma key, stabilize, and render.

---

Expand Down Expand Up @@ -157,6 +158,33 @@ A cut splits the clip into pieces: the first keeps its id, and `clip timeline sh

---

## Quick start: a long recording → vertical shorts

Each short is a timeline of its own, cut from the main timeline's clips, so the pauses and retakes you cut there stay cut. In Claude Code or Claude Desktop, ask:

> *Transcribe podcast.mp4 and cut the pauses. Then find the three strongest moments, 20 to 60 seconds each, and make each one a short.*

The same steps from the CLI:

```bash
clip timeline new
clip timeline add-media podcast.mp4 # prints the clip id, e.g. clip_ec2f047d
clip timeline transcribe clip_ec2f047d # transcribe it (once per file)
clip timeline silence clip_ec2f047d # cut the pauses on main
clip timeline transcribe --sentences | head -80 # one line per sentence: time, word indices, text
clip timeline short best-1 clip_ec2f047d 1400 1478 --x 0.4 # words 1400–1478 as a 9:16 short
clip timeline --timeline best-1 frame 3 check.jpg # look at it; move --x if the speaker is off
clip timeline --timeline best-1 export best-1.mp4
clip timeline list # main and every short
clip timeline export --all ./shorts # every short, as ./shorts/<id>.mp4
```

`short` cuts each edge inside the pause the audio shows there, keeping 0.1 s of room tone (where there's no clear pause it follows the transcript and warns), fills the 9:16 frame (`--x` picks the part that shows), sets -14 LUFS and burns in captions. Give several `<clipId> <from> <to>` ranges to join moments, in the order you give them. Any command takes `--timeline <id>` to work on a short, `clip timeline --timeline best-1 undo` takes the short apart again, and `short best-1 … --replace` rebuilds it.

In `clip ui`, select words in a clip's transcript and press **Make short**: the short opens in a tab of its own above the timeline, next to main. **Export all shorts** renders every one.

---

## Another example: a product demo from screen recordings

Five screen recordings → one polished product demo. Type this into Claude Code (or Claude Desktop, via the MCP server):
Expand Down Expand Up @@ -324,7 +352,7 @@ No — nowhere. The CLI, the browser UI, the Claude Code skill, and the MCP serv
### Capabilities & limits

**Is it production-ready?**
This release is feature-complete for local editing — a dark timeline editor (view, edit, preview, export), silence removal, transcript editing, captions, 9:16 / 1:1 / 4:5 reframing, loudness normalization, export to Final Cut Pro, DaVinci Resolve and Premiere Pro, 19 single-file tools, an MCP server, and 859 tests passing. The API surface is still pre-1.0 (tool schemas may change in minor ways before 1.0). Use it for real work; pin a version in CI.
This release is feature-complete for local editing — a dark timeline editor (view, edit, preview, export), silence removal, transcript editing, captions, 9:16 / 1:1 / 4:5 reframing, loudness normalization, export to Final Cut Pro, DaVinci Resolve and Premiere Pro, 19 single-file tools, an MCP server, and 965 tests passing. The API surface is still pre-1.0 (tool schemas may change in minor ways before 1.0). Use it for real work; pin a version in CI.

**What's the maximum video size or duration?**
No hardcoded limit. FFmpeg streams the file rather than loading it into memory, and the browser UI streams uploads to disk — multi-GB recordings work fine. This release isn't tuned for projects with hundreds of clips or runtime above 30 minutes; for those, drive the CLI directly.
Expand Down Expand Up @@ -386,7 +414,7 @@ MakeMyClip Editor is built for that job: an open-source video editor that Claude

### Is there an MCP server for video editing?

Yes. `npx -y @makemyclip/editor mcp` starts MakeMyClip Editor's local MCP server over stdio for Claude Desktop, Cursor, or any MCP client. Its tools show the timeline, edit it (add media, trim, split, remove silence, cut words, remove retakes, caption speech, reframe to 9:16, set loudness, transitions), check the cuts, transcribe, undo, redo, and export to mp4, FCPXML or Premiere XML. Media stays in one workspace folder, and no API key is needed.
Yes. `npx -y @makemyclip/editor mcp` starts MakeMyClip Editor's local MCP server over stdio for Claude Desktop, Cursor, or any MCP client. Its tools show the timeline, edit it (add media, trim, split, remove silence, cut words, remove retakes, caption speech, reframe to 9:16, set loudness, make shorts, transitions), check the cuts, transcribe, undo, redo, and export to mp4, FCPXML or Premiere XML. Media stays in one workspace folder, and no API key is needed.

### How do I remove silence from a video automatically?

Expand All @@ -398,7 +426,11 @@ Yes. MakeMyClip Editor transcribes with whisper.cpp on your machine; install it

### Can Claude add captions or subtitles to a video?

Yes. After transcription, MakeMyClip Editor's `clip timeline captions` (or the UI's Captions button) puts captions timed to the words on a track above the video, and export burns them in. Captions come as short phrases or one word at a time, with your choice of size, color, position, and background. Non-Latin scripts use an installed font that has the glyphs. In the Premiere export, captions become `.srt` files. On Linux, the bundled FFmpeg can't draw text, so set `MAKEMYCLIP_FFMPEG_PATH` to an FFmpeg built with libfreetype and libharfbuzz.
Yes. After transcription, MakeMyClip Editor's `clip timeline captions` (or the UI's Captions button) puts captions timed to the words on a track above the video, and export burns them in. Captions come as short phrases or one word at a time, with your choice of size, color, position, and background. On a vertical canvas they sit above the bottom quarter, clear of the Shorts, Reels and TikTok buttons, and a line is never wider than fits at its font size. Non-Latin scripts use an installed font that has the glyphs. In the Premiere export, captions become `.srt` files. On Linux, the bundled FFmpeg can't draw text, so set `MAKEMYCLIP_FFMPEG_PATH` to an FFmpeg built with libfreetype and libharfbuzz.

### Can it cut Shorts or Reels out of a podcast?

Yes. Transcribe the recording, then `clip timeline short best-1 <clipId> <fromWord> <toWord>` (or the `make_short` verb from chat) turns that range of words into a vertical short on a timeline of its own: 9:16, filling the frame, captioned, normalized to -14 LUFS, with the silence and retake cuts already made on the recording. Make as many as you like; the long cut stays untouched, and each short exports on its own. You or the agent pick the moments: nothing scores highlights for you, and nothing is uploaded.

### Can I finish an AI edit in DaVinci Resolve, Premiere Pro or Final Cut Pro?

Expand All @@ -422,7 +454,7 @@ auto-editor is a mature open-source command-line tool that cuts silence or motio

## Roadmap

- **Now (v0.5.0)** — silence removal, local transcription, edit by transcript, retake removal, captions, 9:16 / 1:1 / 4:5 reframing, loudness normalization, click-free cuts, export to Final Cut Pro / DaVinci Resolve / Premiere Pro, on top of the dark timeline editor (view / edit / preview / export), 19 tools, MCP server, and snapshot/undo
- **Now (v0.5.2)** — vertical shorts from a long recording, silence removal, local transcription, edit by transcript, retake removal, captions, 9:16 / 1:1 / 4:5 reframing, loudness normalization, click-free cuts, export to Final Cut Pro / DaVinci Resolve / Premiere Pro, on top of the dark timeline editor (view / edit / preview / export), 19 tools, MCP server, and snapshot/undo
- **Next** — model picker, SSE for live session updates, AI Elements / shadcn migration
- **1.0** — frozen tool schemas, MCP transport, published Anthropic skill, docs site
- **Beyond** — desktop app (Electron), cloud rendering via [MakeMyClip.com](https://makemyclip.com)
Expand Down
Loading
Loading