[lastbash-cvs] lastbash README,1.3,1.4
Status: Beta
Brought to you by:
cstroie
|
From: Costin S. <cs...@us...> - 2006-12-06 13:55:36
|
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) |