No description
Find a file
2011-11-26 15:59:30 -08:00
beets multi-disc album collapsing based on heuristics (#42) 2011-11-26 15:43:26 -08:00
beetsplug use non-minified JavaScript libraries (#259) 2011-11-23 18:26:08 -08:00
docs document multi-disc album collapsing (#42) 2011-11-26 15:59:30 -08:00
test multi-disc album collapsing based on heuristics (#42) 2011-11-26 15:43:26 -08:00
.hgignore Sphinx documentation skeleton 2011-09-16 13:57:15 -07:00
.hgtags Added tag 1.0b10 for changeset 88807657483a 2011-09-22 09:53:17 -07:00
beet misc. overdue code cleanup 2010-07-09 18:07:15 -07:00
LICENSE add readme and news files 2010-06-09 12:37:26 -07:00
MANIFEST.in include manpages in source distribution packages (#258) 2011-11-26 12:28:04 -08:00
README.rst documentation links point to released version 2011-11-23 14:29:12 -08:00
setup.py include manpages in source distribution packages (#258) 2011-11-26 12:28:04 -08:00

Beets is the media library management system for obsessive-compulsive 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:

- Embed and extract album art from files' metadata.
- Listen to your library with a music player that speaks the `MPD`_ protocol
  and works with a staggering variety of interfaces.
- Fetch lyrics for all your songs from databases on the Web.
- Manage your `MusicBrainz music collection`_.
- Analyze music files' metadata from the command line.

If beets doesn't do what you want yet, `writing your own plugin`_ is
shockingly simple if you know a little Python.

.. _plugins: http://readthedocs.org/docs/beets/-/plugins/
.. _MPD: http://mpd.wikia.com/
.. _MusicBrainz music collection: http://musicbrainz.org/show/collection/
.. _writing your own plugin:
    http://readthedocs.org/docs/beets/-/plugins/#writing-plugins

Read More
---------

Learn more about beets at `its Web site`_. Follow `@b33ts`_ on Twitter for
news and updates.

Check out the `Getting Started`_ guide to learn about installing and using
beets.

.. _its Web site: http://beets.radbox.org/
.. _Getting Started: http://readthedocs.org/docs/beets/-/guides/main.html
.. _@b33ts: http://twitter.com/b33ts/

Authors
-------

Beets is by `Adrian Sampson`_.

.. _Adrian Sampson: mailto:adrian@radbox.org