1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
# libmpd-haskell: a client library for MPD
[](http://hackage.haskell.org/package/libmpd)
[](http://travis-ci.org/vimus/libmpd-haskell)
## About
libmpd-haskell is a pure [Haskell] client library for [MPD], the
music playing daemon. Requires MPD version 0.19 or later.
[MPD]: http://www.musicpd.org
[Haskell]: http://www.haskell.org
## Getting
* [Latest release on Hackage]
* `git clone https://github.com/vimus/libmpd-haskell.git`
[Latest release on Hackage]: https://hackage.haskell.org/package/libmpd "libmpd-haskell on Hackage"
## Installation
With [cabal-install], do
`cd libmpd-haskell && cabal install`
[cabal-install]: https://hackage.haskell.org/package/cabal-install
## Usage
With GHCi:
> :set -XOverloadedStrings
> import Network.MPD
> withMPD $ lsInfo ""
Right [LsDirectory "Tool", LsDirectory "Tom Waits",...]
> withMPD $ add "Tom Waits/Big Time"
Right ["Tom Waits/Big Time/01 - 16 Shells from a Thirty-Ought-Six.mp3",...]
## MPD API compliance
Any deviation from the latest version of the [MPD protocol reference]
is a bug.
## Submitting bug reports
See our [bug tracker]. Test cases are highly appreciated.
## 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 [GitHub repository] and
send a pull request.
Well-formatted patches are appreciated. New features should have a test case.
## See also
* [vimus], an MPD client with vim-like keybindings
[vimus]: https://github.com/vimus/vimus
## Resources
* [API documentation]
* [MPD protocol reference]
* [Using GitHub]
* \#vimus @ irc.freenode.net
[bug tracker]: https://github.com/vimus/libmpd-haskell/issues
[GitHub]: https://github.com
[GitHub repository]: https://github.com/vimus/libmpd-haskell
[API documentation]: https://hackage.haskell.org/packages/archive/libmpd/latest/doc/html/Network-MPD.html
[MPD protocol reference]: http://www.musicpd.org/doc/protocol/
[Using GitHub]: https://help.github.com
## License
libmpd-haskell is distributed under the [MIT license].
[MIT license]: http://opensource.org/licenses/MIT
## Contributors
See [CONTRIBUTORS](https://github.com/vimus/libmpd-haskell/blob/master/CONTRIBUTORS) in the
source distribution.
Feel free to add yourself to this list if you deem it appropriate to do
so.
|