# Command catalogue

> Every editing command a batch can contain, with its scope and phase.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/

An `edit` call is a list of operations; each operation is one of these commands. Each page has the arguments, an example and the errors.

| Command | Summary | Scope | Phase |
| --- | --- | --- | --- |
| [`asset.remove`](/docs/reference/commands/asset.remove) | Removes an asset that no item uses. | `media` | alpha |
| [`audio.add`](/docs/reference/commands/audio.add) | Places an audio asset, or the audio of a video asset, on an audio track. | `edit` | alpha |
| [`audio.duck`](/docs/reference/commands/audio.duck) | Lowers a music item while speech sounds, with a ramp down before and a ramp up after. | `edit` | beta |
| [`audio.mark_beats`](/docs/reference/commands/audio.mark_beats) | Writes markers on a music item at the beats of its audio. | `edit` | beta |
| [`caption.add`](/docs/reference/commands/caption.add) | Adds a caption item with timed words. | `edit` | prototype |
| [`caption.edit_word`](/docs/reference/commands/caption.edit_word) | Changes the text of one word of a caption, or removes the word. | `edit` | alpha |
| [`caption.from_transcript`](/docs/reference/commands/caption.from_transcript) | Creates captions for the speech of a clip from its transcript. | `edit` | alpha |
| [`caption.merge`](/docs/reference/commands/caption.merge) | Joins two captions of one track into one that spans both. | `edit` | alpha |
| [`caption.retime_from_clip`](/docs/reference/commands/caption.retime_from_clip) | Retimes the captions linked to a clip after the clip was moved, trimmed or sped up. | `edit` | alpha |
| [`caption.set_breaks`](/docs/reference/commands/caption.set_breaks) | Sets the forced line breaks of a caption. | `edit` | alpha |
| [`caption.set_style`](/docs/reference/commands/caption.set_style) | Sets or clears the style override of one caption. | `edit` | alpha |
| [`caption.set_words`](/docs/reference/commands/caption.set_words) | Replaces the words of a caption. | `edit` | alpha |
| [`caption.split`](/docs/reference/commands/caption.split) | Splits a caption into two at a word boundary. | `edit` | alpha |
| [`clip.add`](/docs/reference/commands/clip.add) | Places a video or image asset on a visual track. | `edit` | prototype |
| [`clip.remove_silences`](/docs/reference/commands/clip.remove_silences) | Cuts the silent stretches out of a clip, leaving one clip per stretch of speech. | `edit` | alpha |
| [`clip.set_blur`](/docs/reference/commands/clip.set_blur) | Sets the blur radius of a clip. | `edit` | beta |
| [`clip.set_color`](/docs/reference/commands/clip.set_color) | Sets the brightness, contrast and saturation of a clip. | `edit` | alpha |
| [`clip.set_filter`](/docs/reference/commands/clip.set_filter) | Sets the colour filter of a clip and how much of it is mixed in. | `edit` | beta |
| [`clip.set_framing`](/docs/reference/commands/clip.set_framing) | Sets how the asset of a clip is fitted into the frame and how much of each side is cropped. | `edit` | alpha |
| [`clip.set_speed`](/docs/reference/commands/clip.set_speed) | Changes the speed of a clip or audio item while keeping the same source range. | `edit` | alpha |
| [`font.add`](/docs/reference/commands/font.add) | Adds a user font family to the project, or more weights to one it already has. | `media` | beta |
| [`font.remove`](/docs/reference/commands/font.remove) | Removes a user font family from the project. | `media` | beta |
| [`item.crossfade`](/docs/reference/commands/item.crossfade) | Sets a matching fade-out and fade-in on two overlapping visual items of different tracks. | `edit` | alpha |
| [`item.delete`](/docs/reference/commands/item.delete) | Removes items, and optionally closes the freed space. | `edit` | prototype |
| [`item.duplicate`](/docs/reference/commands/item.duplicate) | Copies an item to another position, optionally on another track. | `edit` | alpha |
| [`item.move`](/docs/reference/commands/item.move) | Moves an item in time, to another track of the same kind, or both. | `edit` | prototype |
| [`item.rename`](/docs/reference/commands/item.rename) | Sets the label of an item. | `edit` | alpha |
| [`item.set_audio`](/docs/reference/commands/item.set_audio) | Sets the volume, the fades or the mute flag of a clip or audio item. | `edit` | alpha |
| [`item.set_transform`](/docs/reference/commands/item.set_transform) | Sets the position, scale, rotation or opacity of a visual item. | `edit` | alpha |
| [`item.set_transition`](/docs/reference/commands/item.set_transition) | Sets or removes the transition on one edge of a visual item. | `edit` | alpha |
| [`item.split`](/docs/reference/commands/item.split) | Splits an item into two at a timeline frame. | `edit` | prototype |
| [`item.trim`](/docs/reference/commands/item.trim) | Moves the start edge or the end edge of an item to a timeline position. | `edit` | prototype |
| [`keyframe.clear`](/docs/reference/commands/keyframe.clear) | Removes all keyframes of one property, or of every property. | `edit` | alpha |
| [`keyframe.remove`](/docs/reference/commands/keyframe.remove) | Removes the keyframe of a property at a frame. | `edit` | alpha |
| [`keyframe.set`](/docs/reference/commands/keyframe.set) | Adds or replaces a keyframe of one animated property of an item. | `edit` | alpha |
| [`project.rename`](/docs/reference/commands/project.rename) | Sets the project name. | `edit` | prototype |
| [`settings.set`](/docs/reference/commands/settings.set) | Sets the frame size, the background colour or the loudness target. | `edit` | prototype |
| [`settings.set_fps`](/docs/reference/commands/settings.set_fps) | Changes the project frame rate and rescales every time quantity. | `edit` | alpha |
| [`shape.add`](/docs/reference/commands/shape.add) | Adds a rectangle, rounded rectangle or ellipse to a visual track. | `edit` | alpha |
| [`shape.set`](/docs/reference/commands/shape.set) | Changes the shape, size, colours, stroke or radius of a shape item. | `edit` | alpha |
| [`slot.fill`](/docs/reference/commands/slot.fill) | Fills a template slot with media, text or caption words. | `edit` | alpha |
| [`slot.mark`](/docs/reference/commands/slot.mark) | Marks an item as a template slot. | `edit` | alpha |
| [`slot.unmark`](/docs/reference/commands/slot.unmark) | Removes the slot marking of an item. | `edit` | alpha |
| [`template.set_info`](/docs/reference/commands/template.set_info) | Sets the description and the named colours of the template. | `edit` | alpha |
| [`text.add`](/docs/reference/commands/text.add) | Adds a text item to a visual track. | `edit` | prototype |
| [`text.apply_preset`](/docs/reference/commands/text.apply_preset) | Animates one edge of a visual item with a named preset. | `edit` | alpha |
| [`text.set`](/docs/reference/commands/text.set) | Changes the content or the style of a text item. | `edit` | prototype |
| [`timeline.close_gap`](/docs/reference/commands/timeline.close_gap) | Closes the empty range that contains a given frame on a track. | `edit` | alpha |
| [`track.add`](/docs/reference/commands/track.add) | Adds an empty track at a place in the track order. | `edit` | prototype |
| [`track.move`](/docs/reference/commands/track.move) | Changes the place of a track in the track order. | `edit` | prototype |
| [`track.remove`](/docs/reference/commands/track.remove) | Removes a track, and its items when with_items is true. | `edit` | prototype |
| [`track.set_caption_style`](/docs/reference/commands/track.set_caption_style) | Merges a partial caption style into a track, or replaces it. | `edit` | prototype |
| [`track.update`](/docs/reference/commands/track.update) | Sets the name, the hidden flag or the muted flag of a track. | `edit` | prototype |
