Beets-flask

Opinionated web-interface around the music organizer beets

Features

• Autogenerate previews before importing
• Auto-Import good matches
• Import via GUI
• Undo imports
• Web-Terminal
• Monitor multiple inboxes
• Library view and search

https://github.com/user-attachments/assets/b7c7ae32-36ac-4950-b2ed-186b80d7075b

Motivation

Autotagging music with beets is great. Beets identifies metadata correctly most of the time, and if you are not a control-freak, there is hardly any reason to check the found metadata.

However, if you do want a bit more control, things could be more convenient.

This is the main idea with beets-flask: For all folders in your inbox, we generate a preview of what beets would do and show you those previews. Then it's easy to go through them and import the correct ones, or pick other candidates for those that were not to your liking.

Quickstart

We provide a docker image with the full beeets-flask setup. You can run it with docker-compose or docker. We recommend using the stable tag, alternatively you may use latest for the most recent build.

Setup container

Using docker

docker run -d -p 5001:5001 \
    -e TZ=Europe/Berlin \
    -e USER_ID=1000 \
    -e GROUP_ID=1000 \
    -v /wherever/config/:/config \
    -v /music_path/inbox/:/music_path/inbox/ \
    -v /music_path/clean/:/music_path/clean/ \
    --name beets-flask \
    pspitzner/beets-flask:stable

Using docker compose

services:
    beets-flask:
        image: pspitzner/beets-flask:stable
        restart: unless-stopped
        ports:
            - "5001:5001"
        environment:
            # 502 is default on macos, 1000 on linux
            TZ: Europe/Berlin
            USER_ID: 1000
            GROUP_ID: 1000
        volumes:
            - /wherever/config/:/config
            # for music folders, match paths inside and out of container!
            - /music_path/inbox/:/music_path/inbox/
            - /music_path/clean/:/music_path/clean/

This will create a container with the following folder structure:

├── music_path
│   ├── inbox
│   └── clean
└── config
    ├── beets
    │   ├── config.yaml
    │   └── library.db
    └── beets-flask
        ├── config.yaml
        └── beets-flask-sqlite.db

Check our documentation for more information!

Limitations

There are a few known issues, see the corresponding docs section for details.

Support the Project

If you enjoy this project, there are a few ways you can support us:

• Contribute code: Pull requests, bug reports, and feature suggestions are always welcome!
• Spread the word: Share the project with friends or on social media.
• Donate: Every contribution helps fuel more coffee-powered coding sessions!
  • Donate ETH: 0x81927e76f2f0fAA9e7fD92176a473955DB20Ce55
  • Donate BTC: bc1qw5e0deust6uq94e5s58au82wrakcjmlemw3cy4