https://github.com/vimus/libmpd-haskell
A client library for MPD, the Music Player Daemon
https://github.com/vimus/libmpd-haskell
haskell mpd mpd-client
Last synced: 5 months ago
JSON representation
A client library for MPD, the Music Player Daemon
- Host: GitHub
- URL: https://github.com/vimus/libmpd-haskell
- Owner: vimus
- License: mit
- Created: 2009-08-31T14:55:57.000Z (over 16 years ago)
- Default Branch: master
- Last Pushed: 2024-06-18T08:22:10.000Z (over 1 year ago)
- Last Synced: 2025-08-06T10:44:40.697Z (6 months ago)
- Topics: haskell, mpd, mpd-client
- Language: Haskell
- Homepage:
- Size: 1.37 MB
- Stars: 36
- Watchers: 6
- Forks: 25
- Open Issues: 10
-
Metadata Files:
- Readme: README.md
- Changelog: changelog.md
- License: LICENSE
Awesome Lists containing this project
README
# 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.