Vertical Reframe v1.0.0

Video & audio tiktok-reframe 2 actions MCP

Reframe a landscape video into 9:16, 4:5 or 1:1 for TikTok, Reels or Shorts: the clip is scaled to fit the frame and the rest of the canvas is filled with a blurred, scaled-up copy of itself - the classic blurred-bars look. Built on ffmpeg; the source video is never modified.

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: reframereframe_folder

Reframe a video

reframe

Reframe one video to a vertical or square aspect ratio, with a blurred copy of the same video filling the background.

Inputs

Name	Type	Required / default	Values and notes
`video`	path	required
`target`	enum	optional, default `9:16`	`9:164:51:1`
`blur`	int	optional, default `40`
`out`	path	optional, default `""`

Outputs

Name	Type	Notes
`file`	path

Reframe a folder of videos

reframe_folder

Reframe every video in a folder to the given aspect ratio, writing copies to a 'reframed' subfolder.

Inputs

Name	Type	Required / default	Values and notes
`folder`	path	required
`target`	enum	optional, default `9:16`	`9:164:51:1`
`blur`	int	optional, default `40`

Outputs

Name	Type	Notes
`count`	int
`out_dir`	path

Use it

Reframe a video

Command line

shell

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

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("tiktok-reframe", "reframe", {"video": "D:/path/to/video"})

Workflow node

json

{
  "id": "n0",
  "app": "tiktok-reframe",
  "action": "reframe",
  "params": {
    "video": "D:/path/to/video"
  },
  "inputs": {}
}

Reframe a folder of videos

Command line

shell

python app.py --action reframe_folder --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("tiktok-reframe", "reframe_folder", {"folder": "D:/path/to/folder"})

Workflow node

json

{
  "id": "n0",
  "app": "tiktok-reframe",
  "action": "reframe_folder",
  "params": {
    "folder": "D:/path/to/folder"
  },
  "inputs": {}
}

Example prompts

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

reframe clip.mp4 to 9:16 for TikTok with a blurred background
reframe every video in D:/footage to 4:5 for Reels