OSC
OSC
Action Phrase supports OSC (Open Sound Control) for communication with other apps, devices, and control systems on your local network.
OSC is a flexible, lightweight protocol widely used in live production, broadcast, interactive installations, and automation workflows.
With OSC enabled, Action Phrase can:
- Receive OSC messages to control Action Phrase remotely — start/stop/toggle listening, evaluate phrases, enable/disable/toggle groups, run actions, run phrases, and control teleprompter scrolling.
Enabling OSC
- Go to Action Phrase home.
- Tap the More menu.
- Choose Settings.
- Tap Remote Control.
- Tap OSC.
- Turn on Enable OSC Server.
- Specify the OSC Port (default
49992).- The port must be within the range
1024–65535.
- The port must be within the range
- Use the listed IP Addresses to determine which interface your device is using.
- Optionally enable Evaluate Phrases via OSC to allow OSC phrase text to be evaluated. By default, this is turned off.
- Optionally enable Bypass Activation Gates to allow external triggers (including OSC) to run without Activation Phrase or Press and Hold to Recognize.
Once enabled, Action Phrase starts an OSC server that listens for incoming OSC messages. Action Phrase can also send OSC using OSC Message actions.
Messages
OSC messages that Action Phrase responds to are listed below:
| Command | Description |
|---|---|
/actionphrase/listen/start |
Start listening |
/actionphrase/listen/stop |
Stop listening |
/actionphrase/listen/toggle |
Toggle listening on or off |
/actionphrase/evaluate |
Evaluate a phrase from the first OSC argument (requires Evaluate Phrases via OSC) |
/actionphrase/group/[group_identifier]/enable |
Enable a group |
/actionphrase/group/[group_identifier]/disable |
Disable a group |
/actionphrase/group/[group_identifier]/toggle |
Toggle a group |
/actionphrase/action/[action_identifier]/run |
Run an action |
/actionphrase/phrase/[phrase_identifier]/run |
Run a phrase’s enabled actions in order |
/actionphrase/script/teleprompter/scroll/start |
Start teleprompter scrolling |
/actionphrase/script/teleprompter/scroll/pause |
Pause teleprompter scrolling |
/actionphrase/script/teleprompter/scroll/toggle |
Toggle teleprompter scrolling |
/actionphrase/script/teleprompter/scroll/slower |
Decrease teleprompter scroll speed |
/actionphrase/script/teleprompter/scroll/faster |
Increase teleprompter scroll speed |
/actionphrase/script/teleprompter/scroll/rate |
Set teleprompter scroll speed from the first numeric OSC argument (clamped to supported range) |
Action Phrase currently handles OSC messages (not OSC bundles).
Group, Action, and Phrase Identifier
group_identifier, action_identifier, and phrase_identifier can target either:
- The item’s normalized name, or
- The item’s OSC Identifier
Identifier matching is forgiving:
- Paths are normalized (case-insensitive, leading/trailing slashes ignored).
%20,_, and-in identifier path segments are treated as spaces.- Punctuation is ignored during matching, and repeated spaces are collapsed.
For example, Work Projects, work-projects, work_projects, and work%20projects all resolve to the same normalized identifier.
For the most stable remote control setup, use OSC Identifier values and keep them unique.