path: root/source/ap/soma/README

Soma - a dialog internet radio player

Soma is an internet stream audio player.  Any URL playable by mplayer
with or without the -playlist option should work.  Extra stations can
be added in ~/.soma/stations.conf.

Startup Flags:

  soma -l             Go straight to bookmarks list
  soma -b             Go straight to stations browser for genre
  soma -B             Go straight to all stations browser
  soma -g             Go straight to local genre browser
  soma -G             Go straight to global genre browser
  soma -d             To start in debug mode
  soma -h             Help
  soma --record-info  Detailed recording info

  Config Files and Directories:

  User:                        Global:

  ~/.soma/options.conf         /etc/soma/options.conf
  ~/.soma/stations.conf        /etc/soma/stations.conf
  ~/.soma/themes/*rc           /etc/soma/themes/*rc
  ~/.soma/genres/*.conf        /etc/soma/genres/*.conf
  ~/.soma/bookmarks.conf
  ~/.soma/schedules.conf
  ~/.soma/recordings/

Key commands supported in status window:

  1 - 0  Volume 10% - 100%               () Volume -5/+5
  Space  Pause                           `  Volume 0
  a      Add schedule                    A  Toggle audio codec info
  b      Station browser (genre)         B  Station browser (all)
  d      Disconnect/Reconnect/Play/Stop  D  Toggle debug mode
  g      List genres                     h  List local genres
  j      Add station to current genre    k  Bookmark current station
  l      Open bookmark list              m  Toggle mute
  o      Options menu                    q  Quit
  s      Scheduler menu                  S  Toggle schedules on/off
  t      Change theme                    ?  Show keys

  Recording:

  r      Open recording menu             R Start/Stop recording

Dashboard indicators:

[S] Schedules are set                   [-] Schedules are temporarily disabled
[R] A recording is in progress          [0-100] Volume or [M] Mute

Config Files:

User:                        Global:

~/.soma/options.conf         /etc/soma/options.conf
~/.soma/stations.conf        /etc/soma/stations.conf
~/.soma/bookmarks.conf       /etc/soma/themes/*rc
~/.soma/themes/*rc           /etc/soma/genres/*.conf
~/.soma/genres/*.conf
~/.soma/schedules.conf

Stations should be added to the user list like this:

Name,URL

You cannot use a comma , in the name or the URL.

User stations are listed before global in all stations list.  Custom genre and
theme files can be made and will be listed along with the default set.

I would be glad of any extra radio urls emailed to me so I can add to
the default list.

NOTES:

The Jack and NAS options for output device will only work if MPlayer is built
against them.

When changing/selecting soundcard output device you must press space on the
option.  Just scrolling down and hitting Enter does nothing.

BUGS:

Soma may induce the side effects of general well-being and profound spiritual
satisfaction.

http://en.wikipedia.org/wiki/Soma
http://en.wikipedia.org/wiki/Soma_(Brave_New_World)

REAL BUGS:

Some people might find screen messes up the dialog colours.  If you have this
line in ~/.screenrc:

attrcolor b ".I"

You might want to comment it out and try again as it seems to turn off the bold
attribute.  See the screen man page for more info.

Please mail me at dave@dawoodfall.net for new radio urls or bug reports etc.