clean minimal web interface for your music collection https://www.janksystems.org/posts/20260331-records/
  • Go 84.4%
  • Roff 9%
  • CSS 4.1%
  • HTML 1.5%
  • Makefile 1%
Find a file
2026-04-03 20:06:09 +13:00
musicindex tree: refactor 2026-03-31 14:05:48 +13:00
server tree: refactor 2026-03-31 14:05:48 +13:00
util tree: refactor 2026-03-31 14:05:48 +13:00
.gitignore add .gitignore 2026-01-05 01:04:10 +13:00
COPYING COPYING: init AGPL 3 2026-04-03 17:45:09 +13:00
go.mod tree: refactor 2026-03-31 14:05:48 +13:00
go.sum tree: refactor 2026-03-31 14:05:48 +13:00
main.go tree: refactor 2026-03-31 14:05:48 +13:00
Makefile records.1: init man page 2026-04-03 19:52:08 +13:00
README.md README.md: refactor 2026-04-03 20:06:09 +13:00
records.1 records.1: init man page 2026-04-03 19:52:08 +13:00
static initial commit 2026-01-04 23:33:46 +13:00

records: browse your music collection over the net

records indexes your music collection and displays it over the net.

For a brief overview, check out my blog post:

https://www.janksystems.org/posts/20260331-records

records is distributed under the terms of the GNU Affero General Public License, version 3. A copy of the license is contained in COPYING.

Build

With the Go toolchain installed, use

make
sudo make install

Usage

Pass it your music directory as an argument. An example might be

records ~/Music

records expects a specific directory hierarchy to determine artists and albums. This is detailed in the man page. You can read it with:

man records

If you installed records with make install, you will have it installed. Otherwise you can run man ./records.1 in the repo directory. The manual is very detailed and will go over every aspect of the program while still being short and concise, I hope you enjoy it!

Feel free to send any questions to jeremy@baxters.nz :-)