beets/index.md
2016-06-21 22:22:56 -07:00

55 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
layout: main
section: main
shorttitle: the music geeks media organizer
---
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 using
the [MusicBrainz][] database. Then it provides a bouquet of tools for
manipulating and accessing your music.
[MusicBrainz]: http://musicbrainz.org/
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:
[plugins]: http://beets.readthedocs.org/page/plugins/
* Fetch or calculate all the metadata you could possibly need: [album art][],
[lyrics][], [genres][], [tempos][], [ReplayGain][] levels, or [acoustic
fingerprints][chroma].
* Get metadata from [MusicBrainz][], [Discogs][], or [Beatport][]. Or guess
metadata using songs' filenames or their acoustic fingerprints.
* [Transcode audio][convert] to any format you like.
* Check your library for [duplicate tracks and albums][duplicates] or for
[albums that are missing tracks][missing].
* Browse your music library graphically through a Web browser and play it in
any browser that supports [HTML5 Audio][].
* ...and [lots more][plugins].
[plugins]: http://beets.readthedocs.org/page/plugins/
[album art]: http://beets.readthedocs.org/page/plugins/fetchart.html
[lyrics]: http://beets.readthedocs.org/page/plugins/lyrics.html
[genres]: http://beets.readthedocs.org/page/plugins/lastgenre.html
[tempos]: http://beets.readthedocs.org/page/plugins/echonest_tempo.html
[ReplayGain]: http://beets.readthedocs.org/page/plugins/replaygain.html
[chroma]: http://beets.readthedocs.org/page/plugins/chroma.html
[Discogs]: http://www.discogs.com/
[Beatport]: http://www.beatport.com/
[convert]: http://beets.readthedocs.org/page/plugins/convert.html
[duplicates]: http://beets.readthedocs.org/page/plugins/duplicates.html
[missing]: http://beets.readthedocs.org/page/plugins/missing.html
[HTML5 Audio]: http://www.w3.org/TR/html-markup/audio.html
If beets doesn't do what you want yet, [writing your own plugin][writing] is
shockingly simple if you know a little Python.
[writing]: http://beets.readthedocs.org/page/dev/plugins.html
<p class="teaser">Install beets by typing
<code><a href="http://www.pip-installer.org/">pip</a> install beets</code>.
You might then want to read the
<a href="http://beets.readthedocs.org/page/guides/main.html">Getting
Started</a> guide. Then follow
<a href="http://twitter.com/b33ts">@b33ts</a>
on Twitter for updates.</p>