MUSE(1)

NAME
MuSE - stream your audio over the internet

SYNOPSIS
muse [ generic opt ] [ [ -N input opt ] files ] [-e [ encoder opt ] [ stream opt ] ]

DESCRIPTION
MuSE is an application for mixing, encoding, and network streaming of sound. MuSE can simultaniously mix up to 6 encoded audio bitstreams (from files or network) plus a souncard input signal. The resulting stream can be played locally on the sound card and/or encoded as an mp3 bitstream sent to a broadcast server. MuSE offers two intuitive interfaces (graphical and console) to be operated realtime and can also run in commandline mode. MuSE is being developed in the hope to provide the Free Software community with a user friendly tool for network audio streaming, making life easier for independent free speech radios.

COMMAND LINE USAGE
Command line options in MuSE are position sensitive: all the encoder options affect the last encoder specified, all the servers are relative to the last encoding specified, all the server options affect the last server specified. In that way you can specify as much encoded streams you want and as much servers you need for each of them. In fact MuSE can stream at multiple bitrates and to multiple servers.

GENERIC OPTIONS

-h --help
    show help

-v --version
    show version information

-D --debug [ num ]
    set debug verbosity level to num between 1 and 3, useful to figure out where is the problem and to file good bug reports, default is 1

-o --dspout
    disable souncard output

-C --cli
    command line input. cli GUI is selected (same as -g cli)

-g --gui name
    specify GUI name to use. Use list to get a list of available GUIs

files
    add files to MuSE playlist

INPUT CHANNELS OPTIONS

-i --live
    mix soundcard live input, capturing from mic or line-in (default off)

-N --number
    set the current input channel number, starting from 1 to 6 (default 1)

Options below affect the current channel specified.

-V --volume
    input channel volume, float from 0.0 to 1.0 (default 1.0)

-S --position
    input channel starting position, float from 0.0 to 1.0 (default 0.0)

-P --playmode
    input channel playmode: play, cont, loop (default cont)

ENCODER OPTIONS

-e --encoder enc
    select enc codec to use. Possible choices are ogg and mp3. default ogg

Options below affect the last enc specified.

-b --bitrate rate
    set codec bitrate in Kbit/s. default 24

-r --frequency freq
    set encoding frequency to freq. Possible choices are 0, 11000, 16000, 22050 or 44100. 0 means auto. default auto

-q --quality qual
    set encoding quality to qual between 0.1 and 9.0 . default 4.0

-c --channels num
    set number of audio channels to use, mono=1 stereo=2 (default 1)

-f --filedump file
    dump audio stream to file

STREAM OPTIONS

--server server[:port]
    send stream to server on port port.
    default port is 8000

Options below affect the last server specified.

-m --mount mountpoint
    use mounpoint mountpoint on server. default live

-p --pass password
    use encoder password password on server

-n --name name
    set name of the stream to name

-u --url url
    set descriptive url of the stream to url

-d --desc desc
    set description of the stream to desc

INPUT CHANNELS FORMAT
MuSE offers a variety of formats for the input channels you are going to play: when compiled with all features it supports Mp3, Ogg/Vorbis, Wav, Aiff, Voc, Snd, Pvf, Mat, Au, Sf audio formats. You can also use playlists with muse: text files which store on each line the location of the file to be queued when playing. To easily generate such a text file you can simply do:
find /my/music/dir/ -name *.ogg > ogg-playlist.pls
and then you can load the 'ogg-playlist.pls generated file to be played by MuSE. Last but not least you can use filesystem directories: if a directory is loaded as an input channel in MuSE, it will be recursively searched and all playable formats inside will be added to the playlist queue.

HOW TO LISTEN
In order to make people able to tune in and listen to your stream, you should communicate your listeners the URL of your network radio. That is formed by elements of the options that you are using: the server, the port (which defaults to 8000) and the mountpoint. Therefore a muse commandline containing the options
[...] -s stream.dyne.org:7090 -m my-radio.ogg
will be available to be listened at the URL http://stream.dyne.org:7090/my-radio.ogg which should be simply typed in the 'Open Location' dialog of most audio players.

COMMANDLINE USAGE EXAMPLES
muse -C -i -N1 -V0.5 test.wav -N2 -V0.7 test.ogg -e ogg -f record.ogg -s stream.dyne.org -m muse-example.ogg -l ice2 -p hackme
The above command starts muse in commandline mode, recording from the soundcard input and continuously mixing two channes over it: the first playing test.wav at half volume, the second test.ogg at slightly higher volume. The resulting audio is then encoded in Ogg/Vorbis format and simultaneously recorder in the record.ogg file and streamed to the stream.dyne.org server, using mountpoint 'muse-example' and the icecast2 type login password 'hackme'. The stream will be available at the url http://stream.dyne.org:8000/muse-example.ogg
muse -C playlist.pls -e ogg -s stream.dyne.org:6969 -m my-music -l ice2 -p hackme
The above (simplier) command plays continuously all files listed in the playlist.pls files, encoding them in Ogg/Vorbis and streaming them to stream.dyne.org (port 6969) icecast2 server on mountpoint my-music with password hackme. The listening URL for the stream will therefore be http://stream.dyne.org:6969/my-music - you can also avoid to listen the music being streamed on your computer by using the -o flag at the very beginning of the commandline.

BUGS
Bugreporting is very welcome, especially if you know how to use the
CVS version of this software. The sourcecode comes with memory fencing
(dmalloc) and profiling functionalities, more information on how to
download from CVS is available on the website muse.dyne.org.
When you have a bugreport, complete with debug logs (using the
-D3 flag) and possibly with the gdb backtraces you can submit it
in the bugtracker system on http://bugs.dyne.org.
Thanks much for your collaboration, we need expert people to
consciously follow development and bugfixing: you can surely do if you
understood all the above ;)

AUTHORS
Denis "jaromil" Rojo - author and mantainer rastasoft.org
Antonino "nightolo" Radici - GTK+ interface freaknet.org
Luca "rubik" Profico - NCURSES interface olografix.org
Angelo "pallotron" Failla - more input channels freaknet.org
a full list of developers can be found in the AUTHOR file
This manual page was written by Filippo "godog" Giunchedi and further
edited by jaromil.
Join and write the mailinglist on lists.dyne.org/muse to contact
developers.

COPYING
Permission is granted to copy, distribute and/or modify this manual under the terms of the GNU Free Documentation License, Version 1.1 or any later version published by the Free Software Foundation; Permission is granted to make and distribute verbatim copies of this manual page provided the above copyright notice and this permission notice are preserved on all copies. -- MuSE source code is free software; you can redistribute it and/or modify it under the terms of the GNU Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. MuSE source code is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. Please refer to the GNU Public License for more details. You should have received a copy of the GNU Public License along with this source code; if not, write to: Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.

AVAILABILITY
The most recent version of MuSE can be attained from its homepage at http://muse.dyne.org.