somaplayer

Langue: en

Version: OCTOBER 2004 (mandriva - 01/05/08)

Section: 1 (Commandes utilisateur)

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