NAME

Data::Timeline::IScrobbler - Build a timeline from tracks recorded by iScrobbler

SYNOPSIS

my $timeline = Data::Timeline::IScrobbler->new->create;

DESCRIPTION

This class parses the logs created by the Mac OS X application iScrobbler and creates a timeline of the recently played tracks. iScrobbler is an application for Mac OS X that creates a simple menu extra that submits your "currently playing" info from iTunes to AudioScrobbler. The advantage over using the AudioScrobbler web service is that iScrobbler keeps a lot more recently played tracks history than the web service. See its page at http://iscrobbler.sourceforge.net/.

The timeline entries generated by this builder have the type iscrobbler.

See the eg/hackmusic-text.pl and eg/hackmusic-html.pl programs in this distribution for examples. The idea for those programs was inspired by Greg McCarroll's blog post "Optimal Hacking Music" at http://drinkbroken.typepad.com/drink_broken/2007/11/set-the-hack--1.html. The programs show timelines of your recently played iTunes tracks history alongside your svk commit history and thus give an impression of which music you like to hack to.

Data::Timeline::IScrobbler inherits from Data::Timeline::Builder.

METHODS

clear_log_filename

$obj->clear_log_filename;

Clears the value.

log_filename

my $value = $obj->log_filename;
$obj->log_filename($value);

A basic getter/setter method. If called without an argument, it returns the value. If called with a single argument, it sets the value.

log_filename_clear

$obj->log_filename_clear;

Clears the value.

log_filename

The log filename from which the builder tries to parse the recently played track information. Defaults to ~/Library/Logs/iScrobbler.log.

create

Start parsing information from the logfile indicated by the log_filename(). Returns a Data::Timeline object with the gleaned information.

TAGS

If you talk about this module in blogs, on del.icio.us or anywhere else, please use the datatimelineiscrobbler tag.

BUGS AND LIMITATIONS

No bugs have been reported.

Please report any bugs or feature requests to <bug-data-timeline-iscrobbler@rt.cpan.org>, or through the web interface at http://rt.cpan.org.

INSTALLATION

See perlmodinstall for information and options on installing Perl modules.

AVAILABILITY

The latest version of this module is available from the Comprehensive Perl Archive Network (CPAN). Visit <http://www.perl.com/CPAN/> to find a CPAN site near you. Or see <http://www.perl.com/CPAN/authors/id/M/MA/MARCEL/>.

AUTHOR

Marcel Grünauer, <marcel@cpan.org>

COPYRIGHT AND LICENSE

Copyright 2007 by Marcel Grünauer

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.