NAME
somaplayer - the default player for soma
SYNOPSIS
somaplayer [-ao output [-ad option ]] [-no] [-cd] [-dsp] [-z] [-r] [-g]
[-nr] [-nb] [-tf] [-so] [-b buffersize ] [-nv] [-v volume ] [-m] [-a
option file stream directory ...
DESCRIPTION
somaplayer is music player for MP3, Ogg, wav, audio CDs, MP3 streams,
and Ogg streams. It is able to use the appropriate sound drivers or
demons or to stream directly to an Icecast server (Icecast2 or
SHOUTcast) or to encode in MP3 and Ogg Vorbis. It also acts as a sound
daemon that is able to accept connections from other somaplayers or any
other sound player (xmms, mpg123, and others) thanks to a special
wrapper.
OPTIONS
-ao, --audiooutput
Add an audio output. You can select one of the following: audio
oss alsa alsa09 esd sun arts stdout null wav aiff au raw paf svx
nist voc ircam w64 mat4 mat5 pvf xi htk icecast icecast2
shoutcast lame vorbis sds
-ad, --audiodevice
The options for your audio output.
-no, --nooutput
no audio output.
-cd, --cdromdevice
Set your cdrom device.
-dsp, --devicedsp
Set your dsp device.
-z, --random
Somaplayer will randomly play the selected files and streams.
-r, --repeat
Somaplayer will repeatedly played the selected files and
streams. A file or stream will not be played again until all
files and streams are played first.
-b, --buffer
Somaplayer buffers the file or stream into memory. Somaplayer
accepts bBkKmM. You can use any of these in combination. For
example to have play buffer 3 Meg and 12 Kilobytes in memory you
would us 3m12k.
-nb, --nobuffer
Somaplayer decodes directly the file (or the stream) without a
internal buffer.
-tf, --timeforced
Set the output time as the real time of the input
-nr, --norealtime
No check for output realtime.
-so, --splitoutput
stop and start the single outputs when change the song.
-blt, --badlist_timer
how many seconds between one retry and the next one. [greater
then 0] default 5.
-blmr, --badlist_max_retry
how many retry for output problems. [-1 always | 0 disactivated]
default 5.
-nv, --noverbose
No verbose output.
-g, --graphic
active the gtk interface
-v, --volume
Somaplayer can change it is playing at from 0 to 100%.
Somaplayer accepts an integer from 0 to 100.
-m,--mic
Get data from microphone or line-in. You can set some flags.
Read after.
-s,--sds
Get data from a SdS [type://server[:port]]. The types are: unix
socket or tcp socket. If your write tcp is like tcp://localhost,
if unix, somaplayer searchs the sds and uses it.
-d,--daemon
Somaplayer runs as SdS. Read after.
-a,--admin
Active the admin interface with unix/tcp socket. Read after.
-h, --help
Output a short summary of available command line options.
Keyboard Control
These are the controls for while somaplayer is running in text mode.
V increase volume 1%
v decrease volume 1%
m volume 0%
M volume 100%
b balance 1% to the left
B balance 1% to the right
c/C balance center
l all on the left
L all on the right
s/S save the configuration
r/R repeatedly play selected files and streams
z/Z randomly play selected files and streams
q quit
space pause
enter next song
t active silence trimming
T disactive silence trimming
I active the microphone input
i disactive the microphone input
A active realtime ouput
a disactive realtime ouput
OUTPUTS
The default audio is "audio". So you can run: ’somaplayer file.mp3’
Test your audio device with somaplayer_configure. This software set the
default audio output in somaplayer configure file.
You can set more one outputs in the same time. For example: ’somaplayer
-ao wav -ad test.wav -ao audio -ao aiff -ad test.aiff input.mp3
input.ogg’
The outputs that write a file, make file with this name: file1.mp3
file2.mp3 file3.mp3 and so on...
audio no options
oss/alsa/alsa09/esd/arts/sun/irix
dsp device/audio server (optional) Ex: somaplayer -ao oss -ad
/dev/dsp ...
null/output
no options
wav/aiff/au/raw/paf/svx/nist/voc/ircam/w64/mat4/mat5/pvf/xi/htk
the output file. Ex: somaplayer -ao aiff -ad test.aiff ...
icecast
The options are:
rate output rate - default 22050
bitrate
set the output bitrate - default 24
channels
set the output channels (1 or 2) default: 1
server icecast server. You can do:
’server=http://server.net:8000/yourradio’ and no set port
and mount point. The server can be ipv6 or https.
password
server password
mount your radio mount point
name the name of your radio
port server port
port your radio is public ? ’false’ or ’true’ default: true
description
radio description
dumpfilelocal
if you want a copy of your stream, set the output file
dumpfileremote
dump remote file on the server
genre your genre
highpass
high pass - default: 0
lowpass
low pass - default: 0
quality
encode quality - default: 8
url web site of your radio
Example:
somaplayer -ao icecast -ad
’server=http://server.net:8000/yourradio,genre=rock,url=www.myradio.net
-m
You can write everything in a file like this:
description = "my radio!"
rate = 44100
quality = 8
server = server.net
port = 8000
url = "http://your.website.info"
...
and run somaplayer like it:
somaplayer -ao icecast -ad yourfile -m
icecast2
the same options of icecast:
no dumpfileremote
type m/o or M/O (Mp3 or OGG) - default: o
shoutcast
the same options of icecast:
no dumpfileremote and no description
aim your aim info
irc your irc info
icq your icq info
lame encode a mp3 file
file output file
rate output rate - default: 44100
quality
output quality - default: 8
bitrate
output bitrate - default: 96
channels
output bitrate - default: 2
lowpass
output lowpass - default: 0
highpass
output highpass - default: 0
Example:
somaplayer -ao lame -ad file=/tmp/test.mp3,rate=22050,channels=1
-m
You can write everything in a file like this:
rate = 44100
quality = 8
file = /tmp/test.mp3
...
and run somaplayer like it:
somaplayer -ao lame -ad yourfile -m.PP
ogg encode a ogg file like lame
sds the options are:
listen number of client in the same time
interface
if you want bind the connection on special interface
[default: 0.0.0.0]
ipv6 open a connection on ipv6
port if you don’t want the standard port [default: 12321]
type unix or tcp socket.
SDS
When somaplayer run with ’-d’ or ’--daemon’ flags, it starts as daemon
sound. The outputs sintax is the same, but changes the functions. A
daemon sound gets some audio inputs and does some outputs (like
somaplayer). So you can connect X somaplayers to an SdS and it mixs the
inputs. You can set some values to the daemon:
somaplayer -d type=u,socket=/tmp/test
The values are:
type U/T or u/t for unix or tcp socket
listen if you want accept a different number of connection in the same
time (default: 100)
interface
if you want bind the socket on a interface (only for tcp socket)
port if you want open a no standard port (default: 12321 - only for
tcp socket)
socket if you want bind the unix socket to a no standard file (default:
/tmp/somaplayer-PID.sock - only for unix socket)
ipv6 IPv6 support
In graphic interface you can active crossfade of volumes, balance,
autofader, solo, mute and so on.
ADMIN INTERFACE
With -a or --admin you can active the admin interface with unix/tcp
socket. The parameter are:
type U/T or u/t for unix or tcp socket
listen if you want accept a different number of connection in the same
time (default: 5)
interface
if you want bind the socket on a interface (only for tcp socket)
port if you want open a no standard port (default: 12421 - only for
tcp socket)
socket if you want bind the unix socket to a no standard file (default:
/tmp/somaplayer-PID.sock - only for unix socket)
SEE ALSO
somaplayer_controller(1), sdsvumeter(1), somad(1), somaclient(1),
somacheck(1)
AUTHOR
Somaplayer written by Andrea Marchesini <bakunin@autistici.org>
Man page written by Joshua Eichen <joshua@bitmine.net.net>
and Andrea Marchesini <bakunin@autistici.org>
OBTAINING
You can download the newest version to http://soma.realityhacking.org
MAILING LIST
There is a soma suite mailing list, to subscribe simply send a e-mail
to: soma@inventati.org with only the words "subscribe soma" in the
body. You will recive another mail to confirm this and once you have
replied you can post to the list by sending e-mail to
soma@inventati.org. This is helpful place for bug reports.
COPYRIGHT
Copyright (c) 2003, 2004 Andrea Marchesini