diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,94 @@
+[![Build Status](https://travis-ci.com/galenhuntington/hmp3-ng.svg?branch=master)](https://travis-ci.com/galenhuntington/hmp3-ng)
+
+##  hmp3-ng
+
+The `hmp3` music player, written in Haskell, dates to 2005, and has a
+curses-based interface which can be used in an ordinary text terminal.
+But 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 a work in progress 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, which I had at one point
+but cannot find), and Hackage hosts tarballs for several versions.
+
+*  I used [darcs-to-git](https://github.com/purcell/darcs-to-git)
+to port to Git.
+
+*  I added commits for the changes in the two later published versions.
+These were fairly small, the bulk being the regeneration of the
+`configure` file using a newer version of GNU `autoconf`.
+
+*  I updated the code to compile under modern GHC (8.6.5 as of this
+writing) and libraries.  Some code could not be directly ported,
+mainly low-level optimizations, and so was replaced.
+
+*  There is a GitHub issue tracker to cover other problems and planned
+changes, and Travis integration to continuously test builds.
+
+*  I have added support for building with Stack.
+
+*  All C code is removed.  There is still some use of the FFI.
+
+*  Cabal is configured via the more modern
+[hpack](https://github.com/sol/hpack) format.
+
+*  Work on other features and changes, and documentation, is ongoing.
+
+I have also made a few changes and additions to the key bindings per
+my preference.
+
+I am still working out the flaws.  Let me know if there are problems.
+
+
+##  Installation
+
+Either `cabal install` or `stack install` will build a binary.
+You will need to have `mpg321` installed, which is free software
+and widely available in package managers.  Alternatively, `mpg123`
+can be used by compiling with the `-DMPG123` option, but, while your
+mileage may vary, in my experience it doesn't work as well.
+
+The build depends on the package `hscurses`, which in turn requires
+curses dev files.  In Ubuntu/Debian, for example, these can be
+gotten by installing `libncurses5-dev`.  You probably also need
+`libncursesw5-dev`.
+
+
+##  Use
+
+The `hmp3` executable is called with arguments containing a list of mp3
+files or directories of mp3 files.  With no arguments, it will use the
+playlist from the last time it was run, which is stored in `~/.hmp3db`.
+
+```
+$ hmp3 ~/Music ~/Downloads/La-La.mp3
+$ hmp3
+```
+
+Once running, `hmp3` is controlled by fairly intuitive key commands.
+`h` shows a help menu, and `q` quits.
+
+A color scheme can be specified by writing out a `Config { .. }`
+value in `~/.hmp3`.  See `Style.hs` for the definition.  The `l`
+command reloads this configuration.
+
+
+##  Original authorship list
+
+```
+License:
+    GPL
+
+Author:
+    Don Stewart, Tue Jan 15 15:16:55 PST 2008
+
+Contributors:
+    Samuel Bronson
+    Stefan Wehr
+    Tomasz Zielonka
+    David Himmelstrup
+```
+
diff --git a/hmp3-ng.cabal b/hmp3-ng.cabal
--- a/hmp3-ng.cabal
+++ b/hmp3-ng.cabal
@@ -4,10 +4,10 @@
 --
 -- see: https://github.com/sol/hpack
 --
--- hash: ba3e589b15902bfca771494be6b3c4a6bf552465aae7c116b6296d23b31a887e
+-- hash: e8c27eca0f6732be68c7b3b41ae67c54be4fcf2cf0b94d9bff78ef4998bcafe6
 
 name:           hmp3-ng
-version:        2.7.3
+version:        2.7.3.1
 synopsis:       A 2019 fork of an ncurses mp3 player written in Haskell
 description:    An mp3 player with a curses frontend. Playlists are populated by
                 passing directory names on the commandline, and saved to the
@@ -21,6 +21,9 @@
 license:        GPL
 license-file:   LICENSE
 build-type:     Simple
+extra-source-files:
+    README.md
+    Keymap.hs-boot
 
 source-repository head
   type: git