[lastbash-cvs] blis_pages _404_, NONE, 1.1 ChangeLog, NONE, 1.1 Download, NONE, 1.1 Features, NONE,
Status: Beta
Brought to you by:
cstroie
Update of /cvsroot/lastbash/blis_pages In directory sc8-pr-cvs6.sourceforge.net:/tmp/cvs-serv18831 Added Files: _404_ ChangeLog Download Features Home Install _Menu_ News Screenshots Usage Log Message: Blis pages added to cvs. --- NEW FILE: Features --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Console/terminal based player for Last.fm radio (:TITLE:) Features (:DESCRIPTION:) LastBASH Features (:REVISION:) $Id: Features,v 1.1 2006/12/06 12:31:38 cstroie Exp $ 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. * 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 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) * remote control (send commands and station changing) * easy integration with web browsers = Internal stuff = The communication with the web service is accomplished internally by using routines to connect, request and parse the resulted data. The TUI is created using some terminal features such as non-linear cursor movement, scrolling areas and color attributes. = Current version = For the moment, it lacks documentation (aka manpage), I know, I am working on it. But, if you are brave enough, you can run it and, if you have MPlayer installed and some supported terminal (such as linux or xterm) it will work smoothly. If you don't have MPlayer, open the playlist the program saves in @@~/.lastbash/playlist.m3u@@ with some streaming-capable mp3 player and play it. You will be able to control Last.fm features from LastBASH and listen with your favourite player. --- NEW FILE: ChangeLog --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) ChangeLog (:DESCRIPTION:) LastBASH ChangeLog (:REVISION:) $Id: ChangeLog,v 1.1 2006/12/06 12:31:38 cstroie Exp $ '''v0.2.3''' * Display the action (Love, Skip, Ban) in current track area and history. * Limit the line length in current track area. * New headers for history. * Added support for Discovery mode. * Display the keys when the pressed key is not understood. * Basic URL encoding. '''v0.2.2''' * Search for available players. * Check for missing programs. * Support for remote commands and signalling. * Added support for terminal resize. '''v0.2.1''' * Added an area to display only the current track meta. History scrolling can be up or down. The player can be enabled or disabled. '''v0.1''' * LastBASH developping has started. * Added support for the xterm title. * Write a playlist when connecting. * Added support for the backend player, mplayer, for now. * Added support for terminal size detection. * The header and status bar scale the whole terminal width. * Added the RTP command. --- NEW FILE: _Menu_ --- % Main menu * [[ Home ]] * [[ News ]] * [[ Features ]] * [[ Usage ]] * [[ Screenshots ]] * [[ Download ]] * [[ Install ]] * [[ ChangeLog ]] --- NEW FILE: Download --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) Download LastBASH (:DESCRIPTION:) Download a released version or the lates snapshot (:REVISION:) $Id: Download,v 1.1 2006/12/06 12:31:38 cstroie Exp $ You can download one of the official releases or the latest snapshot from CVS server. == Download the release == The releases can be found on the standard SourceForge [ http://sourceforge.net/project/showfiles.php?group_id=182040 | project page ] which will redirect you to the SourceForge mirrors. == Download the lastest CVS snapshot == For the latest snapshot, you have to use CVS, according to the instructions from [ http://sourceforge.net/cvs/?group_id=182040 | this page ], under the ''Anonymous CVS Access'' section. The ''modulename'' is @@lastbash@@. --- NEW FILE: Install --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) Install and uninstall (:DESCRIPTION:) Installing and uninstalling LastBASH (:REVISION:) $Id: Install,v 1.1 2006/12/06 12:31:38 cstroie Exp $ LastBASH is a shell script. You do not need to install it to run. For a quick test, just run it from its current directory. == Run from the current directory == To test it, [[Download|download]] the latest release and follow the next steps. First, unpack the archive (replace the version number with the correct one) and enter the directory tar xzf lastbash-0.2.3.tar.gz cd lastbash-0.2.3 Then run the program (assuming @@bash@@ is your shell) ./lastbash Please see the [[Usage]] page for details on LastBASH usage. == Install == To perform an installation with default options, run the next command as root. make install If you like, parameters can be specified in the command line, like this. make prefix=/usr/bin install == Uninstall == To perform the uninstall process, type the next command (with or without some parameters in the command line) as root. make uninstall --- NEW FILE: Home --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) Introduction (:DESCRIPTION:) Introduction (:REVISION:) $Id: Home,v 1.1 2006/12/06 12:31:38 cstroie Exp $ LastBASH is a console/terminal based [http://www.last.fm|Last.fm] player. Although the [http://www.last.fm/tools/downloads|default Last.fm player] is a great one, it also is a graphical one and it could be somewhat inadequate for the die-hard terminal users, like some people I know. LastBASH tries to find its place among the other Last.fm players, filling this gap: the missing console player. Basically, it is no more than a <abbr title="Text User Interface">TUI</abbr> frontend, written in [http://www.gnu.org/software/bash|Bash]. It displays the information of the current playing track, keeps a history of the played tracks and allows the user to perform some actions on the current track, such as ''love'', ''skip'' or ''ban''. To listen to Last.fm, you can use any player capable of mp3 streaming (such as [http://www.mplayerhq.hu|MPlayer], [http://www.mpg123.de|mpg123], [http://www.xmms.org|XMMS] and so on) by opening the M3U playlist that LastBASH saves on connecting. But the recommended way is to use the LastBASH frontend features and let it run some compatible player in background (MPlayer or mpg123), that you can control through the same user interface. This way you need to have only one console open to listen and control Last.fm. = Last.fm = This is shameless self-promotion, I know. You can find me on Last.fm as [http://www.last.fm/user/cstroie|cstroie] and, if you like this player and want to share your experience, you can join the [http://www.last.fm/group/LastBASH|LastBASH group] and tell others about it. = Website = The website is based on [http://blis.sourceforge.net|Blis], a personal content publishing system. --- NEW FILE: Usage --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Console/terminal based player for Last.fm radio (:TITLE:) Usage (:DESCRIPTION:) Using LastBASH (:REVISION:) $Id: Usage,v 1.1 2006/12/06 12:31:38 cstroie Exp $ Please see the [[Install]] page 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. 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 start. lastbash It will ask your Last.fm username and password. You should have one. If not, hmmm... go and create an account on [http://www.last.fm|Last.fm] You can also pass the Last.fm station name to tune directly into it. For now, the url must be %-escaped (replace the SPACE characters with @@%20@@). lastbash lastfm://globaltags/rock lastbash lastfm://globaltags/classic%20rock 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 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 automatically. If not, you will have to tell LastBASH not to try to run it by creating the @@~/.lastbash/config@@ file and adding this line: USE_PLAYER="n" 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): xmms ~/.lastbash/playlist.m3u To use mpg123, the command is the following: mpg123 -C -v -@ ~/.lastbash/playlist.m3u Enjoy! = Remote control = 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 = Mozilla Firefox integration = Open Firefox and type in the address bar the following. about:config Right click and select ''New > String ''. As name type the next string and press '''OK'''. network.protocol-handler.app.lastfm As value type the full path to the LastBASH programs, something like this one. /usr/bin/lastbash Now, go to [http://www.last.fm|Last.fm] and click any ''lastfm://'' url. This will launch a second instance of the program and pass to the first one the new station. = Key bindings = Basic key bindings are the following: :l:Love track :k: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) :q:Quit (and stop the backend player too) --- NEW FILE: News --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) News (:DESCRIPTION:) News (:REVISION:) $Id: News,v 1.1 2006/12/06 12:31:38 cstroie Exp $ :2006.11.28 v0.2.3: The remote call support has been improved. The history has new headings and the action (Love, Skip, Ban) is displayed. The keys are displayed when the pressed key is not understood. :2006.11.22 v0.2.2: Some new and interesting features added. Search for available players. Support for remote commands and signalling. Added support for terminal resize. :2006.11.16 v0.2: This realease brings a better user interface, displaying separately the current track info and history. The interface uses all terminal width. You should expect bugs, though. :2006.11.13 v0.1: A quick snapshot of the first beta of LastBASH. It plays. = ChangeLog = For more details, please see the [[ChangeLog]]. --- NEW FILE: Screenshots --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) Screenshots (:DESCRIPTION:) LastBASH screenshots (:REVISION:) $Id: Screenshots,v 1.1 2006/12/06 12:31:38 cstroie Exp $ == Version 0.2.4 == [[image:thumbnails/lastbash-0.2.4.png | LastBASH 0.2.4 playing ]] Normal operation of LastBASH. You can see the new history header, the action in the current playing area and in history (the first letter). The status bar shows the current listening station, the Last.fm user name and the status leds. Click [ /blis/images/lastbash-0.2.4.png | here ] for full-size image. == Version 0.2 == [[image:thumbnails/lastbash-0.2.png | LastBASH 0.2 playing ]] This is normal LastBASH operation. You can see the current track details on top and the history on bottom. The status bar displays the current station we are listening to, the Last.fm user name and the leds (the active led is "Record to Profile"). Click [ /blis/images/lastbash-0.2.png | here ] for full-size image. For more, please see the screenshots from [ http://sourceforge.net/project/screenshots.php?group_id=182040 | the project page]. --- NEW FILE: _404_ --- (:SITE_NAME:) LastBASH (:SITE_DESCRIPTION:) Last.fm console player (:TITLE:) Page not found (:DESCRIPTION:) We are sorry. The page you were looking for is not here. (:REVISION:) $Id: _404_,v 1.1 2006/12/06 12:31:38 cstroie Exp $ '''Obi-Wan:''' This is not the page you are looking for.<br> '''Trooper:''' This is not the page we're looking for.<br> '''Obi-Wan:''' You can go about your business.<br> '''Trooper:''' We can go about our business.<br> '''Obi-Wan:''' Move along.<br> '''Trooper:''' [[Home | Move along... move along]]. |