Skip to content

Beets

What is it?

Beets catalogs your collection, automatically improving its metadata as it goes using the MusicBrainz database. Then it provides a bouquet of tools for manipulating and accessing your music.

Beets is a music library manager and not, for the most part, a music player. It does include a simple player plugin and an experimental Web-based player, but it generally leaves actual sound-reproduction to specialized tools.

Details
Project home Docs Github Docker

1. Installation

sb install sandbox-beets

2. URL

  • To access Beets, visit https://beets._yourdomain.com_

3. Setup

  • The configured username/password are taken from your Saltbox accounts.yml file located in /srv/git/saltbox/accounts.yml
  • When the role is run, a cron job is set to automatically import any music found at /mnt/local/downloads/music every hour.
    If a match is under 95% beets will skip the file and it will need manual importing.
  • To run a manual import (which will help correct any matches under 95%) run the following command:

    rm /opt/beets/state.pickle && docker exec -it beets /bin/bash -c 'beet import /downloads'
    
  • If you want to change the folder structure you should do so in the config file located at
    /opt/beets/config.yaml
    This link details the allowed options

    If you already have imported music you will need to run an import using the following command:

    docker exec -it beets /bin/bash -c 'beet import /music'
    
  • Documentation