MiniPrompter
Get it

Stream Decks, Shortcuts and Automator

MiniPrompter takes commands from outside the app in two ways. Both work while another app is in front, which is the point.

Web addresses

Every command has an address. Give one to a Stream Deck key, a Loupedeck button, a Shortcuts action or a shell script and it does the thing.

  • miniprompter://play
  • miniprompter://pause
  • miniprompter://toggle
  • miniprompter://faster
  • miniprompter://slower
  • miniprompter://jump-top
  • miniprompter://light-up
  • miniprompter://light-down
  • miniprompter://light-toggle
  • miniprompter://light-only

On a Stream Deck, use the built-in Open action and paste one of those in. No plugin needed.

Use open -g if you are writing a script. Without the -g, macOS brings MiniPrompter to the front every time the command fires, which is precisely what you do not want in the middle of a call. That is macOS doing it before MiniPrompter has been told anything, so the app cannot stop it.

open -g "miniprompter://toggle"

Both miniprompter://play and miniprompter:///play work. The two are easy to confuse when typing one by hand, so neither is rejected.

AppleScript and Shortcuts

The same commands, in plain English:

tell application "MiniPrompter" to play
tell application "MiniPrompter" to jump to top
tell application "MiniPrompter" to light only

The names are the same words with spaces instead of hyphens. Use these from Shortcuts, Automator, or a Run AppleScript action.

Keyboard shortcuts

A deck can also just send keystrokes. Turn on Settings › Shortcuts › Use the shortcuts below in any app and set your deck keys to send ⌃⌥Space, ⌃⌥↑ and so on. See the Keys page for the full list.

If a deck key does nothing

Check you have only one copy of MiniPrompter. This is the usual cause and it is genuinely hard to guess at. macOS keeps a record of every copy of an app it has ever seen — including ones in your Downloads folder, or ones you deleted — and it may send the command to the wrong one, where nothing appears to happen.

Keep one copy, in Applications. Note that dragging an old copy to the Trash does not remove macOS's record of it, so if this is happening, empty the Trash too.

While you are editing a script, the commands that would move the words are ignored on purpose — play, pause, toggle and jump-to-top. Speed and light commands still work, because they cannot disturb what you are typing.

← Recording Questions →