Hackage :: [Package]

hmp3-ng: A 2019 fork of an ncurses mp3 player written in Haskell

[ gpl, library, program, sound ] [ Propose Tags ] [ Report a vulnerability ]

An mp3 player with a curses frontend. Playlists are populated by passing file and directory names on the command line. h displays help.

[Skip to Readme]

Modules

  • Base
  • Config
  • Core
  • Decoder
  • Keyboard
  • Keymap
  • Playlist
  • State
  • Style
  • UI
  • Width

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 2.4.2, 2.5.1, 2.7.0, 2.7.1, 2.7.3, 2.7.3.1, 2.9.3, 2.10.0, 2.11.0, 2.12.0, 2.12.1, 2.14.1.1, 2.14.2, 2.14.3, 2.15.0, 2.15.1, 2.16.0, 2.16.1, 2.16.2, 2.17.0, 2.17.1, 2.17.2, 2.17.3, 2.18.0, 2.18.1, 2.19.0
Dependencies array, base (>=4.16 && <5), bytestring (>=0.10), clock, containers, directory (>=1.3.7.0), filepath, hmp3-ng, hscurses, mtl, optparse-applicative, posix-paths, process, random, regex-posix, unix (>=2.8), utf8-string [details]
License GPL-2.0-or-later
Author Don Stewart, Galen Huntington
Maintainer Galen Huntington
Uploaded by galen at 2026-06-20T05:46:05Z
Category Sound
Home page https://github.com/galenhuntington/hmp3-ng#readme
Bug tracker https://github.com/galenhuntington/hmp3-ng/issues
Source repo head: git clone https://github.com/galenhuntington/hmp3-ng
Distributions
Executables hmp3
Downloads 4174 total (89 in the last 30 days)
Rating 2.0 (votes: 1) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs not available [build log]
All reported builds failed as of 2026-06-20 [all 2 reports]

Readme for hmp3-ng-2.19.0

[back to package description]

Hackage Build status

hmp3-ng

The original hmp3 music player, written in Haskell, dates to 2005, and has a curses interface for use in a text terminal. However, it has become abandonware: the last update was in June 2008, and it no longer builds with today’s Haskell and standard libraries. This repository is an effort to resurrect this software.

The original Darcs repo has vanished from the Internet. However, I have a copy I checked out in 2008 (to hack on!) with all the patches through version 1.5.1 (the latest is 1.5.2.1), and Hackage has tarballs for the later versions.

  • I used darcs-to-git to port to Git. I manually added commits for the two later published versions, which were only minor changes, mostly the automated regeneration of a configure file (now gone).

  • The code has been updated to compile under recent GHC (tested through 9.14; minimum supported 9.2) and libraries. This required rewriting or entirely replacing large sections, mainly low-level optimizations.

  • I added support for building with Stack. It can also be installed with Nix from nixpkgs (haskellPackages.hmp3-ng).

  • There is a public GitHub issue tracker, and a GitHub action to continuously test builds.

  • There is a test suite built on the Tasty framework.

  • I try to avoid “Not Invented Here” by using established, up-to-date packages from Hackage. Much old code has now been “outsourced” and simplified.

  • All C code is removed, replaced with libraries from Hackage. There is still some use of the FFI.

  • Unicode is supported in titles and filenames, and Unicode glyphs are utilized in the interface.

  • It is much more stable. The app used to crash frequently and require restart, but I’ve had hmp3-ng running multiple times continuously for more than a year with heavy use without any problems.

  • Several additions and changes have been made to the feature set and the UI. A few of the key bindings have been modified per my preference.

  • Work on other features and changes, and documentation, is ongoing.

This is still a work in progress. Let me know if there are problems.

Installation

Either cabal install or stack install will build a binary. You will need to have mpg123 installed, which is free software and widely available in package managers.

The build depends on the package hscurses, which in turn requires curses dev files. In Ubuntu/Debian, for example, these can be obtained by installing libncurses-dev.

Use

The hmp3 executable is invoked with a list of mp3 files or directories of mp3 files.

$ hmp3 ~/Music ~/Downloads/La-La.mp3

Once running, hmp3 is controlled by fairly intuitive key commands. h shows a help menu, and q quits. hmp3 -h prints a simple help message with command line options.

A color scheme can be specified by writing out a Config { .. } value in ~/.config/hmp3/style.conf (or wherever your XDG config is). See Style.hs for the definition. The l command hot-reloads this configuration.

Original authorship

License:
    GPL

Author:
    Don Stewart, Tue Jan 15 15:16:55 PST 2008

Contributors:
    Samuel Bronson
    Stefan Wehr
    Tomasz Zielonka
    David Himmelstrup