Skip to content

About

Turn a long podcast, webinar or stream VOD into vertical 9:16 clips with burned-in captions. Local faster-whisper + ffmpeg, no API key.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

amagi-clipper

Point it at a long podcast, webinar, or stream recording and get back vertical 9:16 clips with burned-in captions, ready for Shorts, Reels, and TikTok. It runs on your own computer with no API key and no subscription.

demo

amagi-clipper transcribes the recording locally with faster-whisper. It then scores every 20 to 75 second run of whole sentences on how well it stands alone, and uses ffmpeg to cut the top picks into 1080x1920 mp4s. Captions appear up to three words at a time, with the word being spoken in yellow.

It was built for solo podcasters and small agencies who record every week and never find the time to cut clips.

three clips from the demo episode

Frames from the three clips it cut from the demo episode (audio-only input, so it used the waveform layout).

Install

pipx install amagi-clipper

Or from a clone of this repo: pipx install .

You also need ffmpeg on your PATH. Python 3.10 or newer. The first run downloads the Whisper model you pick. If you have an NVIDIA GPU, amagi-clipper uses it automatically. GPU transcription also needs NVIDIA's cuBLAS and cuDNN 9 libraries (see the faster-whisper install notes). If they are missing, amagi-clipper says so and falls back to the CPU.

Usage

amagi-clipper <file> [-o OUTDIR] [-n 5] [--min 20] [--max 75] [--layout auto|crop|blur|audiogram] [--model small] [--dry-run]
Option What it does
-o, --outdir Where run folders go (default amagi_clipper_out)
-n, --count How many clips to cut (default 5)
--min, --max Shortest and longest clip in seconds (default 20 and 75)
--layout crop fills the frame from the center, blur puts the whole picture over a blurred copy, audiogram draws a waveform. Default: crop for video, audiogram for audio-only
--model faster-whisper size: tiny, base, small (default), medium, large-v3
--device auto (default), cpu, or cuda
--language Spoken language code such as en (default: detect)
--size Output size (default 1080x1920)
--font, --font-size, --highlight Caption font (default Arial), size in pixels (default 5% of frame height), and the color of the spoken word (default #FFD400)
--no-upper Keep caption case as spoken instead of UPPERCASE
--no-headline Audiogram clips: leave out the headline at the top
--transcript Reuse a transcript.json from an earlier run instead of transcribing
--dry-run Score and list the clips, render nothing

Examples:

# Five clips from a video podcast, center-cropped
amagi-clipper episode42.mp4

# A two-person or screen-share recording: keep the whole picture
amagi-clipper webinar.mp4 --layout blur -n 3

# See what it would cut before rendering anything
amagi-clipper episode42.mp4 --dry-run

Transcription is the slow step, so the transcript is cached in the run folder. Run the same file again with a different -n, --min, --max, or --layout and Whisper is skipped.

Real output

The demo episode in tests/fixtures/demo_episode.m4a is 144 seconds of two synthesized voices. We wrote the script with three self-contained monologues buried among intro, outro, and back-and-forth chatter, to see whether amagi-clipper would find them. Here is the run on an RTX 3090 with the default small model:

$ amagi-clipper tests/fixtures/demo_episode.m4a -o runs -n 3
#1   97.0  01:13-01:41    28s  clip_01.mp4  "Why do most clips fail?"
#2   91.0  00:27-00:56    30s  clip_02.mp4  "Here's the truth nobody tells you about growing a podcast."
#3   91.0  01:49-02:15    26s  clip_03.mp4  "Stop paying $30 a month for clip software."
runs/demo_episode

It picked the three monologues and skipped the intro. Transcription plus three 1080x1920 renders took 23.7 seconds of wall time.

Each run writes <outdir>/<name>/:

  • clip_01.mp4, clip_02.mp4, ...: the vertical clips with captions burned in.
  • clip_01.srt, ...: plain caption files, for platforms that take them.
  • clips.md: every clip with its score, the reasons behind it, and the full text.
  • clips.json: the same data for scripts.
  • transcript.json: word-level timestamps, reused on the next run.

The entry for clip 1 in clips.md (full file in examples/demo_episode):

## 1. 97.0 - [01:13 - 01:41] 28s

- File: `clip_01.mp4`
- Hook: "Why do most clips fail?"
- Score parts: hook 27, standalone 20, ending 15, length 10, boundaries 10, delivery 15
- Why: hook: opens with a question (+); hook: 'why' framing (+); hook: short first sentence, 5 words (+); standalone: clean start and finished last sentence (+); ending: lands on a full statement (+); length: 27s sits in the 26-53s sweet spot (+)

How scoring works

amagi-clipper splits the transcript into sentences at end punctuation or at any pause of 1.2 seconds or more. Every run of whole sentences between --min and --max is a candidate. Each candidate gets up to 100 points:

Part Points What earns them
Hook 30 The first sentence works as an opener: a question, a number, "here's", "why", "stop", talking to "you", short. An opener like "and", "so", or "but", or an intro line such as "welcome back", scores zero
Standalone 20 Starts clean, with no "it" or "that" pointing back at something the viewer never heard, and finishes its last sentence
Ending 15 Ends on a statement. Stopping on a question, on a short reply like "It was.", or running into the sign-off costs points
Length 10 Sits in the middle of your --min/--max range
Boundaries 10 Has a half-second pause before and after, so the cut does not clip a word
Delivery 15 Few filler words, 1.8 to 4.0 words per second, no dead air over 2.5 seconds

The best clips are picked first and never overlap. Every point gained or lost is written to clips.md in plain words, so you can see why a clip ranked where it did.

Use it as a Claude Code skill

The repo includes a SKILL.md. Copy it into your skills folder:

mkdir -p ~/.claude/skills/amagi-clipper
cp SKILL.md ~/.claude/skills/amagi-clipper/SKILL.md

Then ask Claude to "cut five clips from episode42.mp4". It runs amagi-clipper and reads clips.md back to you.

Limitations

  • Scoring is a heuristic, not an LLM. It finds clean, self-contained stretches with a strong first line. It cannot tell whether a joke lands. Watch the clips before you post them.
  • crop is a fixed center crop with no face tracking. If the speaker sits off-center, use --layout blur.
  • Whisper on a CPU is slow. On our busy test PC, small ran slower than real time. --model base or tiny is faster but less accurate, and an NVIDIA GPU is much faster.
  • The demo episode is synthesized speech written for the test. Real conversations are messier, so expect to see more picks you would skip.

Related AmagiLabs projects

If amagi-clipper saved you an afternoon of scrubbing through a timeline, a star helps other podcasters find it.

License

MIT. Copyright (c) 2026 Amagisolutionsgroup, Inc. (AmagiLabs). See LICENSE.

Built by AmagiLabs.

About

Turn a long podcast, webinar or stream VOD into vertical 9:16 clips with burned-in captions. Local faster-whisper + ffmpeg, no API key.

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages