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"