Magnifito Footage Editing & Dual-Timeline Cuts
The magnifito-edit skill handles cutting, trimming, and pacing of real client recordings, ensuring transcript word times and overlay graphics stay synchronized across edits.
Dual-Timeline Integrity
Editing alters presentation times. Word timestamps from the original transcript do not align with the edited output unless explicitly mapped:
- Source Timeline: Stored in integer microseconds (
source_start_us, source_end_us).
- Output Timeline: Stored in integer half-open frame intervals
[output_start_frame, output_end_frame).
- Edit Decision List (
edl.json):
- Every cut records
cut_id, source range, output range, speed factor, and reason.
- B-roll, captions, and graphics target the output timeline via
TimelineMapper.
- Never overwrite or mutate the original transcript timestamps.
Pacing Rules
- Silence Removal: Truncate pauses longer than 600ms down to 150-250ms for punchy pacing.
- Word Boundaries: Never cut closer than 50ms to the start or end of a spoken phoneme.
- Meaning Preservation: Ensure cuts do not invert the speaker's intent or omit critical qualifiers.
Object Separation (mgvideo separate)
Use it when a shot needs the subject (a person, product or hand) on its own layer: text or graphics
behind the speaker, a background swap, or a highlight on the product. It runs SAM 2.1 locally and
uploads nothing. The method is ported from Barty-Bart's object-separation skill (MIT). Skip it when
the footage was shot on green or blue screen (mgvideo chromakey is faster) or when a static matte is
enough (mgvideo matte).
- One-time setup:
mgvideo setup separate creates a Python venv in the user cache
($XDG_CACHE_HOME/mgvideo/venvs/separate, default ~/.cache/...) with pinned torch and
transformers. It needs Python 3.12 or newer. mgvideo doctor reports whether the venv exists and
which device it will use. Model weights (156 MB to 898 MB) download into the Hugging Face cache on
the first run, never into the repo.
- Pick points on the start frame: look at frame
--start first. Use source-pixel coordinates.
Put two or three --point x,y on the subject (label 1, the default) and one --point x,y,0 on
anything that must stay out (fingers holding a product, packaging, the table).
- Run a short range first (about 20 frames), check it, then run the full range:
mgvideo separate clip.mp4 --point 480,270 --point 520,300 --point 100,60,0 --start 0 --end 20 --out work/sep
--model tiny|base-plus|large overrides the hardware choice (CUDA with 12 GB or more: large;
smaller CUDA or Apple Silicon: base-plus; CPU: tiny). --format mov|webm|both picks the cut-out.
- Cost: about 5 s per frame on CPU (a 10 s clip at 30 fps is about 25 minutes), well under 1 s
on Apple Silicon or CUDA. The command prints an estimate before it starts. On CPU, separate only
the frames you need.
- Outputs in
--out: masks/%05d.png (one per frame, numbered by source frame, white = subject),
preview.mp4 (the subject tinted green with the original audio, for review), cutout.mov
(ProRes 4444 with alpha) and/or cutout.webm (VP9 with alpha), and separate.json (device, model,
timings). Masks stay on disk, so later composites reuse them without running separation again.
Check the preview at the start, the middle and any moment where something passes in front of the
subject. If green spills onto something else, add a label-0 point on it and run again. If part of the
subject is missing, add a label-1 point there. Masks are hard-edged: clean on objects and hands,
weaker on soft hair. The clip must be constant frame rate; convert it first with
ffmpeg -i in.mp4 -fps_mode cfr -r 30 out.mp4 if the command reports variable frame rate.
Title Cards and Review Watermarks (mgvideo title, mgvideo watermark)
Both are designed at 1080p and scale with the short side of the frame (min(w, h) / 1080), so a
720p export gets two-thirds of every size.
mgvideo title clip.mp4 -t "Title" -s "Subtitle" -p top|center|bottom burns a rounded card for the
whole clip. Defaults: navy rgba(15, 23, 42, 0.85), white 36 px title, #94A3B8 20 px subtitle,
Inter. Brand it with --bg, --color, --subtitle-color, --accent (stripe along the top edge),
--font <family>, --font-file <ttf/otf> (its family is used unless --font is given; it is
loaded through fontconfig for rsvg-convert) and --title-size / --subtitle-size (px at 1080p).
The card grows with bigger text; a line too long for the card is shrunk to fit.
mgvideo watermark clip.mp4 -t "REVIEW COPY" -r "Client" -p top_right|center|bottom_right burns
a banner sized to its text (20 px at 1080p by default, --font-size to change). Text that would
not fit inside the frame margins is shrunk, never clipped. --color sets the text colour (default
#F87171), --opacity the dark backing (default 0.45).
Green Screen and Redaction (mgvideo chromakey, mgvideo mask)
mgvideo chromakey take.mp4 --bg set.png keys on chroma only, so dark browns, hair and shadows
survive at the defaults; start there before tuning. --similarity (default 0.65) and --blend
(default 0.15) are shares of the distance from the key colour to neutral grey, so they mean the
same for --key 0x00FF00 and for a colour sampled off the wall. Raise --similarity if dark
corners of the screen stay; lower it if greenish wardrobe goes. Despill is on (--no-despill).
mgvideo mask clip.mp4 --box x,y,w,h redacts one region for the whole clip. For a field that
moves (a camera push, a scroll), give one --box x,y,w,h,start,end per time window, back to back
([start, end) in seconds, either end may be left empty), each box covering where the field is
during its window plus a few pixels. Check frames at every window boundary before delivery.
Stopping Conditions
- Fail if an edit interval creates a negative duration or references source microseconds beyond media length.
- Fail closed on
mgvideo separate errors (no venv, point outside the frame, range past the last frame, variable frame rate). Do not fall back to a guessed mask.
1---2name: magnifito-edit3description: "Cut and retime existing footage, remove silence, and maintain strict dual-timeline mappings between raw and edited timelines."4metadata:5 source: https://skillmd.com/skills/magnifito/magnifito-edit6---78# Magnifito Footage Editing & Dual-Timeline Cuts910The `magnifito-edit` skill handles cutting, trimming, and pacing of real client recordings, ensuring transcript word times and overlay graphics stay synchronized across edits.1112## Dual-Timeline Integrity1314Editing alters presentation times. Word timestamps from the original transcript do not align with the edited output unless explicitly mapped:15161. **Source Timeline**: Stored in integer microseconds (`source_start_us`, `source_end_us`).172. **Output Timeline**: Stored in integer half-open frame intervals `[output_start_frame, output_end_frame)`.183. **Edit Decision List (`edl.json`)**:19 - Every cut records `cut_id`, source range, output range, speed factor, and reason.20 - B-roll, captions, and graphics target the output timeline via `TimelineMapper`.21 - Never overwrite or mutate the original transcript timestamps.2223## Pacing Rules2425- **Silence Removal**: Truncate pauses longer than 600ms down to 150-250ms for punchy pacing.26- **Word Boundaries**: Never cut closer than 50ms to the start or end of a spoken phoneme.27- **Meaning Preservation**: Ensure cuts do not invert the speaker's intent or omit critical qualifiers.2829## Object Separation (`mgvideo separate`)3031Use it when a shot needs the subject (a person, product or hand) on its own layer: text or graphics32behind the speaker, a background swap, or a highlight on the product. It runs SAM 2.1 locally and33uploads nothing. The method is ported from Barty-Bart's object-separation skill (MIT). Skip it when34the footage was shot on green or blue screen (`mgvideo chromakey` is faster) or when a static matte is35enough (`mgvideo matte`).36371. **One-time setup**: `mgvideo setup separate` creates a Python venv in the user cache38 (`$XDG_CACHE_HOME/mgvideo/venvs/separate`, default `~/.cache/...`) with pinned torch and39 transformers. It needs Python 3.12 or newer. `mgvideo doctor` reports whether the venv exists and40 which device it will use. Model weights (156 MB to 898 MB) download into the Hugging Face cache on41 the first run, never into the repo.422. **Pick points on the start frame**: look at frame `--start` first. Use source-pixel coordinates.43 Put two or three `--point x,y` on the subject (label `1`, the default) and one `--point x,y,0` on44 anything that must stay out (fingers holding a product, packaging, the table).453. **Run a short range first** (about 20 frames), check it, then run the full range:46 ```47 mgvideo separate clip.mp4 --point 480,270 --point 520,300 --point 100,60,0 --start 0 --end 20 --out work/sep48 ```49 `--model tiny|base-plus|large` overrides the hardware choice (CUDA with 12 GB or more: large;50 smaller CUDA or Apple Silicon: base-plus; CPU: tiny). `--format mov|webm|both` picks the cut-out.514. **Cost**: about 5 s per frame on CPU (a 10 s clip at 30 fps is about 25 minutes), well under 1 s52 on Apple Silicon or CUDA. The command prints an estimate before it starts. On CPU, separate only53 the frames you need.545. **Outputs** in `--out`: `masks/%05d.png` (one per frame, numbered by source frame, white = subject),55 `preview.mp4` (the subject tinted green with the original audio, for review), `cutout.mov`56 (ProRes 4444 with alpha) and/or `cutout.webm` (VP9 with alpha), and `separate.json` (device, model,57 timings). Masks stay on disk, so later composites reuse them without running separation again.5859Check the preview at the start, the middle and any moment where something passes in front of the60subject. If green spills onto something else, add a label-0 point on it and run again. If part of the61subject is missing, add a label-1 point there. Masks are hard-edged: clean on objects and hands,62weaker on soft hair. The clip must be constant frame rate; convert it first with63`ffmpeg -i in.mp4 -fps_mode cfr -r 30 out.mp4` if the command reports variable frame rate.6465## Title Cards and Review Watermarks (`mgvideo title`, `mgvideo watermark`)6667Both are designed at 1080p and scale with the short side of the frame (`min(w, h) / 1080`), so a68720p export gets two-thirds of every size.6970- `mgvideo title clip.mp4 -t "Title" -s "Subtitle" -p top|center|bottom` burns a rounded card for the71 whole clip. Defaults: navy `rgba(15, 23, 42, 0.85)`, white 36 px title, `#94A3B8` 20 px subtitle,72 Inter. Brand it with `--bg`, `--color`, `--subtitle-color`, `--accent` (stripe along the top edge),73 `--font <family>`, `--font-file <ttf/otf>` (its family is used unless `--font` is given; it is74 loaded through fontconfig for rsvg-convert) and `--title-size` / `--subtitle-size` (px at 1080p).75 The card grows with bigger text; a line too long for the card is shrunk to fit.76- `mgvideo watermark clip.mp4 -t "REVIEW COPY" -r "Client" -p top_right|center|bottom_right` burns77 a banner sized to its text (20 px at 1080p by default, `--font-size` to change). Text that would78 not fit inside the frame margins is shrunk, never clipped. `--color` sets the text colour (default79 `#F87171`), `--opacity` the dark backing (default 0.45).8081## Green Screen and Redaction (`mgvideo chromakey`, `mgvideo mask`)8283- `mgvideo chromakey take.mp4 --bg set.png` keys on chroma only, so dark browns, hair and shadows84 survive at the defaults; start there before tuning. `--similarity` (default 0.65) and `--blend`85 (default 0.15) are shares of the distance from the key colour to neutral grey, so they mean the86 same for `--key 0x00FF00` and for a colour sampled off the wall. Raise `--similarity` if dark87 corners of the screen stay; lower it if greenish wardrobe goes. Despill is on (`--no-despill`).88- `mgvideo mask clip.mp4 --box x,y,w,h` redacts one region for the whole clip. For a field that89 moves (a camera push, a scroll), give one `--box x,y,w,h,start,end` per time window, back to back90 (`[start, end)` in seconds, either end may be left empty), each box covering where the field is91 during its window plus a few pixels. Check frames at every window boundary before delivery.9293## Stopping Conditions9495- Fail if an edit interval creates a negative duration or references source microseconds beyond media length.96- Fail closed on `mgvideo separate` errors (no venv, point outside the frame, range past the last frame, variable frame rate). Do not fall back to a guessed mask.