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)
|
