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, enable/disable groups, and evaluate phrases.
Enabling OSC
- Go to Action Phrase home.
- Tap the More menu.
- Choose Settings.
- Tap Remote Control.
- Turn on Enable OSC.
- Specify the OSC Port (default 49999).
- The port must be within the range 1024–65535.
- Use the listed IP Addresses to determine which interface your device is using.
- Optionally enable Evaluate Phrases via OSC to let OSC receive phrases and have them evaluated. By default, this is turned off.
- Optionally enable Bypass Activation Gates to allow phrases to be evaluated without being gated by the Activation Phrase or Press and Hold to Recognize preferences.
Once enabled, Action Phrase starts an OSC server that listens for incoming messages and can send OSC messages from any configured OSC Message action.
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. The parameter is a string that is the phrase to evaluate in the app |
/actionphrase/[group_name]/enable |
Enable a group |
/actionphrase/[group_name]/disable |
Disable a group |
/actionphrase/[group_name]/toggle |
Toggle a group |
Group Name
The group_name is a unique identifier for a group. You can use either the unique id of the group or the name of the group, normalized by lowercasing the group name, removing punctuation and ,replacing spaces with dashes.
Make sure that all your groups have distinct names if you plan to use the normalized group name to target your groups via OSC.