oscope
v0.2.0
Published
Simple command line tool for testing and interacting with OSC (Open Sound Control) messages
Downloads
3
Readme
oScope, the OSC scope
This is a command line utility for sending and receiving Open Sound Control messages. This can be useful for debugging and testing.
It's currently in an early release—if you see something missing, please reach out!
Installation
You can use it two ways. Both require you to have Node.js installed.
If you want to install the tool so you can have it available in your path, run:
npm install -g oscope
#Then run it with
oscope <command> [options...]
A simpler solution is to run it with NPX like so:
npx oscope <command> [options...]
Usage
Currently, oscope can be used with two commands, listen
and talk
. Both take a UDP address as an argument.
Address Patterns
Addresses consist of a hostname and a port such as 127.0.0.1:8000
or localhost:1234
. A port by itself (such as 8888
) is also allowed.
listen
oscope listen <address>
This opens a connection at the given local address and prints the contents of any OSC messages received. If only the port is specified, then it listens for messages sent to that port on all addresses.
talk
oscope talk <address>
This opens a connection to a piece of software at a given remote address. You can use the command line to send messages to that program and then view any messages sent in response on the console.