mushu: Minimalist MPD client

[ bsd3, program, sound ] [ Propose Tags ]

Mushu is a minimalist MPD client with a TUI and an incremental fuzzy finder for your music library


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.0, 0.1.1
Dependencies base (>=4 && <5), brick, bytestring, classy-prelude, connection, containers, data-default, directory (>=1.2.5.0), filepath, fuzzy, hscurses, htoml, libmpd, list-t, microlens, microlens-platform (>=0.3.1.0), microlens-th, mtl, network, pretty, process, safe-exceptions, template-haskell (>=2.10), text, text-zipper, time, transformers, unordered-containers, vector, vty (>=5.5.0) [details]
License BSD-3-Clause
Copyright 2016 Elie Genard
Author Elie Genard
Maintainer elaye.github.io@gmail.com
Category Sound
Home page https://github.com/elaye/mushu#README.md
Source repo head: git clone https://github.com/elaye/mushu
Uploaded by elaye at 2017-04-01T10:45:51Z
Distributions
Reverse Dependencies 1 direct, 0 indirect [details]
Executables mushu
Downloads 1488 total (8 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
Last success reported on 2017-04-01 [all 3 reports]

Readme for mushu-0.1.1

[back to package description]

Mushu Build Status

Mushu is a minimalist MPD client with a Text User Interface (TUI) focused on ease of use. Its main feature is an incremental fuzzy finder for the music library. The interface is largely inspired by ncmpcpp.

Screenshot

This client was made to fit my needs so it may not fit yours. A lot of MPD features are not implemented.

Dependencies

libncurses5-dev

Install

Mushu is available on stack.

stack install mushu

If you don't have stack please install it following instructions here.

Why another MPD client?

I used ncmpcpp for quite some time and realised that I was always doing the same thing with it: search for music -> add to playlist and play. I was not entirely satisfied with the search in ncmpcpp so I decided to make my own. Also, ncmpcpp as way too many features that I don't use.

The aim is to keep the number of features to a minimum without being unusable.

I also wanted to develop a real world haskell project and this seemed like a good opportunity.

TODO

  • Add config file (mainly to be able to choose a different server than localhost:6600 for MPD)
  • Add MPD error handling and show error in a notification widget
  • Add MPD playback modes handling
  • UI
    • Improve help screen
    • Add top / bottom list keybindings (G and g)
    • Add delete from playlist keybinding (d or x?)
  • Fix all the bugs and refactor!

Contributing

Contributions are very welcome. However please open an issue before developing anything too big so we can discuss it, I'd hate to have wasted your time if the Pull Request you made can't be merged. Please read CONTRIBUTING.md before contributing. If you want an overview of the app, check out DEVELOPER.md.