Content-type: text/html Manpage of MUSE

MUSE

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

NAME

MuSE - Multiple Streaming Engine  

SYNOPSIS

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

 

DESCRIPTION

MuSE is a user friendly application and at the same time a slick commandline tool for mixing, encoding, and network streaming of sound. MuSE can simultaniously mix up to 6 encoded audio inputs from microphone, files or network ogg and mp3 streams. The resulting mixed audio can be played locally on the sound card, saved in a file and/or encoded as an ogg or mp3 stream sent to a broadcast server. MuSE offers two intuitive interfaces (graphical gtk2 and console ncurses) to be operated realtime, while can also run in commandline mode.

In this manual you get explained the latter mentioned commandline mode, usually appealing to unix ascii freaks.

MuSE is being developed in the hope to provide the Free Software Community with a useful and user friendly tool for network audio streaming, making life easier for indypendent 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

 

INPUT CHANNELS OPTIONS

-i --live
mix soundcard live input: capture from mic or line-in - off by default
-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'
files
to append to the current input channel playlist

 

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: 1=mono 2=stereo - default 1
-f --filedump file
dump audio stream to file

 

STREAM OPTIONS

-s --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'
-l --login login type
server login type: [ice1|ice2|icy] - default 'ice2'
-U --user username
account username on the server - default 'source'
-p --pass password
account password on the server
-n --name name
descriptive name of the stream
-u --url url
descriptive url of the stream
-d --desc desc
full description of the stream

 

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

 

SCHEDULER

Depending on the version, MuSE might sport a scheduler allowing you to stream files, URLs, playlists or MuSE channels at specified days & hours. The scheduler can be operated through the GTK interface (other interfaces do not have it yet) or by directly editing the $HOME/.muse/schedule.xml file.

The aforementionned file contains comments explaining all tags, attributes and wildcards supported - use it also as help for editing the schedule through the GUI.

 

BUGS

Bug reporting 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
Eugen Melinte - time program scheduler

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 users and 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 obtained from its homepage at http://muse.dyne.org.


 

Index

NAME
SYNOPSIS
DESCRIPTION
COMMAND LINE USAGE
GENERIC OPTIONS
INPUT CHANNELS OPTIONS
ENCODER OPTIONS
STREAM OPTIONS
INPUT CHANNELS FORMAT
HOW TO LISTEN
COMMANDLINE USAGE EXAMPLES
SCHEDULER
BUGS
AUTHORS
COPYING
AVAILABILITY

This document was created by man2html, using the manual pages.
Time: 13:00:24 GMT, April 15, 2005