Beets

Beets is a music library manager that automatically tags, organizes, and enriches your audio files with metadata from online databases such as MusicBrainz.

  • Home Automation
  • Media Applications
  • Media Servers
  • Tools & Utilities
Beets is a music library manager that automatically tags, organizes, and enriches your audio files with metadata from online databases such as MusicBrainz. It is aimed at homelab users who want a tidy, searchable music collection without hand-editing file tags; it is not intended as a music player, though simple playback plugins exist.

Platform availability

Available on 3 of 10 platforms

  • Unraid
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

79/100 Good

Maintained
100last commit 28 days ago
Popular
46190 GitHub stars
Easy to install
553 install platforms, install notes, Docker image
Light to run
100256 MB minimum RAM, runs on ARM
Security check
85no serious findings, CI

Availability: platform listings confirmed today, links checked 8 days ago

GitHub stars
190
Open issues
1
Last commit
2026-10-23
Latest release
2.14.1-ls357
License
GPL-3.0
Activity
steady

Checked 22 days ago - source: GitHub (linuxserver/docker-beets)

Resources & Compatibility

Minimum requirements: 256 MB RAM, 1 CPU core(s), 100 MB disk. ARM (e.g. Raspberry Pi) is supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Set your music folder and library file In your beets config file, set directory to your music folder and library to the catalog file, and keep that library file safe because beets uses it to remember your collection. Also choose import move or write carefully, because move relocates files and write changes their tags. source
  • Install extras for add-ons Use pip (Python's package installer) with the matching extra when you want an add-on, for example beets[chroma] for Chroma support. Without the extra, the feature may fail because the needed Python libraries are not installed. source
  • Fill in Subsonic details if using that plugin If you enable the Subsonic playlist plugin, set base_url, username, and password in its config. If those are missing or wrong, beets cannot connect to your Subsonic server to manage playlists. source

Fetched 54 days ago - each note links to its source

Alternatives (8)

  • Kid3 - If you want to easily tag multiple MP3, Ogg/Vorbis, FLAC, MPC, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV and AIFF files (e.g.
  • MediaMonkey - MediaMonkey is a music player and a music library manager with support for 50,000+ files and many features for organizing, tagging, convert…
  • Mp3tag - Edit and organize audio metadata easily with comprehensive support for batch editing and various audio formats.
  • MusicBrainz - MusicBrainz is a community music metadatabase that attempts to create a comprehensive music information site.
  • MusicBrainz Picard - MusicBrainz Picard is the official cross-platform music tagger, automatically organizing and tagging audio files using the MusicBrainz data…
  • SimpleTag
  • TagScanner - TagScanner is a multifunction program for organizing and managing your music collection.
  • songkong - SongKong is a Dockerized music tagging application that identifies songs and automatically adds metadata and artwork.

Checked 51 days ago - source: AlternativeTo

Common questions

How do I install the extra Python dependencies needed for a beets add-on?

Use pip with the matching extra, for example beets[chroma] for Chroma support. Without the extra, the feature may fail because the needed Python libraries are not installed.

What beets data file should I keep safe for backups?

Keep the library file safe, because beets uses it to remember your collection. In the config, set directory to your music folder and library to the catalog file.

What do beets' import move and write options do to my music files?

Choose import move or write carefully, because move relocates files. Write changes the files' tags.

How can I get more diagnostic information when a beets import fails or behaves oddly?

Turn on beets' debug output using the -v option, for example beet -v import. Include that verbose output with your bug report and look through it for red flags.

Answers sourced from beets.readthedocs.io, beets.readthedocs.io, beets.readthedocs.io

Community

Collected 53 days ago - public community threads