Self-host Beets
v2.14.1Music library manager that auto-fixes tags from MusicBrainz
pip install beets- Stars
- 15 941
- Ports
- 8337 (Web plugin's browser UI and REST+JSON API server (bound to 127.0.0.1 by default)), 6600 (BPD plugin, a music player daemon that speaks the MPD protocol)
What is Beets?
beets is a Python media library manager for people who want their music metadata fixed once and kept clean. Its interactive autotagger catalogues a collection and corrects tags by matching against MusicBrainz and, through plugins, sources such as Discogs and Beatport; it can also fetch artwork, lyrics, genres, tempos and ReplayGain levels, compute acoustic fingerprints, transcode audio, flag duplicates or albums missing tracks, and reorganise files using configurable path formats. Day-to-day work happens in the beet command line (list, import, move, stats), and behaviour is extended either through bundled plugins or plugins you write yourself in Python. Two optional servers come from the same library database: a web interface backed by a REST+JSON API that plays tracks with HTML5 audio, and BPD, a daemon that speaks the MPD protocol so ordinary MPD clients can drive your collection. Install it with pip, uv tool, pipx or your distribution's package (Python 3.10 or later); configuration lives in a YAML file such as ~/.config/beets/config.yaml, and the web or BPD features need their own extras (pip install "beets[web]", pip install "beets[bpd]").
Beets alternatives
betaninSelf-hosted, open-source bridge between your torrent client and beets music library: it imports completed downloads, tags them and notifies you via apprise.Comparebetanin with Beets
MeeloSelf-hosted Music Server. Focused on metadata integration & UICompareMeelo with Beets
LidarrOpen-source, self-hosted music collection manager that watches indexer RSS feeds, grabs albums over Usenet or BitTorrent, and upgrades quality automatically.CompareLidarr with Beets
tidaloaderA self-hosted, open-source web app that downloads music from Tidal in multiple quality tiers and imports playlists from Spotify and ListenBrainz.Comparetidaloader with Beets
metadata-remoteSelf-hosted web app for editing audio metadata on headless servers. Lightweight Docker container with MusicBrainz, bulk editing, undo/redo, keyboard-first UI.Comparemetadata-remote with Beets
downtifyHost your own music downloader that grabs tracks from Spotify and YouTube Music, tags them automatically, and plays them in a browser-based player with playlist watching.Comparedowntify with Beets
TagrA self-hosted web application for managing music metadata through a browser-based three-panel interface with integrated audio playback.CompareTagr with Beets
Lightweight Music Server (LMS)Self-hosted music streaming server with web UI and Subsonic API. Supports MusicBrainz, ListenBrainz, transcoding, multi-library.CompareLightweight Music Server (LMS) with Beets
Should you self-host Beets?
Beets scores 77/100 on selfhost.directory (how scoring works) and ranks #1 of 32 in Music. It has 15 941 GitHub stars, +162 in the last 30 days.
It shipped 14 stable releases in the past year. The latest, v2.14.1, came out on 17 September 2026. New versions land roughly every 2 weeks.
Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Python.
Its closest alternative on selfhost.directory is MusicBot (68/100, 5 806 stars). Beets scores higher overall. See Beets vs MusicBot side by side.
Features
- Audio Transcoding
- Automatic music tagging (autotagger)
- Command Line Interface
- Configurable file organization and renaming
- Duplicate and missing-track detection
- Embed and extract album art
- Metadata enrichment (artwork, lyrics, genres, ReplayGain, fingerprints)
- MPD-protocol music player daemon
- Plugin System
- REST + JSON API
- Tag cleanup
- Web interface for browsing and playingRequires the web extra: pip install "beets[web]"
FAQ
Why does beets not change my ID3 tags?
beets writes ID3v2.4 tags by default, which some software (Windows Explorer, Windows Media Player, id3lib) cannot read; enable the id3v23 option to write 2.3 tags instead.
Why does beets ignore control-C during an import?
The importer's UI thread is blocked waiting for input, so press Return or type "b" to abort at a prompt; beets also takes a moment to clean up after ^C.
Why does beets appear to be missing some plugins?
The plugin is probably newer than the version you installed; check the changelog for the version that introduced it (beet version shows what you have).
Why does beets complain that it can't find a match?
Check that at least one autotagger plugin is enabled, that the release exists in MusicBrainz, and that the files carry enough metadata; otherwise use the manual search/enter-ID options, acoustic fingerprinting or filename-based guessing.
How do I point beets at a new music directory?
Change the directory setting to the new place and run beet move; if the files already moved outside beets, delete the database and rebuild it from the new paths.
How do I avoid using special characters in my filenames?
Use the %asciify{} template function inside your path formats.
How do I report a bug in beets?
Use the GitHub issue tracker, including any traceback plus verbose output from the -v option, and narrow the problem down to a plugin, file or config entry if you can.
How do I run the latest source version of beets?
Uninstall the packaged version first, then install the source: a git+https pip install, the latest master tarball, or an editable clone of the repository.
How do I upgrade to the latest version of beets?
Upgrade through pip: the -U flag tells pip to bring beets up to the latest release, and you can pin a specific version with ==.
How do I import a multi-disc album?
beets tags all parts of a multi-disc release together, guessing from directory names that contain words such as "disc", "CD" or "vinyl"; if matching fails, use the --flat flag or put the files in a single directory.
How do I create "Disc N" directories for multi-disc albums?
Use the inline plugin together with the %if{} template function so the path format only inserts a "Disc N" folder when an album has more than one disc.
How do I find all the albums I imported "as-is"?
Enable the import log, which records whenever you skip an album or accept one as-is, or list albums that have no MusicBrainz ID with a query such as beet ls -a mb_albumid::^$.
How do I rename my files according to a new path format configuration?
Run the move command; pass a query to rename only part of the collection, or leave the query off to rename everything.
More in Music
betaninSelf-hosted, open-source bridge between your torrent client and beets music library: it imports completed downloads, tags them and notifies you via apprise.
binhex-soularrSoularr is a self-hosted Python script that bridges Lidarr and Slskd to automatically search Soulseek for wanted albums and import downloads into Lidarr.
DeemixOpen-source, self-hosted Deezer music downloader with a web UI, Electron desktop app and CLI, downloading tracks or playlists at 128, 320 or FLAC bitrate via Docker.- deemix-dockerSelf-hosted Docker image that packages the open-source Deemix music downloader, serving its web interface on port 6595 and shipping amd64, arm32v7 and arm64v8 builds.
downtifyHost your own music downloader that grabs tracks from Spotify and YouTube Music, tags them automatically, and plays them in a browser-based player with playlist watching.
dumbA self-hosted, open-source alternative front-end for Genius that strips away tracking scripts and bloat to provide a fast, lightweight lyrics reading experience.
evobotOpen-source, self-hosted Discord music bot in TypeScript: plays YouTube tracks and playlists with queue, loop, lyrics and slash commands in 20+ locales.
ExploSelf-hosted, open-source take on Spotify's Discover Weekly: Explo turns ListenBrainz recommendations into playlists on Jellyfin, Plex, Emby, MPD or Subsonic servers.
FeedBackFeedBack is a self-hosted, open-source FastAPI web app for managing custom song libraries and viewing note highways for rhythm practice.
feishinOpen-source desktop and web music player for Jellyfin, Navidrome and OpenSubsonic servers; the self-hosted Docker image serves the web client on port 9180.
freetarSelf-hosted open-source alternative frontend to Ultimate Guitar for viewing guitar tabs and chords without ads, tracking, or accounts.
GerberaOpen-source, self-hosted UPnP/DLNA media server that streams your music, photos and videos to any compatible device, with a web UI to manage the library.

0 comments