roartips7

Usage

Overview

This manpage lists some tips for intermedia to advanced users of RoarAudio.

Controlling roard

RoarAudio supports a lot of things you can change on the fly. This includes the volume for each stream as you may already noticed: If you cange the volume within a player only this stream is changed, other streams keep there loudness. There a a lot other things that can be changed on the fly. To do this there is a tool called roarctl(1). You may want to play around a bit with it. A good start are to try those two commands:
roarctl --help
roarctl allinfo

The later one will show you all information current available of the server it self, the clients and the streams. This may include a lot of information.

Server address

There a serverel types of server addresses based on the protocol used to communicate. This lists the corrently implemented types in order of importance:

/path/to/sock

Path to UNIX Domain Socket. Example:
/tmp/roar

host, host:port

This is used for connections over TCP/IP. If port is omitted the default port is used. Examples:
audio.homeserver.local
localhost:7564

node::, node::object, ::object, ::

This is the way to specify a DECnet connection to node node's object object. Both may be omitted to use defaults. Default node name is local hosts node name. Examples:
mynode::
::roar
yournode::yourroard

+fork

This starts a new roard for every roar_connect(3). This is used internaly by the lib to emulate EsounD's fallback.

Environment

ROAR_SERVER

This variable contains the default server address. If some client does not allow a user to set a server address or to set a default value this one come into play. Examples:
ROAR_SERVER=some.host
ROAR_SERVER=another.host:port
ROAR_SERVER=node::
ROAR_SERVER=/tmp/roar