ampOSC manual

The panel

Click the ampOSC icon in the menu bar and everything the app knows is in one panel. There is no other window except the log, and nothing is hidden behind a preferences dialog.

The whole interface. Two connections, three numbers — and Subscriptions reading ALL, which is flood mode rather than a fault.

The two rows

Each row is a connection, with a status dot on the left and a gear on the right.

  • OSC Server — the address and port your clients connect to. Green means the server is listening. The gear opens the server settings.
  • The console — named for the profile in use, with a family badge (dLive, Avantis, SQ, SQ+) and the console's IP underneath. Green means the MIDI TCP connection is up. The gear opens the console settings.

The name on the console row comes from the desk itself once connected. Before that, ampOSC listens for consoles announcing themselves on the network and uses that name if the address you typed matches one. Custom means neither has happened yet — the address is set but nothing has identified itself. It is not an error, and it changes to the console's own name as soon as one answers.

The three counts

Under the console row are three tiles. They are the fastest diagnosis in the app, and a tile outlines green once it is non-zero.

CountWhat it meansZero means
Inventory Channels discovered on the console The console is not really connected, whatever the dot says
Clients OSC clients that have sent at least one message Nothing has reached the server — check the port and the firewall
Subscriptions Parameters clients are being kept up to date on Nobody has subscribed yet. In flood mode the tile reads ALL instead of a number, because subscriptions are not used at all

Each tile is also a button. Inventory opens the channel browser, Clients lists who is connected and how many subscriptions each holds, and Subscriptions opens the subscription list.

Reading it at a glance

These are the three pictures worth recognising.

InventoryClientsWhat is happening
Hundreds0 Normal before a show. The desk is found; nothing is listening yet
0Anything Always a problem. Nothing can be addressed until the inventory is built
Hundreds1 or more Working. Open the log to watch it

Clients at zero with the inventory in the hundreds is the normal picture before a show. Inventory at zero is never normal.

Log, Help and Quit

Three buttons along the bottom.

  • Log opens the floating log window.
  • Help opens the Help window, which carries a short example list and can save the bundled Quick Start and OSC Reference to disk.
  • Quit ⌘Q stops the OSC server and closes the console connection. There is no background mode — quitting means quitting.