vdr-lastfm Code
Status: Beta
Brought to you by:
hitman_47
This is a "plugin" for the Video Disk Recorder (VDR).
Written by: Matthias Feistel
<hitman_47@users.sourceforge.net>
GnuPG Key ID: 0xD6182313
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.
Prerequisites/Dependencies
--------------------------
vdr>=1.6.0 (vdr-1.4.0 not tested, but should work except of int'lization; see this URL for a patch made by snowyrain:
<http://sourceforge.net/tracker/?func=detail&aid=2781605&group_id=172097&atid=860424>)
An account on last.fm will be needed.
libmad (0.15.1b)
C++ Sockets Library >2.2 (adjust prefix and other settings in Sockets' Makefile and sockets-config.h according to your needs)
ImageMagick++ (optional, albumcovers on OSD; must be configured with "--with-xml" for use with urls)
Makedependencies
---------------
grep
sed
awk
tr
gcc
Sockets-config
git (optional, if git version used)
Magick++-config (optional, if compiled with LASTFM_HAVE_MAGICK)
MagickCore-config (optional, if compiled with LASTFM_HAVE_MAGICK)
Installation
------------
Make sure, C++ Sockets Library (see dependencies above) is installed properly.
Untar the archive into VDRs plugins source directory.
Create a symlink lastfm.
Adjust compiletime options according to your needs in <vdr/Make.config>
LASTFM_HAVE_MAGICK = 1 : shows albumcovers with ImageMagick
LASTFM_DEBUG = 1 : Compiles with debugging information; there are more LASTFM_DEBUG switches (see file DEBUG for more information)
...make clean in lastfm-plugin directory and make plugins from vdr directory.
In order to load the plugin, edit your vdr startscript and add -Plastfm.
The plugin has no commandline parameters.
After using plugin setup in VDR, a file will be created for storing profiles and favourites in <vdrconfig/plugins/lastfm/lastfm_config.xml>
Usage
-----
The plugin can be started by choosing lastfm from VDR mainmenu.
Ok: Show/Hide OSD
Red: Favour track
Green: Skip track
Yellow: Ban track
Blue: Exit plugin
5: Enter submenu (metadata, search, ...)
Next: Triggers nexttrack
0: Update OSD immediately (useful, if OSD refresh is set to 0 (deactivated) in setup)
Setup
-----
Favourites: Predefined words, that can be chosen in the plugin's search menu.
Username: last.fm username
Passphrase: last.fm passphrase
Show albumcover?: Only applicable, if compiled with LASTFM_HAVE_MAGICK.
Show Osd at startup?: Define, whether you want to display the osdinterface after starting the plugin via mainmenu.
Osdmode: Choose between textual or graphical osdmode (dxr3-card users should use textual mode).
Osd refresh interval: Refresh interval of metadata in osdmode; 0 means deactivated;
Scrobblemode: If set to yes, plugin submits listened tracks to last.fm.
Player buffertime: Time in seconds to prefill buffer.
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://winni.vdr-developer.org/epgsearch/>)
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>)
Petri Hintukainen (vdr-xineliboutput <http://www.sourceforge.net/projects/xineliboutput/>)
Ralf Klueber, Lars von Wedel, Andreas Kellner (vdr-muggle <http://projects.vdr-developer.org/projects/show/plg-muggle>)
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)
Contributors:
Diego Pierotto (Thanks for providing Italian translation)