TINYWOLF(1)

2023-11-18

NAME

Tinywolf - central OSC router

SYNOPSIS

tinywolf [-c <config.yml>] [-p <port>] [--verbosity <level>]

DESCRIPTION

Tinywolf is a central router for OSC messages. It forwards the incoming messages to the device specified through the OSC address.

A device name is simply the first part of the OSC address of a message. It will be removed in the forwarded message. For example the address "/bespoke/controller1/button00" has the device name "bespoke". The forwarded message will contain the OSC address "/controller1/button00".

The options are as follows:

-c, --config <config.yml>

Specify the config file to use. This option defaults to "tinywolf.yml". The format for the config file is described in the tinywolf(5) manual page. This file defines the application's behavior.

-h, --help

Show help message and quit.

-p, --port <port>

Set the port to use for listening to OSC messages (via UDP). This option defaults to 9001. If specified, the value present in the configuration file will be overridden.

--verbosity <level>

Set the level of verbosity. This option defaults to 2. If specified, the value present in the configuration file will be overridden.

--version

Print the version information and exit.

EXIT STATUS

Tinywolf exits with 0 on a successful shutdown, and with >0 if an error occurs.

SEE ALSO

tinywolf(5)

AUTHORS

Created and maintained by Hannes Braun <hannes@hannesbraun.net>. Up-to-date sources can be found at https://git.sr.ht/~hannes/tinywolf. Bugs and patches can be submitted by email to ~hannes/public-inbox@lists.sr.ht.

BUGS

As of now, OSC bundles are not supported by Tinywolf.