audio::mpd::common::time(3pm) [debian man page]

Audio::MPD::Common::Time(3pm)				User Contributed Perl Documentation			     Audio::MPD::Common::Time(3pm)

NAME

       Audio::MPD::Common::Time - class representing time of current song

VERSION

       version 1.120881

DESCRIPTION

       Audio::MPD::Common::Status returns some time information with the "time()" accessor. This information relates to the elapsed time of the
       current song, as well as the remaining and total time. This information is encapsulated in an Audio::MPD::Common::Time object.

       An Audio::MPD::Common::Time object does not update itself regularly, and thus should be used immediately.

       Note: one should never ever instantiate an Audio::MPD::Common::Time object directly - use the mpd modules instead.

ATTRIBUTES

   $time->time;
       The time passed to the constructor, used to compute all others values (see methods). It is the time value (on the "time" line) of what the
       MPD server returns to the status command. Defaults to "0:0".

METHODS

   my $str = $time->sofar;
       Return elapsed $time ("minutes:seconds" format).

   my $str = $time->left;
       Return remaining $time ("minutes:seconds" format).

   my $str = $time->left;
       Return total $time ("minutes:seconds" format).

   my $percent = $time->percent;
       Return elapsed $time (percentage, 1 digit).

   my $secs = $time->seconds_sofar;
       Return elapsed $time in seconds.

   my $secs = $time->seconds_left;
       Return remaining $time in seconds.

   my $secs = $time->seconds_total;
       Return total $time in seconds.

   my $mins = $time->sofar_mins;
       Return minutes part of elapsed $time.

   my $secs = $time->sofar_secs;
       Return seconds part of elapsed $time.

   my $mins = $time->left_mins;
       Return minutes part of remaining $time.

   my $secs = $time->left_secs;
       Return seconds part of remaining $time.

   my $mins = $time->total_mins;
       Return minutes part of total $time.

   my $mins = $time->total_secs;
       Return seconds part of total $time.

AUTHOR

       Jerome Quelin

COPYRIGHT AND LICENSE

       This software is copyright (c) 2007 by Jerome Quelin.

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

perl v5.14.2							    2012-04-01					     Audio::MPD::Common::Time(3pm)

Audio::MPD::Playlist(3pm)				User Contributed Perl Documentation				 Audio::MPD::Playlist(3pm)

NAME

       Audio::MPD::Playlist - class to mess MPD's playlist

VERSION

       version 1.120610

SYNOPSIS

	   $mpd->playlist->shuffle;
	   # and lots of other methods

DESCRIPTION

       Audio::MPD::Playlist is a class meant to access & update MPD's playlist.

       Note that you're not supposed to call the constructor yourself, an Audio::MPD::Playlist is automatically created for you during the
       creation of an Audio::MPD object - it can then be used with the "playlist()" accessor.

RETRIEVING INFORMATION

   as_items
	   my @items = $pl->as_items;

       Return an array of Audio::MPD::Common::Item::Songs, one for each of the songs in the current playlist.

   items_changed_since
	   my @items = $pl->items_changed_since( $plversion );

       Return a list with all the songs (as Audio::MPD::Common::Item::Song objects) added to the playlist since playlist $plversion.

ADDING 
/ REMOVING SONGS
   add
	   $pl->add( $path [, $path [...] ] );

       Add the songs identified by $path (relative to MPD's music directory) to the current playlist. No return value.

   delete
	   $pl->delete( $song [, $song [...] ] );

       Remove the specified $song numbers (starting from 0) from the current playlist. No return value.

   deleteid
	   $pl->deleteid( $songid [, $songid [...] ] );

       Remove the specified $songids (as assigned by mpd when inserted in playlist) from the current playlist. No return value.

   clear
	   $pl->clear;

       Remove all the songs from the current playlist. No return value.

   crop
	   $pl->crop;

       Remove all of the songs from the current playlist except the song currently playing.

CHANGING PLAYLIST ORDER

   shuffle
	   $pl->shuffle;

       Shuffle the current playlist. No return value.

   swap
	   $pl->swap( $song1, $song2 );

       Swap positions of song number $song1 and $song2 in the current playlist. No return value.

   swapid
	   $pl->swapid( $songid1, $songid2 );

       Swap the postions of song ID $songid1 with song ID $songid2 in the current playlist. No return value.

   move
	   $pl->move( $song, $newpos );

       Move song number $song to the position $newpos. No return value.

   moveid
	   $pl->moveid( $songid, $newpos );

       Move song ID $songid to the position $newpos. No return value.

MANAGING PLAYLISTS

   load
	   $pl->load( $playlist );

       Load list of songs from specified $playlist file. No return value.

   save
	   $pl->save( $playlist );

       Save the current playlist to a file called $playlist in MPD's playlist directory. No return value.

   rm
	   $pl->rm( $playlist );

       Delete playlist named $playlist from MPD's playlist directory. No return value.

AUTHOR

       Jerome Quelin

COPYRIGHT AND LICENSE

       This software is copyright (c) 2007 by Jerome Quelin.

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

perl v5.14.2							    2012-03-01						 Audio::MPD::Playlist(3pm)