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"