Repolode
Submit
beetbox

beetbox/beets

A command-line music library manager that catalogs your collection and automatically corrects its metadata using MusicBrainz.

Open-source alternative to:MusicBrainz PicardiTunes

View on GitHubWebsite
Stars
15,900
Forks
2,188
Open issues
680
Last commit
2 days ago

What is it?

Beets is a music library manager for people who want their collection's tags, filenames and organization to be consistent. You import a folder of music, and it matches each album against the MusicBrainz database, proposes corrected titles and artists with a similarity score, and writes the results back to the files. Everything is stored in a searchable library that you query from the command line.

Beyond tagging, beets works as a platform for plugins. Available plugins cover fetching album art and lyrics, calculating ReplayGain levels and acoustic fingerprints, transcoding audio to other formats, finding duplicate tracks and albums, and detecting albums with missing tracks. A web interface lets you browse the library in a browser, and an MPD-compatible plugin lets MPD clients play it. Plugins are written in Python.

Beets is installed with pip and is MIT licensed. It is also packaged in several Linux distributions.

Key features

  • 01Imports music and matches albums to MusicBrainz metadata with similarity scores.
  • 02Writes corrected tags and organizes files into a consistent directory layout.
  • 03Stores the collection in a searchable library queried from the command line.
  • 04Extends through plugins for album art, lyrics, ReplayGain, and audio transcoding.
  • 05Finds duplicate tracks and albums and albums with missing tracks.
  • 06Provides a web interface and an MPD-compatible plugin for playback.

Use cases

  • Cleaning up a large, inconsistently tagged personal music collection.
  • Keeping a local FLAC or MP3 library organized with consistent filenames.
  • Finding duplicate albums before backing up or syncing a music library.
  • Serving a personal library to an MPD client or a browser on the home network.

Quick start

  1. 1

    Install beets with pip

    pip install beets

In collections

CLI & terminal tools

Topics

#music#music-library#musicbrainz#metadata#cli#python#audio-tagging#hacktoberfest

FAQ

What is beets?
A command-line music library manager that catalogs your collection and automatically corrects its metadata using MusicBrainz. Beets is a music library manager for people who want their collection's tags, filenames and organization to be consistent. You import a folder of music, and it matches each album against the MusicBrainz database, proposes corrected titles and artists with a similarity score, and writes the results back to the files. Everything is stored in a searchable library that you query from the command line.
Is beets free to use? What license does it have?
beets is open source under the MIT license. Check the license terms before using it in commercial products.
Is beets still maintained?
Actively maintained. The last commit to beets was on Nov 5, 2026.
What can I use beets for?
Cleaning up a large, inconsistently tagged personal music collection. Keeping a local FLAC or MP3 library organized with consistent filenames. Finding duplicate albums before backing up or syncing a music library. Serving a personal library to an MPD client or a browser on the home network.
How do I install beets?
Install beets with pip: pip install beets
Where can I get beets?
The source code and installation instructions are on GitHub: https://github.com/beetbox/beets

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects