NAME

App::Pimpd::Playlist::Randomize - Package exporting various randomizing functions

SYNOPSIS

    use App::Pimpd;
    use App::Pimpd::Playlist::Randomize;

    my @random_songs = randomize(10);

    my @random_albums = randomize_albums(5);

    my $random_song = random_track_in_playlist();

DESCRIPTION

App::Pimpd::Playlist::Randomize provides functions for altering the current playlist in random ways.

EXPORTS

randomize()

  my @randoms = randomize(42);
  my $randoms = randomize();

Parameters: $integer, $artist

Returns: @songs | \@songs

In list context, returns a list with n random paths ( all relative to MPD ). If a second argument is provided it's interpreted as an artist name. The list will be crafted together with random paths from that artist.

In scalar context, returns an array reference.

If called with zero arguments, a default value of 100 totally random songs is used.

random_albums();

  my @random_albums       = random_albums(42);
  my $random_albums_songs = random_albums();

Parameters: $integer | NONE

Returns: @songs | scalar(@songs)

In list context, returns a list with the paths to the songs of n random albums.

In scalar context, returns the number of songs found on the n random albums.

If called with zero arguments, a default value of 10 albums is used.

random_track_in_playlist()

  my $position = random_track_in_playlist();
  $mpd->play($position);

Parameters: NONE

Returns: $playlist_pos

Returns a valid playlist position id, used to reference a song in the playlist.

SEE ALSO

App::Pimpd::Playlist

AUTHOR

  Magnus Woldrich
  CPAN ID: WOLDRICH
  m@japh.se
  http://japh.se

COPYRIGHT

Copyright (C) 2010, 2011 Magnus Woldrich. All right reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.