Update of /cvsroot/lastbash/lastbash
In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv14913
Modified Files:
README
Log Message:
Some content moved to manpage.
Index: README
===================================================================
RCS file: /cvsroot/lastbash/lastbash/README,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- README 6 Dec 2006 13:55:29 -0000 1.4
+++ README 12 Dec 2006 12:37:47 -0000 1.5
@@ -50,9 +50,9 @@
=====
Please see the INSTALL file for quick instructions about how to install
-and launch LastBASH. You must have a compatible terminal (linux or xterm
-are supported at the moment) and, if you wish to use the backend player,
-you should have MPlayer. For now.
+and launch LastBASH. You must have a compatible terminal (such as linux
+or xterm) and, if you wish to use the backend player, you should have
+MPlayer too. For now.
After you have donwloaded, extracted and installed the program, run it.
You do not need to pass any command line parameters, at least at first
@@ -63,41 +63,20 @@
It will ask your Last.fm username and password. You should have one. If
not, hmmm... go and create an account on Last.fm
-There are some command line parameters you can use.
-
--u username
- Specify the username to connect with.
-
--p player
- Specify the backend player to use (auto or mplayer, for now).
-
--a
- Automatically start playing.
-
--A
- Do not start playing automatically.
-
--c command
- Send the command to the running instance.
-
-
-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.
+There are some command line parameters you can use, please see the
+lastbash(1) man page for more details. If you want to directly tune into
+a Last.fm station, use this format (feel free to use any lastfm:// url
+you like):
-$ lastbash "lastfm://globaltags/rock"
-$ lastbash "lastfm://globaltags/classic rock"
-$ lastbash "lastfm://user/cstroie/neighbours"
-$ lastbash "lastfm://artist/Rammstein/similarartists"
+$ lastbash "lastfm://group/LastBASH"
-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
-external player, if you don't want to use the backend it provides.
+The program will try to connect. If it succeeds, it will save a playlist
+in '~/.lastbash/playlist.m3u', for you to open with some external
+player, if you don't want to use the backend it provides.
If you have MPlayer (for the moment, this is the backend), it will start
-playing. If not, you will have to tell LastBASH not to try to run it by
-creating the ~/.lastbash/config file and adding this line:
+playing. If you don't want to use the backend, you will have to tell
+LastBASH not to try to run it by setting this in the configuration file:
USE_PLAYER="n"
@@ -119,17 +98,6 @@
$ 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
============
@@ -142,24 +110,10 @@
Skip track
b
Ban track
-r
- Refresh track metadata (refresh is automatic, but if you need to,
- 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)
+For more keys, please see the lastbash(1) man page.
Last.fm
|
