splayer1

The default player for soma

Overview

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)

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: [email protected] 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 [email protected]. This is helpful place for bug reports.