Hi! This is the first post of my personal blog, where I’ll document any thoughts, findings, or projects of mine.

records is a program I made to index albums in your collection, and provide access to them over the internet. It will sort through a directory, with a hierarchy like this:

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

So song metadata is completely ignored and albums are indexed by your directory structure. They can then 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.

The program 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 and extracted.

Install it on your hardware

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

Conclusion

I had a lot of fun finding out about server-side web apps and how they can work incredibly well using plain HTML. Looking forward to doing more of this in the future!