Command · Make Highlight Reel
highlights.toReel
Makes a new sequence from highlight moments (the sequence's highlight markers, or "moments"): each moment with handles, best first up to "count" / "maxDuration", in time or score order, with transitions between them.
- v1
- Capability EditProject
- Tool
highlights_toReel
Request
{
"command": "highlights.toReel",
"params": {
"count": 8,
"order": "time",
"transition": "crossDissolve"
}
}Parameters
beatsPerCutinteger (1..64)- Cuts every this many beats (or a multiple). Default 4.
countinteger (1..50)- How many moments at most (best first). Default all, at most 50.
handleAfternumber (0.0..30.0)- Seconds added after each moment. Default 0.5.
handleBeforenumber (0.0..30.0)- Seconds added before each moment. Default 0.5.
maxDurationnumber (1.0..3600.0)- Longest reel, seconds (best moments first).
momentsobject[]- Moments in sequence seconds (default: the highlight markers).
moments[].endnumber (0.0..86400.0)Required- Seconds.
moments[].peaknumber (0.0..86400.0)- Seconds.
moments[].scorenumber (0.0..1.0)- 0..1
moments[].startnumber (0.0..86400.0)Required- Seconds.
moments[].titlestring- Label.
musicinteger | string (1..)- Music to cut to: the cuts land on its beats and it plays under the reel. A media id or exact name.
musicStartnumber (0.0..86400.0)- Where the music starts, seconds into it. Default 0.
namestring- Name of the new sequence. Default " - Highlights".
order`time` | `score`- Order of the moments in the reel. Default time.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
slowMotionboolean- Slow down each moment's peak. Default false.
slowMotionSecondsnumber (0.1..10.0)- Seconds of footage slowed. Default 1.5.
slowMotionSpeednumber (0.1..1.0)- Speed of the slow part (0.1..1). Default 0.5.
transition`crossDissolve` | `dipToBlack` | `dipToWhite` | `none`- Transition between moments (audio crossfades). Default crossDissolve.
transitionDurationnumber (0.0..5.0)- Seconds. Default 0.5.
Discussion
Makes a new sequence from highlight moments (the sequence's highlight markers, or "moments"): each moment with handles, best first up to "count" / "maxDuration", in time or score order, with transitions between them. With "music" the cuts land on its beats (every "beatsPerCut" beats) and the music plays under the reel; "slowMotion" slows the moment's peak. One undo step.
Run it with wabcut-cli cmd <project> --json, from an MCP client as highlights_toReel, or from an extension. See Edit commands for requests, references and results.
See also
highlights.*
- highlights.find
Find Highlights. Finds the best moments of a gaming recording on this computer: game-audio spikes, the player's voice (louder or higher than usual, shouting, laughter), the picture (fast action, flashes, bursts of picture changes), the recording's imported Twitch / YouTube chat log (busy chat, emotes; highlights.importChat) and OBS chapter markers or a marker file next to the recording.
- highlights.importChat
Import Chat Log. Reads a stream's chat log (TwitchDownloader JSON, yt-dlp live_chat.json or chat-downloader JSON) and keeps it with a recording's analyses, so highlights.find counts busy chat and emotes.
- highlights.toShort
Make Highlight Short. Makes one highlight moment (a highlight marker by rank, or start/end) a vertical 1080x1920 Short: the moment cut out with every track, laid out with layout.apply ("verticalSplit" with the facecam under the gameplay when there is one: a facecam clip above the gameplay or "facecamRegion"; else "verticalBlurFill": the whole game view over a blurred copy), captioned, with the moment's title as the hook and loudness for Shorts.