somaplayer - the default player for soma

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

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.

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

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

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

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.

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)

somaplayer_controller(1), sdsvumeter(1), somad(1), somaclient(1), somacheck(1)

Somaplayer written by Andrea Marchesini <bakunin@autistici.org>
Man page written by Joshua Eichen <joshua@bitmine.net.net>
                 and Andrea Marchesini <bakunin@autistici.org>

You can download the newest version to http://soma.realityhacking.org

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 (c) 2003, 2004 Andrea Marchesini