Custom & Macro OSC

Send an arbitrary OSC message to any device on the network straight from KLANG:app — and
save it into one of eight reusable Macro OSC slots. It’s the in-app equivalent of our
KLANGosc command-line tool: build a message field by field, watch the exact command
preview update live, then fire it with one click.

There are three ways to reach the CUSTOM & MACRO OSC dialog

Path	Where
CONFIG ▸ APP ▸ Custom & Macro OSC ▸ Edit & Send	Main settings
CONFIG ▸ INFO ▸ Set Menu ▸ Send Custom OSC Message	Info / Set menu
Keyboard shortcut	Mac: CMD + Shift + O Windows: Ctrl + Shift + O

The dialog reopens on the slot you last used, so your most recent macro is one shortcut away.

Macro OSC Slot

A dropdown listing all 8 macro slots. Each entry shows its number and name, e.g.
8 | TEST, or <EMPTY> for an unused slot. Selecting a saved slot loads its stored
message into all the fields below. Selecting the blank top entry () leaves the current
fields untouched so you can compose a one-off message without overwriting a slot.

Macro OSC Name

A friendly label for the macro (e.g. TEST). This is what’s shown in the slot dropdown and
makes a saved macro easy to recognise later. It is not part of the OSC message itself.

Target IP Address

The destination device. Enter an IPv4 address (e.g. 10.10.10.10) or one of the
built-in aliases. An alias resolves to the right address automatically and, in most cases,
overwrites the Receive Port for you:

Alias	Resolves to	Forces port	OSC address rewrite
processor	The connected processor’s IP	9110	—
kontroller	The connected KLANG:kontroller’s IP	9111	—
app	The connected KLANG:app’s IP	9111	—
thisapp	127.0.0.1 (this computer)	This app’s own receive port	—
localhost	127.0.0.1	Keeps the port you typed	—
console	The remote console’s IP	The remote console’s port	—
broadcast	<broadcast IPs>	Only active when port = 9111	Prefixes /Ka/ToBroadcast/ (e.g. /test → /Ka/ToBroadcast/test)
others	The connected processor’s IP	Keeps the port you typed	Prefixes /Ka/ToOthers/ (e.g. /test → /Ka/ToOthers/test)

If you leave Target IP Address empty, it defaults to the connected processor’s IP. The
default value when you open a fresh dialog is processor.

Receive Port

The UDP port the target is listening on (e.g. 9110). Heads-up: if you used an IP
alias above, that alias overwrites this field on send — so for processor/kontroller/app
you don’t need to set the port yourself. Use a literal IP if you want full manual control of
the port.

OSC Address

The OSC address pattern of your message, e.g. /test. Must start with /. See
klang.com/osc for the full address reference.

Argument Type

Choose what kind of value (if any) the message carries:

Option	Sends
no Argument	Address only, no value
i = Int	A single integer
f = Float	A single float
s = String	A single string
T = bool true	OSC boolean true (no value needed)
F = bool false	OSC boolean false (no value needed)

For no Argument, T and F, the Argument field is ignored.

Argument

The value itself — an integer, float, or string depending on the type above (e.g. 10).
Strings don’t need quotes here.

Command preview

Just above the buttons, the dialog prints the exact KLANGosc command your settings produce, with all aliases already resolved, e.g.:

KLANGosc 10.10.10.10 9110 /test i 11

This is the same syntax our command-line tool uses, so you can copy a working message
straight out of the app into a script or terminal.

Button	What it does
Cancel	Closes the dialog without sending or saving.
OSC Help	Opens the OSC documentation at klang.com/osc.
Save Macro	Stores the current name + message into the selected slot, then reopens the dialog. Does not send.
Delete Macro	Clears the selected slot and reopens the dialog.
Save & SEND	Saves the current settings to the slot and sends the OSC message immediately. Also bound to the Return key.

Mute-style integer to the processor

Field	Value
Target IP Address	processor
Receive Port	(auto → 9110)
OSC Address	/test
Argument Type	i = Int
Argument	1

Preview: KLANGosc <processor-ip> 9110 /test i 1