URL Handler

​
CommandPost has a URL Handler which allows you to trigger CommandPost Commands & Actions via a simple URL address.
For example, you can type any of the below into a browser to trigger a specific action:
1
commandpost://fcpx_cmds?id=cpSelectClipAtLaneOne
2
commandpost://global_cmds?id=cpGlobalConsole
3
commandpost://fcpx_shortcuts?id=SelectAll
4
commandpost://fcpx_menu?path=Final%20Cut%20Pro||About%20Final%20Cut%20Pro
5
commandpost://fcpx_audioEffect?category=Voice&name=AUNewPitch
6
commandpost://fcpx_title?category=Lower%20Thirds&name=Basic%20Lower%20Third
7
commandpost://fcpx_transition?name=Spin&category=Movements
8
commandpost://fcpx_generator?name=Beam&category=Backgrounds
9
commandpost://fcpx_videoEffect?name=Directional&category=Blur
Copied!
To get a list of the Handler IDs that are recognised by the URL Handler (i.e. "fcpx_cmds"), type the below Lua code into the Error Log:
1
hs.inspect(require("cp.plugins")("core.action.manager").handlerIds())
Copied!
To get a list of choices available for a specific Hander ID, type the below (replacing "fcpx_shortcuts" with the Handler ID you want to review) into the Error Log:
1
hs.inspect(require("cp.plugins")("core.action.manager").getHandler("fcpx_cmds"):choices())
Copied!
For example, if the Error Log displays something like:
1
{
2
  id = "cmds:cpColorPuckFourLeft",
3
  params = {
4
	id = "cpColorPuckFourLeft"
5
  },
6
  subText = "Command: Colour Board",
7
  text = "Select Color Puck 4 & Left",
8
  type = "fcpx_cmds"
9
}
Copied!
Then the URL will be:
commandpost://fcpx_cmds?id=cpColorPuckFourLeft
Basically you use the params table as your guide. Table items can be separated with ||.
The following Handler IDs should not be used with the URL Handler:
fcpx_midicontrols
fcpx_widgets
global_widgets

Control CommandPost - Previous

AppleScript

Next - Control CommandPost

Command Line Tool

Last modified 1mo ago

Export as PDF

Copy link