NAME

Audacious - An Object-orientated interface to Audacious

VERSION

Version 0.92

SYNOPSIS

General usage:

  use strict;
  use warnings;
  use Audacious;

  my $aud = Audacious->new();

  my $volume = $aud->get_volume;
  print("Current Audacious volume is $volume\n");

  $aud->set_volume(80);

DESCRIPTION

This module provides a clean OOP interface to the Audacious media player, via interfacing with `audtool2`.

OBJECT INTERFACE

CONSTRUCTOR

new

Creates a new Audacious object.

METHODS

current

Returns a hashref of the current song and related info.

HASHREF: { 'bitrate' => '200', 'length' => '5:20', 'album' => 'Discovery', 'artist' => 'Daft Punk', 'file' => 'file:///usr/home/alyx/Music/Music/Daft Punk/Discovery/', 'title' => 'One More Time', 'genre' => 'Electronic' };

next

Go to the next song in the playlist. Returns the new current song.

back

Go to the previous song in the playlist. Returns the new current song.

add

Add a URL to the playlist.

listlength

Returns the total length of the playlist (In minutes)

position

Returns the current position in the playlist.

jump

Jump to the specified position in the playlist. Returns the new current song.

clear

Clears the playlist.

repeat

If given a parameter, will toggle the repeat setting of Audacious. If called without a parameter, will return the current repeat setting.

shuffle

If given a parameter, will toggle the shuffle setting of Audacious. If called without a parameter, will return the current shuffle setting.

playlist

Returns the name of the current playlist.

play

Starts song playback.

pause

Pauses/Unpauses song playback.

stop

Stops song playback.

get_volume

Returns the current volume level.

set_volume

Sets volume to the given parameter.

eq

If given a parameter, will toggle the equaliser to that parameter. If not parameter is given, will return the current equaliser setting.

version

Returns Audacious' version.

AUTHOR

Alexandria Wolcott <alyx@woomoo.org>

LICENSE

Copyright © Alexandria Wolcott

This module may be used, modified, and distributed under BSD license. See the beginning of this file for said license.

SEE ALSO

http://hg.atheme.org/audacious