Command · Make Highlight Short
highlights.toShort
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.
- v1
- Capability EditProject
- Tool
highlights_toShort
Request
{
"command": "highlights.toShort",
"params": {
"moment": 1
}
}Parameters
blurnumber (0.0..500.0)- verticalBlurFill: the background's blur radius. Default 40.
captionsboolean- Captions from the transcript. Default true.
endnumber (0.0..86400.0)- Seconds.
facecaminteger | object- The facecam clip in the sequence (default: a clip of other media above the gameplay).
facecamOnTopboolean- verticalSplit: the facecam on top.
facecamRegionobjectfacecamRegion.heightnumber (0.01..1.0)Required- A fraction of the frame height.
facecamRegion.widthnumber (0.01..1.0)Required- A fraction of the frame width.
facecamRegion.xnumber (0.0..1.0)Required- Left, a fraction of the frame width.
facecamRegion.ynumber (0.0..1.0)Required- Top, a fraction of the frame height.
handleAfternumber (0.0..30.0)- Seconds added after. Default 0.
handleBeforenumber (0.0..30.0)- Seconds added before. Default 0.
hookTitleboolean- Show the title at the start. Default true.
layout`auto` | `verticalSplit` | `verticalBlurFill`- The layout (layout.apply). Default auto: verticalSplit with a facecam, else verticalBlurFill.
momentinteger (1..200)- Rank of the highlight marker. Default 1 (the best).
normalizeboolean- Loudness for Shorts. Default true.
sequenceinteger (1..)- Sequence id; only needed when the project has several.
splitnumber (0.2..0.8)- verticalSplit: the gameplay's share of the height. Default 0.6.
startnumber (0.0..86400.0)- Seconds.
titlestring- Hook title (default: the moment's title).
zoomnumber (1.0..4.0)- verticalBlurFill: the gameplay's scale over fit-to-width. Default 1.
Discussion
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. One undo step.
Run it with wabcut-cli cmd <project> --json, from an MCP client as highlights_toShort, 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.toReel
Make Highlight Reel. 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.