.\" muroarstream.1:

.TH "muroarstream" "1" "22 February 2010" "muRoar" "System User's Manual: muroarstream"

.SH NAME

muroarstream \- Simple RoarAudio client

.SH SYNOPSIS

muroarstream [OPTIONS]

.SH DESCRIPTION

muroarstream is a simple client for the RoarAudio sound system.
It is based on muRoar (libmuroar).
It can only be used to send data to or get data from the server.
No control functionality is supported.

.SH "OPTIONS"

.TP
\fB--help\fR
Display a brief help.

.TP
\fB-f \-\-file     FILE\fR
Sets the file to read from or write to.

.TP
\fB--server   SERVER\fR
Sets the server to SERVER.
Default is to auto detect the server. (see below)

.TP
\fB-R \-\-rate     RATE\fR
Sets the sample rate.
This defaults to 44100Hz.

.TP
\fB-C \-\-channels CHANS\fR
Sets the number of channels.
this defaults to 2 channels (stereo).
Symbolic names "mono" and "stereo" as well as "default" can be used.

.TP
\fB-B \-\-bits     BITS\fR
Sets the number of bits per sample.
The default is 16bit per sample.

.TP
\fB-E \-\-codec    CODEC\fR
Sets the codec to use.
The default depends on used subsystem.
For Waveform it uses Signed native PCM, for Light DMX512 and for MIDI MIDI.
The following symbolic names can be used:
default, pcm, pcm_s, pcm_u, ogg_vorbis, vorbis, alaw, mulaw, ulaw, dmx512, roardmx, midi.
.TP
\fB--play\fR
Use Playback mode (send data to the server).
This is the default.

.TP
\fB--monitor\fR
Use monitor mode (get a copy of the played data from the server).

.TP
\fB--wave\fR
Use Waveform subsystem (default).

.TP
\fB--midi\fR
Use MIDI subsystem.

.TP
\fB--light\fR
Use Light Control subsystem.

.SH "AUTO DETECTION"
The server will be auto located if no server name is given.
First it will look for the environment variable $ROAR_SERVER.
If this variable is non existing libmuroar will do the
auto location based on a list of possible server locations.
This list contains the user's private socket address,
the global UNIX socket address, an entry for localhost using TCP/IP,
the local default DECnet object address as well as an entry for the
abstract UNIX namespace (+abstract).

.SH "SEE ALSO"
\fBroarcat\fR(1),
\fBRoarAudio\fR(7).

.\" ll