somaplayer(1)

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)

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.

docs.sk

comprehensive documentation repository

See also