Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/bigpresh/dancer-plugin-mpd

Dancer::Plugin::MPD - easy MPD (www.musicpd.org) connections from Dancer apps
https://github.com/bigpresh/dancer-plugin-mpd

Last synced: about 2 months ago
JSON representation

Dancer::Plugin::MPD - easy MPD (www.musicpd.org) connections from Dancer apps

Awesome Lists containing this project

README

        

NAME
Dancer::Plugin::MPD - easy connection to MPD from Dancer apps

DESCRIPTION
Provides an easy way to connect to MPD (www.musicpd.org) from a Dancer
app. Handles obtaining the connection, making sure the connection is
still alive, and reconnecting if not.

SYNOPSIS
In your Dancer app, calling the `mpd' keyword will get you an MPD
connection.

use Dancer::Plugin::MPD;
my $current_song = mpd->current;
mpd->next;

CONFIGURATION
Audio::MPD does sensible things by default, so in the majority of cases
(MPD running on the same host as the app, no password needed, and happy
to reuse the connection for performance), no configuration will be
required at all.

However, the following config settings can be used in your app's
`config.yml':

plugins:
MPD:
host: localhost
port: 6600
password: verysecret
conntype: reuse

HOOKS
* `mpd_connected'
Called when a connection is established, and receives the Audio::MPD
object as its parameter.

hook 'mpd_connected' => sub {
my $mpd = shift;
$mpd->repeat(1);
$mpd->random(1);
$mpd->play;
};

AUTHOR
David Precious, `'

ACKNOWLEDGEMENTS
Alan Berndt

BUGS
Please report any bugs or feature requests to `bug-dancer-plugin-mpd at
rt.cpan.org', or through the web interface at
http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Dancer-Plugin-MPD. I will
be notified, and then you'll automatically be notified of progress on
your bug as I make changes.

SUPPORT
You can find documentation for this module with the perldoc command.

perldoc Dancer::Plugin::MPD

You can also look for information at:

* RT: CPAN's request tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Dancer-Plugin-MPD

* AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Dancer-Plugin-MPD

* CPAN Ratings
http://cpanratings.perl.org/d/Dancer-Plugin-MPD

* Search CPAN
http://search.cpan.org/dist/Dancer-Plugin-MPD/

LICENSE AND COPYRIGHT
Copyright 2010-12 David Precious.

This program is free software; you can redistribute it and/or modify it
under the terms of either: the GNU General Public License as published
by the Free Software Foundation; or the Artistic License.

See http://dev.perl.org/licenses/ for more information.