# Beets Music Management: Docker & Portainer Guide

Welcome!  
I struggled with Beets setup and wanted to share my configs, tips, and troubleshooting for anyone else working on music management with Docker and Portainer.

---

## Quick Start

**Tested On:**
- Debian 12
- Docker
- Docker Compose *(optional, for Portainer stacks)*
- Portainer Business Edition *(optional; note: can be buggy with stuck containers/stacks)*

> **Note:**  
> Replace anything marked `(redacted)` with your own API keys.

---

## How I Use Beets

- Most configs and example files are well-commented—please read through them first!
- I use Lidarr arr-scripts to manage my music library.
- This setup is still in **testing phase**, but works without damaging your library.

---

## Help & Community

- **Discord:** [Join for help or discussion](https://discord.gg/9xzTtCxauJ)
- **Issues:** Feel free to [open an issue](../../issues) with questions or suggestions.

---

## Unsolved Problems

- **Spotify as Only Indexer:**  
  After running for a while, only Spotify shows up as an indexer, even with DNS access to MusicBrainz. Is this a block?  
  *Would prefer Beets to stop if it can't reach all indexers, to ensure best results.*

- **Multi-Indexer Genre Combining:**  
  How to combine genres from multiple sites instead of using just one?  
  *WLG is broken—could submit a PR for a better method.*

- **Exporting Lyrics (.lrc):**  
  Want to export to `.lrc` for Navidrome/Plex lyric support.  
  *Currently, only `.pdf` export is available.*

---

## Tips

- Read through all config files for comments and explanations.
- Use Docker Compose for easier stack management, but be aware of Portainer quirks.
- Always backup your music library before testing new configs.

---

*Happy tagging and organizing!*