records indexes albums in your collection, and provides access to them over the internet. It has a clean, minimal web UI, free from JavaScript and heavy web frameworks.

overview

records sorts through a directory, and expects a hierarchy like this:

root-|
     |- artist
     |  \_ album
     |     |- cover.jpg
     |     \_ song.flac
     \_ artist ...

Song metadata is completely ignored and albums are indexed by your directory structure. Once indexed, albums can be displayed in a variety of ways on the web interface, including a grid of albums, a list of albums from a certain artist, or a list of all albums. There is also the option to sort by name or by song count.

records also maintains a cache of .tar.gz archives for your albums! On every album’s page, there is a link to its archive, so that your albums can be easily distributed to your devices and extracted.

download

There are no formal releases for records yet.

However, you can compile from the latest version of the source repository. (See git repository below)

documentation

records is documented in detail in its man page. The web interface is very intuitive and straightforward, the manual is only intended for those who wish to run the program themselves.

git repository

The source code repository can be found at git.janksystems.org. Instructions on how to compile and install the program are provided in the README file. You will need a copy of the Go toolchain installed.