NAME
    POE::Component::Player::Xmms - a wrapper for the "Xmms" player

SYNOPSIS
            use POE qw(Component::Player::Xmms);

            POE::Component::Player::Xmms->spawn({ alias => 'xmms' });
            $kernel->post(xmms => play => 'test.mp3');

            POE::Kernel->run();

DESCRIPTION
    This component is used to manipulate the "Xmms" player from within a POE
    application.

METHODS
  spawn
    Used to initialise the system and create a module instance. The optional
    hash reference may contain any of the following keys:

    alias
    Indicates the name of a session to which events will be posted. Default:
    "main".

    xargs
    Allows for passing extra arguments to the underlying application. (NOT
    used if already running)

EVENTS
  Xmms::Remote events
    The methods available to Xmms::Remote are dupicated as events, heres the
    list:

            playlist_clear,
            playlist,
            play,
            get_playlist_length,
            get_volume,
            set_main_volume,
            get_main_volume,
            is_repeat,
            is_shuffle,
            get_info,
            get_playlist_file,
            get_playlist_time,
            set_volume,
            get_balance,
            get_balancestr,
            set_balance,
            get_skin,
            toggle_aot,
            main_win_toggle,
            pl_win_toggle,
            eq_win_toggle,
            prefs_win_toggle,
            get_output_time,
            get_output_timestr,
            stop,
            is_playing,
            quit,
            get_playlist_pos,
            set_playlist_pos,
            get_playlist_files,
            get_version,
            is_running,
            show_prefs_box,
            set_skin,
            all_win_toggle,
            get_playlist_titles,
            get_playlist_title,
            eject,
            playlist_next,
            playlist_prev,
            pause,
            toggle_shuffle,
            toggle_repeat,
            playlist_delete,
            playlist_add,
            playlist_add_url,
            jump_to_timestr,
            jump_to_time,
            get_playlist_timestr,
            is_main_win,
            is_pl_win,
            is_eq_win,
            get_eq,
            set_eq,
            get_eq_preamp,
            set_eq_preamp,
            get_eq_band,
            set_eq_band

    For now, just $kernel->call these to get the return values. I will
    document these and add event replys for everything later.

EVENTS
    Events are fired at the session from which the *spawn()* method as
    called from. Currently there is only one event fired.

  xmms_started
    This event is fired by the player's notification that it's ready.

AUTHOR
    David Davis <xantus@cpan.org>

TODO
    Better documentation on ALL events

    Patches welcome :)

SEE ALSO
    perl(1), Xmms::Remote