Command · Media Attributes
media.setAttributes
Library metadata of media items: name (new clips take it; existing clips keep theirs), label colour, comment, description and poster frame (a source time, or null to clear it).
- v1
- Capability EditProject
- Tool
media_setAttributes
Request
{
"command": "media.setAttributes",
"params": {
"colorIndex": 4,
"comment": "Best take",
"media": [
3
]
}
}Parameters
colorIndexinteger (0..15)- Label colour, 0..15.
commentstring- Comment.
descriptionstring- Description.
media(integer | string (1..))[], min 1Required- The media items.
namestring- The name (not empty).
posterFrameinteger | string | null- Poster frame (media time); null clears it. Ticks, or a timecode in the media's frame rate ("00:00:02:10").
sequenceinteger (1..)- Sequence id; only needed when the project has several.
Discussion
Library metadata of media items: name (new clips take it; existing clips keep theirs), label colour, comment, description and poster frame (a source time, or null to clear it). Fields not given stay. One undo step for any number of items.
Run it with wabcut-cli cmd <project> --json, from an MCP client as media_setAttributes, or from an extension. See Edit commands for requests, references and results.
See also
media.*
- media.list
List Media. Lists the project's media as arrays in mediaFields order: id, name, duration in ms, whether it has video, its number of audio streams, whether it is a still image and whether it is offline.
- media.makeSubclip
Make Subclip. A new media item playing "in".."out" (exclusive) of a media item's file, named "name", in "bin" (default the root).
- media.newSynthetic
New Synthetic Item. Makes a synthetic project item (File > New): "colorMatte" (params color.r/g/b, 0..1: a background for text, a flash), "blackVideo" or "transparentVideo" (a layer of its own for effects that draw).
- media.setSubclip
Edit Subclip. Changes a subclip's range and restriction (Premiere's Edit Subclip).