oscope v0.2.0

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.