[lastbash-cvs] lastbash README,1.3,1.4

[Costin S. <cs...@us...>]

Update of /cvsroot/lastbash/lastbash
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv19756

Modified Files:
	README 
Log Message:
Updated for 0.3.0.

Index: README
===================================================================
RCS file: /cvsroot/lastbash/lastbash/README,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -d -r1.3 -r1.4
--- README	28 Nov 2006 17:31:35 -0000	1.3
+++ README	6 Dec 2006 13:55:29 -0000	1.4
@@ -23,18 +23,27 @@
 Features
 ========
 
-LastBASH is a console player for Last.fm. Even beta, it is quite usable.  
-Its purpose is to offer a simple interface to Last.fm services.
+LastBASH is a console player for Last.fm. Even beta, it is quite usable.
 
+Its purpose is to offer a simple interface to Last.fm services, to allow 
+you to listen to the streams while you are working in console. Or, 
+maybe, when you don't want to use any graphical player.
+
+LastBASH features the following:
+* nice and usable Text User Interface
 * authentication using the md5 password encryption
 * retrieves the metadata of the current playing track and displays it 
   (artist, album, track name, track duration)
 * keeps a history of last played tracks
-* allows you to control the Last.fm station, by issuing the love, skip 
-  and ban commands
+* allows you to change the Last.fm station
+* allows you to control the Last.fm station, by issuing the 'love', 
+  'skip' and 'ban' commands
 * optionally, it can run a backend player (such as MPlayer or mpg123), 
   which you can control through the same interface, or lets you choose 
-  any external player you wish (capable of playing mp3 streams)
+  any external player you wish (capable of playing mp3 streams), such as 
+  XMMS, Rhythmbox or even Amarok, if you feel to
+* remote control (send commands and station changing)
+* easy integration with web browsers
 
 
 Usage
@@ -75,6 +84,12 @@
 last.fm station
     You can specify a new Last.fm station to connect to.
 
+You can also pass the Last.fm station name to tune directly into it.
+
+$ lastbash "lastfm://globaltags/rock"
+$ lastbash "lastfm://globaltags/classic rock"
+$ lastbash "lastfm://user/cstroie/neighbours"
+$ lastbash "lastfm://artist/Rammstein/similarartists"
 
 Then, the program will try to connect. If it succeeds, it will save 
 a playlist in ~/.lastbash/playlist.m3u, for you to open with some 
@@ -86,9 +101,34 @@
 
 USE_PLAYER="n"
 
-Then, open your mp3 player, load the above-mentioned playlist and start 
-playing. LastBASH will show you the current playing track and will keep 
-a history of last played tracks. Enjoy!
+Then, open your favourite mp3 player, load the above-mentioned playlist 
+and start playing. LastBASH will show you the current playing track, 
+will keep a history of last played tracks and will allow you to control 
+the stream.
+
+For example, to run MPlayer manually (just an example), run it this way:
+
+$ mplayer -cache 512 -playlist ~/.lastbash/playlist.m3u
+
+If you like xmms, run it this way (or just run it and open the playlist 
+using the GUI):
+
+$ xmms ~/.lastbash/playlist.m3u
+
+To use mpg123, the command is the following:
+
+$ mpg123 -C -v -@ ~/.lastbash/playlist.m3u
+
+If one instance of LastBASH is already running, a second call can send 
+commands to the first one, for example:
+
+$ lastbash -c LOVE
+$ lastbash -c SKIP
+$ lastbash -c BAN
+
+Or you can change the station this way.
+
+$ lastbash "lastfm://group/LastBASH"
 
 
 Key bindings
@@ -107,6 +147,16 @@
     you can use this key to force a refresh)
 p
     Toggle "Record to Profile" (the P led will change status)
+
+d
+    Toggle "Discovery Mode" (the D led will change status)
+
+s
+    Toggle history scrolling direction
+
+CTRL-L
+    Redraw the interface
+
 q
     Quit (and stop the backend player too)