music library manager and MusicBrainz tagger
.. image:: https://img.shields.io/pypi/v/beets.svg :target: https://pypi.python.org/pypi/beets
.. image:: https://img.shields.io/codecov/c/github/beetbox/beets.svg :target: https://codecov.io/github/beetbox/beets
.. image:: https://github.com/beetbox/beets/workflows/ci/badge.svg?branch=master :target: https://github.com/beetbox/beets/actions
.. image:: https://repology.org/badge/tiny-repos/beets.svg :target: https://repology.org/project/beets/versions
Beets is the media library management system for obsessive music geeks.
The purpose of beets is to get your music collection right once and for all. It catalogs your collection, automatically improving its metadata as it goes. It then provides a bouquet of tools for manipulating and accessing your music.
Here's an example of beets' brainy tag corrector doing its thing::
$ beet import ~/music/ladytron Tagging: Ladytron - Witching Hour (Similarity: 98.4%) * Last One Standing -> The Last One Standing * Beauty -> Beauty*2 * White Light Generation -> Whitelightgenerator * All the Way -> All the Way...
Because beets is designed as a library, it can do almost anything you can imagine for your music collection. Via
plugins_, beets becomes a panacea:
ReplayGain_ levels, or
Beatport_. Or guess metadata using songs' filenames or their acoustic fingerprints.
Transcode audio_ to any format you like.
duplicate tracks and albums_ or for
albums that are missing tracks_.
MPD_ protocol and works with a staggering variety of interfaces.
If beets doesn't do what you want yet,
writing your own plugin_ is shockingly simple if you know a little Python.
.. _plugins: https://beets.readthedocs.org/page/plugins/ .. _MPD: https://www.musicpd.org/ .. _MusicBrainz music collection: https://musicbrainz.org/doc/Collections/ .. _writing your own plugin: https://beets.readthedocs.org/page/dev/plugins.html .. _HTML5 Audio: http://www.w3.org/TR/html-markup/audio.html .. _albums that are missing tracks: https://beets.readthedocs.org/page/plugins/missing.html .. _duplicate tracks and albums: https://beets.readthedocs.org/page/plugins/duplicates.html .. _Transcode audio: https://beets.readthedocs.org/page/plugins/convert.html .. _Discogs: https://www.discogs.com/ .. _acoustic fingerprints: https://beets.readthedocs.org/page/plugins/chroma.html .. _ReplayGain: https://beets.readthedocs.org/page/plugins/replaygain.html .. _tempos: https://beets.readthedocs.org/page/plugins/acousticbrainz.html .. _genres: https://beets.readthedocs.org/page/plugins/lastgenre.html .. _album art: https://beets.readthedocs.org/page/plugins/fetchart.html .. _lyrics: https://beets.readthedocs.org/page/plugins/lyrics.html .. _MusicBrainz: https://musicbrainz.org/ .. _Beatport: https://www.beatport.com
You can install beets by typing
pip install beets. Beets has also been packaged in the
software repositories_ of several distributions. Check out the
Getting Started_ guide for more information.
.. _Getting Started: https://beets.readthedocs.org/page/guides/main.html .. _software repositories: https://repology.org/project/beets/versions
Thank you for considering contributing to
beets! Whether you're a programmer or not, you should be able to find all the info you need at
.. _CONTRIBUTING.rst: https://github.com/beetbox/beets/blob/master/CONTRIBUTING.rst
Learn more about beets at
its Web site. Follow
@b33tson Twitter for news and updates.
.. _its Web site: https://beets.io/ .. [email protected]: https://twitter.com/b33ts/
open a new ticket_ and we'll be in touch with you shortly.
GitHub Discussions_ or
.. _GitHub Discussions: https://github.com/beetbox/beets/discussions .. _issue tracker: https://github.com/beetbox/beets/issues .. _open a new ticket: https://github.com/beetbox/beets/issues/new/choose .. _Discourse: https://discourse.beets.io/
Beets is by
Adrian Sampson_ with a supporting cast of thousands.
.. _Adrian Sampson: https://www.cs.cornell.edu/~asampson/