Content-type: text/html Manpage of MUSE


Section: User Manuals (1)
Updated: April 2004
Index Return to Main Contents


MuSE - stream your audio over the internet  


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



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 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.



-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
add files to MuSE playlist



-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)



-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



--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



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.



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 FIserverFP, the FIportFP (which defaults to 8000) and the FImountpointFP.

Therefore a muse commandline containing the options
[...] -s -m my-radio.ogg
will be available to be listened at the URL which should be simply typed in the 'Open Location' dialog of most audio players.



muse -C -i -N1 -V0.5 test.wav -N2 -V0.7 test.ogg -e ogg -f record.ogg -s -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 server, using mountpoint 'muse-example' and the icecast2 type login password 'hackme'. The stream will be available at the url
muse -C playlist.pls -e ogg -s -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 (port 6969) icecast2 server on mountpoint my-music with password hackme. The listening URL for the stream will therefore be - 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.



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

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

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 ;)



Denis "jaromil" Rojo - author and mantainer
Antonino "nightolo" Radici - GTK+ interface
Luca "rubik" Profico - NCURSES interface
Angelo "pallotron" Failla - more input channels

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 to contact



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.



The most recent version of MuSE can be attained from its homepage at




This document was created by man2html, using the manual pages.
Time: 13:49:09 GMT, April 21, 2004