@hackage libmpd0.7.2
An MPD client library.
Categories
License
LicenseRef-LGPL
Maintainer
Joachim Fasting <joachim.fasting@gmail.com>
Links
Versions
Installation
Dependencies (8)
- base >=4 && <4.6
- containers >=0.3 && <0.5
- filepath >=1.0 && <1.4
- mtl >=2.0 && <2.1
- network >=2.1 && <2.4
- old-locale >=1.0 && <2.0 Show all…
Dependents (8)
@hackage/mpd-current-json, @hackage/acme-everything, @hackage/xmonad-extras, @hackage/xmobar, @hackage/hum, @hackage/mushu, Show all…
Package Flags
test
(off by default)
Build test driver
coverage
(off by default)
Build driver with hpc instrumentation
libmpd-haskell: a client library for MPD
About
libmpd-haskell is a client library for MPD written in Haskell that aims to provide a safe and flexible yet consistent and intuitive interface to MPD's external API.
Getting
- Latest release
git clone git://github.com/joachifm/libmpd-haskell.git
Building
The preferred method of building libmpd-haskell is using cabal-install, which takes care of dependency resolution and other minutiae.
To install libmpd-haskell, simply run:
cd libmpd-haskell && cabal install
Running tests
To run the libmpd testsuite, do:
./tests/run-tests.lhs
Compiler support
We try to support the two last major versions of GHC, but only the latest version (provided by the haskell-platform) is actually tested for.
MPD API compliance
We try to comply with the latest version of the MPD protocol specification; any deviation from this is a bug.
Usage
With GHCi:
> import Network.MPD
> withMPD $ lsInfo ""
Right [Left "Tool", Left "Tom Waits",...]
> withMPD $ add "Tom Waits/Big Time"
Right ["Tom Waits/Big Time/01 - 16 Shells from a Thirty-Ought-Six.mp3",...]
Development
Getting started
Create the clone thus:
git clone git://github.com/joachifm/libmpd-haskell.git master
To pull in new changes from upstream, use:
git pull origin master
To set up GIT hooks, see hooks/README in the source distribution.
Submitting patches
To submit a patch, use git format-patch and email the resulting file(s) to
one of the developers or upload it to the bug tracker.
Alternatively you can create your own fork of the repository and send a pull request.
Well-formatted patches are appreciated. New features should have a test case.
Submitting bug reports
See our bug tracker. Test cases are highly appreciated.
Resources
- API documentation
- libmpd-haskell mailing list
- Protocol reference
- Using GitHub
- #libmpd-haskell @ irc.freenode.net (defunct)
License
LGPL version 2.1 (see LICENSE)
Contributors (in order of appearance)
Ben Sinclair <ben.d.sinclair@gmail.com>
Joachim Fasting <joachim.fasting@gmail.com>
gwern0 <gwern0@gmail.com>
Daniel Schoepe <daniel.schoepe@googlemail.com>
Andrzej Rybczak <electricityispower@gmail.com>
Simon Hengel <sol@typeful.net>
Daniel Wagner <daniel@wagner-home.com>