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

Written by:                  Matthias Feistel <vdr-lastfm@gmx.net>

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

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

See the file COPYING for license information.

Description:

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


PREREQUESITIES

An account on last.fm will be needed.
libmad (0.15.1b)
ffmpeg (if softdevicereceiver shall be used); can be activated in <VDR/Make-lastfm.config>
ImageMagick++ (albumcovers on OSD)

INSTALL

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_DEBUG = 1                   : activates debug mode
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

...make clean the lastfm-plugin directory and make plugins.

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


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


When VDR is running you can start the plugin via the main menu. You will see a menu. 
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.


NOTICE

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


CREDITS

This Project uses sources of the following authors:

Tobias Grimm            (vdr-podcatcher)
Stefan Huelswitt        (vdr-mp3)
Richard J. Wagner       (class ConfigFile)
L. Peter Deutsch        (MD5)
Martin Wache            (vdr-softplay)
Sascha Volkenandt       (vdr-text2skin)
Anders Hedström         (Sockets; http://www.alhem.net/Sockets/)

Happy bugfixing with:

Michael Glas (aka pimsky; fixing OSD on fullfeatured dvb cards)
kingjerry (same as above)
Kai Krakow (various patches and extra engagement)

