NAME

XMMS::InfoPipe - A small module to gather the information produced by the infopipe plugin for XMMS

SYNOPSIS

        use XMMS::InfoPipe;
        
        my $xmms = XMMS::InfoPipe->new();
        
        print "Currently ", $xmms->{info}->{Status}, ": ", $xmms->{info}->{Title};

DESCRIPTION

This module was written to provide a way to snag the information from the file produced by the xmms-infopipe plugin for XMMS. With only a few convenience methods, all of the information that the plugin provides can be obtained from the $xmms->{info} hashref.

Nota Bene: If the XMMS plugin isn't enabled, then this module will NOT return results as expected (if it even works).

METHODS

new

    my $xmms = XMMS::InfoPipe->new();

Creates a new XMMS::InfoPipe instance. By default this parses the file before returning the object. This will undoubtedly cause some initial slowdown (the bottleneck of XMMS::InfoPipe is when it must grab information from the named pipe the XMMS plugin provides), and so you may disable this first parsing by specifying a false value to ForceParse. For example:

    my $xmms = XMMS::InfoPipe->new(ForceParse => 0);

will create the object and immediately return it, without first populating it with the information from XMMS. This means that before trying to obtain this information, you should first call $xmms->update_info.

is_running

    $xmms->is_running()

Returns 1 if XMMS is running and 0 if not. This relies on the fact that the named pipe does not exist if XMMS is not running. If the infopipe plugin isn't enabled, this will also return 0.

is_playing

    $xmms->is_playing()

Returns 1 if XMMS is playing a song and 0 if not.

is_paused

    $xmms->is_paused()

Returns 1 if XMMS is paused and 0 if not.

update_info

    $xmms->update_info()
    

Updates $xmms->{info} and returns the updated hashref for convenience.

_parse

    $xmms->_parse
    

Internal function that parses data from the info pipe and returns a hashref. You shouldn't need to use this.

VARIABLES

$XMMS::InfoPipe::PIPE

    $XMMS::InfoPipe::PIPE = '/tmp/other-name';

This variable defaults to /tmp/xmms-info which should be a symlink (created by xmms-infopipe) to the real named pipe (something like /tmp/xmms-info_user.0). If for whatever reason you need to change it (maybe you have a file generated by something else that follows the same format as xmms-infopipe), just set it before update_info is called (by default that means before new is called) for the right file to be used.

INFORMATION AVAILABLE

As of version 1.3 of the xmms-infopipe plugin, the following information is available:

    XMMS protocol version
    InfoPipe Plugin version
    Status
    Tunes in playlist
    Currently playing
    uSecPosition
    Position
    uSecTime
    Time
    Current bitrate
    Samping Frequency
    Channels
    Title
    File

To get this information, just use the corresponding key name above. Nota Bene: "Samping" is not a typo in this doc; it's a typo in the xmms-infopipe plugin. : )

LICENSE

This module is free software, and may be distributed under the same terms as Perl itself.

AUTHOR

Copyright (C) 2003, Thomas R. Sibley tsibley@cpan.org