Marcel Grünauer > Data-Timeline-IScrobbler-0.02 > Data::Timeline::IScrobbler

Download:
Data-Timeline-IScrobbler-0.02.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.02   Source  

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.

The superclass Data::Timeline::Builder defines these methods and functions:

    new(), make_entry(), make_timeline()

The superclass Class::Accessor::Complex defines these methods and functions:

    carp(), cluck(), croak(), flatten(), mk_abstract_accessors(),
    mk_array_accessors(), mk_boolean_accessors(),
    mk_class_array_accessors(), mk_class_hash_accessors(),
    mk_class_scalar_accessors(), mk_concat_accessors(),
    mk_forward_accessors(), mk_hash_accessors(), mk_integer_accessors(),
    mk_new(), mk_object_accessors(), mk_scalar_accessors(),
    mk_set_accessors(), mk_singleton()

The superclass Class::Accessor defines these methods and functions:

    _carp(), _croak(), _mk_accessors(), accessor_name_for(),
    best_practice_accessor_name_for(), best_practice_mutator_name_for(),
    follow_best_practice(), get(), make_accessor(), make_ro_accessor(),
    make_wo_accessor(), mk_accessors(), mk_ro_accessors(),
    mk_wo_accessors(), mutator_name_for(), set()

The superclass Class::Accessor::Installer defines these methods and functions:

    install_accessor(), subname()

The superclass Class::Accessor::Constructor defines these methods and functions:

    NO_DIRTY(), WITH_DIRTY(), _make_constructor(), mk_constructor(),
    mk_constructor_with_dirty(), mk_singleton_constructor()

The superclass Data::Inherited defines these methods and functions:

    every_hash(), every_list(), flush_every_cache_by_key()

The superclass Class::Accessor::Constructor::Base defines these methods and functions:

    HYGIENIC(), STORE(), clear_dirty(), clear_hygienic(),
    clear_unhygienic(), contains_hygienic(), contains_unhygienic(),
    delete_hygienic(), delete_unhygienic(), dirty(), dirty_clear(),
    dirty_set(), elements_hygienic(), elements_unhygienic(), hygienic(),
    hygienic_clear(), hygienic_contains(), hygienic_delete(),
    hygienic_elements(), hygienic_insert(), hygienic_is_empty(),
    hygienic_size(), insert_hygienic(), insert_unhygienic(),
    is_empty_hygienic(), is_empty_unhygienic(), set_dirty(),
    size_hygienic(), size_unhygienic(), unhygienic(), unhygienic_clear(),
    unhygienic_contains(), unhygienic_delete(), unhygienic_elements(),
    unhygienic_insert(), unhygienic_is_empty(), unhygienic_size()

The superclass Tie::StdHash defines these methods and functions:

    CLEAR(), DELETE(), EXISTS(), FETCH(), FIRSTKEY(), NEXTKEY(), SCALAR(),
    TIEHASH()

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.

VERSION ^

This document describes version 0.02 of Data::Timeline::IScrobbler.

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.

syntax highlighting: