Skip to main content
`Ctrl`+`K`

# beets: the music geek’s media organizer

Welcome to the documentation for beets, the media library management system for obsessive 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, you can drop by the `#beets` IRC channel on Libera.Chat, drop by the discussion board or file a bug in the issue tracker. Please let us know where you think this documentation can be improved.

## Contents

- Guides
  - Getting Started
  - Installation
  - Using the Auto-Tagger
  - Advanced Awesomeness
- Reference
  - Command-Line Interface
  - Configuration
  - Path Formats
  - Queries
- Plugins
  - Using Plugins
  - Using Metadata Source Plugins
  - Autotagger Extensions
  - Metadata
  - Path Formats
  - Interoperability
  - Miscellaneous
  - Other Plugins
- FAQ
  - How do I…
  - …report a bug in beets?
  - Why does beets…
- Team
  - @arsaboo
  - @bal-e
  - @govynnus
  - @jackwilsdon
  - @joj0
  - @RollingStar
  - @sampsyo
  - @serene-arc
  - @wisp3rwind
  - @ybnd
- Contributing
  - Thank you!
  - Types of Contributions
  - Your First Contribution
  - How to Submit Your Work
  - The Code
  - Coding Conventions
  - Testing
- Contributor Covenant Code of Conduct
  - Our Pledge
  - Our Standards
  - Enforcement Responsibilities
  - Scope
  - Enforcement
  - Enforcement Guidelines
  - Attribution
- For Developers
  - Plugin Development
  - Library Database API
  - Music Importer
  - Providing a CLI
  - API Reference

- Changelog