beets: the music geek’s media organizer

Welcome to the documentation for beets, the media library management system for obsessive-compulsive music geeks.

If you’re new to beets, begin with the Getting Started guide. That guide walks you through installing beets, setting it up how you like it, and starting to build your music library.

Then you can get a more detailed look at beets’ features in the Command-Line Interface and Configuration references. You might also be interested in exploring the plugins.

If you still need help, your can drop by the #beets IRC channel on Freenode, send email to the mailing list, or file a bug in the issue tracker. Please let us know where you think this documentation can be improved.

Contents

• Guides
  • Getting Started
  • Using the Auto-Tagger
  • Advanced Awesomeness
• Reference
  • Command-Line Interface
  • Configuration
  • Path Formats
  • Queries
• Plugins
  • Using Plugins
  • Autotagger Extensions
  • Metadata
  • Path Formats
  • Interoperability
  • Miscellaneous
  • Other Plugins
• FAQ
  • How do I…
  • Why does beets…
• For Developers
  • Writing Plugins
  • API Documentation
  • MediaFile

• Changelog