Music Library

• Music Library
  • Features
  • Screenshots
    • Stats
    • Collection
    • Searching for a record to add
    • Edit a record in the collection
    • View a record's details in the collection
    • View a record's tracklist
    • Adding a record in the wishlist
    • View an artist's details
    • View the scrobble activity
  • Setup
  • Environment configuration
  • Running the application
  • Deployment
  • CI
  • Architecture
  • Favicons

Features

• Add records from MusicBrainz, with optional override of specific pieces of data
• Manage a collection and a wishlist of records, with ways to quickly search and filter based on records' metadata
• Integration with Last.fm:
  • display latest scrobbles, and where possible connect them with records in the collection or wishlist
  • scrobble a record
  • store a local copy of the complete scrobble history, and setup rules to fix its data as needed
• Some basic stats
• All data stored in a single SQLite database for portability and ease of backup/restore

Screenshots

Stats

Collection

Searching for a record to add

Edit a record in the collection

View a record's details in the collection

View a record's tracklist

Adding a record in the wishlist

View an artist's details

View the scrobble activity

Setup

The project is managed and configured via mise-en-place:

• mise install will pull the correct Erlang, Elixir and Node.js versions
• mise run dev:setup will setup dependencies and database structure

Important

The project uses Fluxon UI, so it requires a valid set of credentials. See the env section in mise.toml for the required environment variables.

It's recommended to use the git hooks included in the project. Install with:

mise generate git-pre-commit --write --task=dev:precommit

Environment configuration

The application requires the following environment variables:

• LAST_FM_USER: the Last.fm username used to populate the Scrobble Activity
• LAST_FM_API_KEY (secret): the Last.fm API key used to fetch the Scrobble Activity
• OPENAI_KEY (secret): the OpenAI API key used to populating genres

In production, the application also requires:

• LOGIN_PASSWORD (secret): the password used for accessing the application.

You can create a mise.local.toml with the required variables (sample values are included at the top of mise.toml).

Running the application

Start the Phoenix endpoint with mise run console (along with an attached IEx session).

Now you can visit localhost:4000 from your browser. The default password for development is change me.

Deployment

The application is deployed via Coolify, using a Docker Compose strategy.

CI

See the .github folder.

Architecture

See the docs folder.

Favicons

This favicon was generated using the following graphics from Twitter Twemoji:

• Graphics Title: 1f4bd.svg
• Graphics Author: Copyright 2020 Twitter, Inc and other contributors (https://github.com/twitter/twemoji)
• Graphics Source: https://github.com/twitter/twemoji/blob/master/assets/svg/1f4bd.svg
• Graphics License: CC-BY 4.0 (https://creativecommons.org/licenses/by/4.0/)