README
1NAME
2 Music::Audioscrobbler::MPD - Module providing routines to submit songs
3 to last.fm from MPD.
4
5DESCRIPTION
6 Music::Audioscrobbler::MPD is a scrobbler for MPD. As of version .1,
7 Music::Audioscrobbler::Submit is used to submit information to last.fm.
8
9 All internal code is subject to change. See musicmpdscrobble for usage
10 info.
11
12INSTALLATION
13 To install this module type the following:
14
15 perl Makefile.PL
16 make
17 make test
18 make install
19
20CONFIGURATION
21 There is a sample config file under examples. A sample init file that I
22 use for gentoo linux is there as well.
23
24USE
25 Edit the sample config file and copy to /etc/musicmpdscrobble.conf or
26 ~/.musicmpdscrobble.conf
27
28 Test your configuration by issue the command
29
30 musicmpdscrobble --logfile=STDERR --monitor
31
32 and playing some music.
33
34 If it works, then the command
35
36 musicmpdscrobble --daemonize
37
38 will run musicmpdscrobble as a daemon. Please see examples for a sample
39 init script. If you make an init script for your distribution, please
40 send it to me!
41
42DEPENDENCIES
43 This module requires these other modules and libraries:
44
45 Music::Audioscrobbler::Submit
46 File::Spec
47 Digest::MD5
48 Encode
49 IO::Socket
50 IO::File
51 Config::Options
52
53 I strongly encourage you to also install my module
54
55 Music::Tag
56
57 This will allow you to read info from the file tag (such as the
58 MusicBrainz ID).
59
60 The version info in the Makefile is based on what I use. You can get
61 away with older versions in many cases.
62
63MORE HELP
64 Please see the documentation for musicmpdscrobble which is available
65 from
66
67 musicmpdscrobble --longhelp
68
69AUTHOR
70 Edward Allen, ealleniii _at_ cpan _dot_ org
71
72COPYRIGHT
73 Copyright (c) 2007 Edward J. Allen III
74
75 Some code and inspiration from Audio::MPD Copyright (c) 2005 Tue
76 Abrahamsen, Copyright (c) 2006 Nicholas J. Humfrey, Copyright (c) 2007
77 Jerome Quelin
78
79LICENSE
80 This program is free software; you can redistribute it and/or modify it
81 under the same terms as Perl itself, either:
82
83 a) the GNU General Public License as published by the Free Software
84 Foundation; either version 1, or (at your option) any later version, or
85
86 b) the "Artistic License" which comes with Perl.
87
88 This program is distributed in the hope that it will be useful, but
89 WITHOUT ANY WARRANTY; without even the implied warranty of
90 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See either the GNU
91 General Public License or the Artistic License for more details.
92
93 You should have received a copy of the Artistic License with this Kit,
94 in the file named "Artistic". If not, I'll be glad to provide one.
95
96 You should also have received a copy of the GNU General Public License
97 along with this program in the file named "Copying". If not, write to
98 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
99 Boston, MA 02110-1301, USA or visit their web page on the Internet at
100 http://www.gnu.org/copyleft/gpl.html.
101
102