diff options
Diffstat (limited to 'source/ap/soma/README')
| -rw-r--r-- | source/ap/soma/README | 106 |
1 files changed, 67 insertions, 39 deletions
diff --git a/source/ap/soma/README b/source/ap/soma/README index d63eb8d3..20299b6f 100644 --- a/source/ap/soma/README +++ b/source/ap/soma/README @@ -1,74 +1,102 @@ Soma - a dialog internet radio player -For help/usage see soma -h +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. -Soma started off as a way to play .pls playlists from SomaFM but can -also play .ram playlists too. In fact any url playable by mplayer -using the -playlist option should work. Extra stations can be added -in ~/.soma/stations.conf (up to 200). +Startup Flags: -Soma uses mplayer to play the streams and aplay to detect cards for -mixer so mplayer and alsa-utils need to be installed. + 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: -( Volume -5 -) Volume +5 -1 - 0 Volume 10%, 20%, ... 100% (saved) -Space Pause/Play -d Disconnect/Reconnect -a Add schedule -b Station browser -m Mute toggle -s Scheduler -q Quit + 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: -There are 3 config files: + r Open recording menu R Start/Stop recording -~/.soma/themes/*rcrc Specify the dialog colours. -~/.soma/options.conf A few extra options. -~/.soma/stations.conf User station list. +Dashboard indicators: -There are also: +[S] Schedules are set [-] Schedules are temporarily disabled +[R] A recording is in progress [0-100] Volume or [M] Mute -/etc/soma/options.conf Default options. -/etc/soma/themes/*rc Dialog configs. -/etc/soma/stations.conf Default station list. +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 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 exra radio urls emailed to me so I can add to +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. +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. +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. +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: +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. +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. +Please mail me at dave@dawoodfall.net for new radio urls or bug reports etc. |