View on GitHub

oscdump

A simple command-line OSC server

OSC Dump

This is a simple command-line tool that serves as an OSC server, dumping everything it receives from an OSC client to the screen (STDOUT). Good for testing.

It comes almost entirely from one of the examples in the go-osc package. I made a few changes and created this repository to make it easy to download and use for anyone (not just Go programmers).

Installation

  1. Download the appropriate archive file from the Releases page.
  2. Place the oscdump executable somewhere in your path
  3. Open a terminal window. (On MacOS, use the Terminal app. On Windows, you might need to download Windows Terminal from Microsoft.)
  4. Execute the command using the instructions below

Or, if you have go installed you can just type:

go install github.com/rahji/oscdump@latest

Usage

On Your Computer

Open a terminal window and run the command like so:

./oscdump 192.168.4.20 8000

(Use your own IP address, of course).

On Your Phone or Another Computer

  1. Start an OSC client application (TouchOSC mk1, MultiSense OSC, etc.)
  2. Verify that the app’s settings for the server IP address and port match what you typed above.

You should start seeing OSC messages printed on the screen from the client.

To Quit

Press Ctrl-C to quit the program.

License

MIT: Same as the go-osc license.