summaryrefslogtreecommitdiff
path: root/source/ap/soma/README
blob: 7a882b912839521c5d9c3ca639d20d490bbd1ad3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
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
  F1-F12 Bookmarks                       `  Volume 0
  Space  Pause
  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.