This is a "plugin" for the Video Disk Recorder (VDR).

Written by:                  Matthias Feistel <hitman_47@users.sourceforge.net>

Project's homepage:          http://sourceforge.net/projects/vdr-lastfm/

Latest version available at: http://sourceforge.net/projects/vdr-lastfm/

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
See the file COPYING for more information.


Description:

This is a plugin for the Video Disc Recorder (VDR). A player for the service of
last.fm.


Prerequisities/Dependencies:

An account on last.fm will be needed.
libmad (0.15.1b)
C++ Sockets Library >2.1.6 (adjust prefix and other settings in
	Sockets' Makefile and sockets-config.h according to your needs)
ffmpeg (if softdevicereceiver shall be used); can be activated in <VDR/Make-lastfm.config>
ImageMagick++ (albumcovers on OSD)


Install:

Make sure, that C++ Sockets Library (see dependencies above) is installed properly.
Review the C++ Sockets' Makefile for proper settings ($PREFIX and define LINUX a few lines below, too).

Untar the archive into VDRs plugins source directory.
Create symlink, choose Make-lastfm.config options.
(NOTE: Versions < 0.1.2 do not have the prefix  " LASTFM_ "  ):

LASTFM_USE_SOFTDEVICE_RECEIVER = 1	: whether softdevicereceiver shall be used (define it in Make-lastfm.config;
LASTFM_HAVE_MAGICK = 1				: if you want to show with albumcovers with ImageMagick;
										otherwise let it undefined in order to deactivate albumcover on OSD
LASTFM_DEBUG = 1					: Unoptimized comilation with debugging information

...make clean lastfm-plugin directory and make all.

To load the plugin edit your vdr startscript and add -Plastfm.
The plugin has no commandline parameters.


//// Will be removed in next version:
Commandline Parameters:

-m --migratefavourites:
	Version before, did store to VDR's setup.conf. This and later versions, store data to
	a dedicated XML file.
	Old favourites, stored in setup.conf, can be migrated with that command again.
	The parameter should only be used once, otherwise the favourites will be duplicated.


Usage:

Keymap in replay mode without osd:

Red:		Favour track
Green:		Skip track
Yellow:		Ban track
Blue:		Exit plugin
1:			Chan- with softdevice receiver
3:			Chan+ with softdevice receiver

Keymap in osd:

Red:		Favour track
Green:		Skip track
Yellow:		Ban track
Blue:		Exit plugin
5:			Enters submenus
0:			Manual update of metadata

When VDR is running you can start the plugin via the main menu. You will see a menu, then.
The controlling of the last.fm-features "love, skip, ban" can be triggered by the coloured keys.

Another feature is used with activated vdr-softdevice plugin. If you activate it in the
plugin's setup, you can watch liveTV in the background and switch channels with the
remote control keys "1" and "3".

If you are in the UserInterface, you can enter submenus, providing metadata, search mask, etc., by pressing
remote key 5 on your remote control unit.

Pressing remote key 0 updates the track info, shown in  an activated user interface, immediately.


Setup:

Favourites:				Predefined words, that can be chosen in the plugin's search menu.
Username:				last.fm username
Password:				last.fm password
Receivermode:			Only applicaple if compiled with LASTFM_USE_SOFTDEVICE_RECEIVER.
							Achieves concurrent use of listening to lastfm and watching TV with softdevice.
Show albumcover?:		Only applicaple, if compiled with LASTFM_HAVE_MAGICK.
Show Osd at startup?:	Define, whether you want to display the osdinterface after calling the plugin via the mainmenu.
Osdmode?:				Choose between textual or graphical osdmode.
Osd refresh interval:	Refresh interval of metadata in osdmode; 0 means deactivated;
Scrobblemode:			If on, plugin submit listened tracks to last.fm

Notice:

Use it at your own risk. Bug reports, patches and feature requests are welcome.


Credits:

This Project uses sources of the following authors:

Klaus Schmidinger		(VDR itself <http://www.cadsoft.de/vdr/>)
Tobias Grimm			(vdr-podcatcher)
Stefan Huelswitt		(vdr-mp3)
Christian Wieninger		(vdr-epgsearch->MD5 <http://www.cwieninger.de.vu/>)
Martin Wache			(vdr-softplay)
Sascha Volkenandt		(vdr-text2skin)
Anders Hedstrom			(C++ Sockets Library <http://www.alhem.net/Sockets/>)
Dr. Ir. Frank Vanden Berghen	(xmlParser <http://www.applied-mathematics.net/tools/xmlParser.html>)
Christian A. Moser		(vdr-daap <http://www.wahnadium.org/vdr-daap.html>)

Happy bugfixing with:

Michael Glas (aka pimsky; fixing OSD on fullfeatured dvb cards)
kingjerry (same as above)
Kai Krakow (various patches, gentoo ebuilds and extra engagement)
Sebastian Dellit (aka sebo; aka obes)
