public
Description: Lightweight console-based radio player for Last.FM radio streams.
Homepage: http://nex.scrapping.cc/code/shell-fm/
Clone URL: git://github.com/jkramer/shell-fm.git
Search Repo:
Added updated manual from Wirt Wolff.
jkramer (author)
Sat Jul 12 03:49:39 -0700 2008
commit  d278d1805b1cb35a06f7405713b33e27eba924d8
tree    9a048f29152cc08566d42e2e1409111eff8a7c00
parent  b229ce936ccbf24f36449045d0dc7e70190baad8
...
36
37
38
39
 
 
40
41
42
...
93
94
95
96
 
 
 
 
 
 
97
98
99
...
108
109
110
111
112
113
114
115
116
117
118
119
...
125
126
127
128
 
129
130
131
...
137
138
139
140
 
141
142
143
...
165
166
167
168
169
170
171
172
173
...
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
...
264
265
266
267
268
269
270
271
272
...
355
356
357
358
 
359
360
 
 
 
361
362
363
...
431
432
433
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
434
435
436
...
36
37
38
 
39
40
41
42
43
...
94
95
96
 
97
98
99
100
101
102
103
104
105
...
114
115
116
 
 
 
 
 
 
117
118
119
...
125
126
127
 
128
129
130
131
...
137
138
139
 
140
141
142
143
...
165
166
167
 
 
 
168
169
170
...
207
208
209
 
 
 
 
 
 
 
 
 
210
211
212
...
252
253
254
 
 
 
255
256
257
...
340
341
342
 
343
344
 
345
346
347
348
349
350
...
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
0
@@ -36,7 +36,8 @@ Make shell-fm use the given host as proxy server for HTTP requests.
0
 Print help text and exit.
0
 .TP
0
 .B lastfm://...
0
-URI of a Last.FM radio stream to play after startup.
0
+URI of a Last.FM radio stream to play after startup.
0
+For example: `shell-fm -d lastfm://artist/The%20Beatles/similarartists'
0
 .SH USAGE
0
 On startup, shell-fm will ask you for your Last.FM login and password
0
 (if not
0
@@ -93,7 +94,12 @@ Quit.
0
 .B r
0
 Change radio station. This will prompt you for an Last.FM radio station URI.
0
 The tabulator key helps if you don't know what to type. Arrow-Up and Arrow-Down
0
-allow you to browse your radio history.
0
+allow you to browse your radio history. Enter these without the
0
+"lastfm://" prefix.
0
+.RS
0
+.PP
0
+For example: `radio url> globaltags/world'
0
+.RE
0
 .TP
0
 .B R
0
 Recommend the currently played track/artist/album to another Last.FM user.
0
@@ -108,12 +114,6 @@ Jump to the similar artists radio stream of the currently played tracks artist.
0
 Tag the currently played track/artist/album. Tabulator key completes known
0
 tags.
0
 .TP
0
-.B U
0
-Unlove the currently played track.
0
-.TP
0
-.B u
0
-Print upcoming tracks in playlist.
0
-.TP
0
 .B +
0
 Increase volume (vol).
0
 .TP
0
@@ -125,7 +125,7 @@ Decrease volume (vol).
0
 .TP
0
 .B /
0
 Decrease volume (pcm).
0
-.TP
0
+.PP
0
 .SH SETUP
0
 Before you start, you should have created the directories
0
 .B ~/.shell-fm
0
@@ -137,7 +137,7 @@ You might also want to place a configuration file in
0
 .B ~/.shell-fm
0
 for a faster startup.
0
 .SH CONFIGURATION
0
-This section describes the syntax an options for the shell-fm configuration
0
+This section describes the syntax and options for the shell-fm configuration
0
 file. The file should be placed in
0
 .B ~/.shell-fm/shell-fm.rc
0
 and should consist of simple
0
@@ -165,9 +165,6 @@ track into the given file, whenever a new track is played.
0
 .B np-file-format = format-string
0
 This defines how the information written to your now-playing file will look
0
 like. There are several format flags available. Have a look at the
0
-.TP
0
-.B preview-format = format-string
0
-Format of the track information in the playlist preview (key 'u').
0
 .B FORMAT FLAGS
0
 section for the details.
0
 .TP
0
@@ -210,15 +207,6 @@ shell-fm remotely (or from local scripts, see
0
 above). Check the
0
 .B NETWORK INTERFACE COMMANDS
0
 section below for a list of known commands.
0
-.B NOTE:
0
-The network interface has no user authentication, so anyone with access to your
0
-network/host can control shell-fm. Use it only if you really need to control
0
-shell-fm over a network. Otherwise use the UNIX socket interface (see below).
0
-.TP
0
-.B unix = path
0
-If this is set to a proper path, on that path a UNIX socket will be created for
0
-local "remote" control. This socket interface takes the same commands as the
0
-TCP socket interface (see above).
0
 .TP
0
 .B port = port-number
0
 With this option you can change the port shell-fm will listen on (if
0
@@ -264,9 +252,6 @@ specified in the scrobbling protocol version 1.2.
0
 If this is set to anything, and you change the station with 'r', 's' or 'f',
0
 the station-change will be delayed until the currently played track finishes or
0
 is skipped.
0
-.TP
0
-.B discovery = something
0
-If this is set, discovery mode will be automatically activated on startup.
0
 .SH FORMAT FLAGS
0
 There are several format flags allowed for some options. Here is the list.
0
 .TP
0
@@ -355,9 +340,11 @@ the interface, you must provide a valid value to the
0
 option in your configuration or use the
0
 .B -i
0
 option on the command line. Then you can connect the specified port (54311 by
0
-default) and send one of the commands at one time. You also have to hurry,
0
+default) and send one command at a time. You also have to hurry,
0
 since there is a very short timeout. Best thing would be if you used a script
0
-for accessing this interface. This is a list of the known commands.
0
+for accessing this interface. (See
0
+.B shell-fm-*/scripts/
0
+for examples) This is a list of the known commands.
0
 .TP
0
 .B play lastfm://...
0
 Play the given stream.
0
@@ -431,6 +418,25 @@ time it is run.
0
 .TP
0
 .B shell-fm.rc
0
 Your configuration file as described above.
0
+.SH EXAMPLES
0
+.TP
0
+.B Sample Configuration for shell-fm.rc
0
+.PP
0
+.RS
0
+.nf
0
+# shell-fm.rc example
0
+username = shellfmlover
0
+password = CheckFileIsOnlyReadableByOwner
0
+default-radio = lastfm://user/shellfmlover/playlist
0
+np-file = /home/shellfmlover/.shell-fm/nowplaying
0
+np-file-format = %t:%a:%S:%A
0
+minimum = 80
0
+delay-change = true
0
+.fi
0
+.RE
0
+.TP
0
+.B shell-fm-*.*/scripts/
0
+Includes examples of using the network interface plus a color printing script to help with choosing colors.
0
 .SH BUGS
0
 No bugs known at the moment. Please send bug reports to <shell-fm@nex.scrapping.cc>.
0
 .SH COPYRIGHT

Comments

    No one has commented yet.