Clip Timeline v1.1.0

Video & audio clip-timeline 7 actions MCP

Put the shots of a short film in order. Load a zip or folder of clips (numbered shots land on the timeline in order, extras wait in the bin), drag to reorder, trim, replace or remove shots, add transitions (46 effects, or spread them automatically by scene change), vary shot lengths with Scene dynamism (never cutting into loud sound), lay music/voice on two audio lanes, preview it all live and render one mp4.

Open in Omniscient Back to apps

The omniscient:// link needs a protocol handler on your machine, which is not built yet. Until then it does nothing — use the commands below.

Actions

Jump to: importorderrenderexport_clipsauto_transitionsscene_dynamismadd_audio

Import clips

import

Import a zip, folder or single video into a timeline project. Numbered shots (Shot_01, 012 ...) go on the timeline in order; unnumbered clips go to the bin. Zips are extracted (videos only) into the app's data folder.

Inputs

Name	Type	Required / default	Values and notes
`source`	path	required
`project`	path	optional, default `""`
`append`	bool	optional, default `false`
`name`	string	optional, default `""`
`place`	enum	optional, default `auto`	`autoallbin`
`media_dir`	path	optional, default `""`

Outputs

Name	Type	Notes
`project`	path
`on_timeline`	int
`bin_only`	int

Show timeline order

order

List the clips of a project (default: the last opened one) in film order with start times.

Inputs

Name	Type	Required / default	Values and notes
`project`	path	optional, default `""`

Outputs

Name	Type	Notes
`clips`	json
`duration`	float

Render film

render

Render the timeline to one mp4 with its trims, transitions (ffmpeg xfade, centred on the cuts) and mixed audio lanes. A plain timeline in one shared format is joined losslessly instead.

Inputs

Name	Type	Required / default	Values and notes
`project`	path	optional, default `""`
`out`	path	optional, default `""`
`resolution`	enum	optional, default `source`	`source1080p720pverticalsquare`
`reencode`	bool	optional, default `false`

Outputs

Name	Type	Notes
`file`	path
`clips`	int
`duration`	float

Export numbered clips

export_clips

Copy the timeline's clips into a folder as '001 - Shot 12.mp4', '002 - ...' in film order.

Inputs

Name	Type	Required / default	Values and notes
`project`	path	optional, default `""`
`folder`	path	required

Outputs

Name	Type	Notes
`folder`	path
`count`	int

Auto transitions

auto_transitions Destructive

Spread transitions over the film: stronger ones (fade through black, circle...) at detected scene changes, soft short ones inside a scene.

Inputs

Name	Type	Required / default	Values and notes
`project`	path	optional, default `""`
`style`	enum	optional, default `mixed`	`gentlemixedplayful`
`cuts`	enum	optional, default `every`	`everysceneevery2every3`
`duration`	float	optional, default `0.8`
`fade_in`	bool	optional, default `true`
`fade_out`	bool	optional, default `true`
`replace`	bool	optional, default `true`
`seed`	int	optional

Outputs

Name	Type	Notes
`placed`	int
`scene_changes`	int

Scene dynamism

scene_dynamism Destructive

Shave a random 0..max_trim seconds off each shot's start and end where the sound is quiet, so shots are not all the same length; loud sound near an edge limits the trim.

Inputs

Name	Type	Required / default
`project`	path	optional, default `""`
`max_trim`	float	optional, default `1.0`
`seed`	int	optional
`reset`	bool	optional, default `false`

Outputs

Name	Type	Notes
`before`	float
`after`	float
`limited_by_sound`	int

Add audio to a lane

add_audio Destructive

Put a music or voice-over file on audio lane A1 (0) or A2 (1) at a film time.

Inputs

Name	Type	Required / default
`project`	path	optional, default `""`
`audio`	path	required
`lane`	int	optional, default `0`
`start`	float	optional, default `0.0`
`volume`	float	optional, default `1.0`
`fade_in`	float	optional, default `0.0`
`fade_out`	float	optional, default `0.0`

Outputs

Name	Type	Notes
`added`	json

Use it

Import clips

Command line

shell

python app.py --action import --params '{"source": "D:/path/to/source"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "import", {"source": "D:/path/to/source"})

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "import",
  "params": {
    "source": "D:/path/to/source"
  },
  "inputs": {}
}

Show timeline order

Command line

shell

python app.py --action order --params '{}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "order", {})

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "order",
  "params": {},
  "inputs": {}
}

Render film

Command line

shell

python app.py --action render --params '{}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "render", {})

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "render",
  "params": {},
  "inputs": {}
}

Export numbered clips

Command line

shell

python app.py --action export_clips --params '{"folder": "D:/path/to/folder"}'

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "export_clips", {"folder": "D:/path/to/folder"})

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "export_clips",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Auto transitions

Command line

shell

python app.py --action auto_transitions --params '{}'

# preview first - destructive action, nothing is changed:
python app.py --action auto_transitions --params '{}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "auto_transitions", {})

# preview first:
run_action("clip-timeline", "auto_transitions", {}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "auto_transitions",
  "params": {},
  "inputs": {}
}

Scene dynamism

Command line

shell

python app.py --action scene_dynamism --params '{}'

# preview first - destructive action, nothing is changed:
python app.py --action scene_dynamism --params '{}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "scene_dynamism", {})

# preview first:
run_action("clip-timeline", "scene_dynamism", {}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "scene_dynamism",
  "params": {},
  "inputs": {}
}

Add audio to a lane

Command line

shell

python app.py --action add_audio --params '{"audio": "D:/path/to/audio"}'

# preview first - destructive action, nothing is changed:
python app.py --action add_audio --params '{"audio": "D:/path/to/audio"}' --dry-run

Run from the app’s own folder. Single quotes work in bash and PowerShell; in cmd.exe use double quotes and escape the inner ones.

MCP tool

mcp

run_action("clip-timeline", "add_audio", {"audio": "D:/path/to/audio"})

# preview first:
run_action("clip-timeline", "add_audio", {"audio": "D:/path/to/audio"}, dry_run=true)

Workflow node

json

{
  "id": "n0",
  "app": "clip-timeline",
  "action": "add_audio",
  "params": {
    "audio": "D:/path/to/audio"
  },
  "inputs": {}
}

Example prompts

Things you can say to Claude, Cursor or Codex once the MCP server is registered.

import shots.zip into a new timeline
show the order of the current film
render the timeline to D:/film.mp4