add readme

README.md

@@ -0,0 +1,47 @@
+# Mopidy Music Server Configuration
+
+This repository contains the configuration and setup for the local Mopidy instance. Mopidy acts as the primary music logic server (Radio, Local Files, Extensions) feeding into the Snapcast multi-room audio system.
+
+## 🎵 System Architecture
+
+*   **Core:** Mopidy (Python-based music server).
+*   **Output:** Pipes audio to Snapserver via a Named Pipe (`/tmp/snapfifo`).
+*   **Frontend:** Iris Web Interface (Port 6680).
+*   **Extensions:** `mopidy-radionet`, `mopidy-local`, etc.
+
+## 📂 Key Files
+
+*   **`mopidy.conf`**: The master configuration file. Controls enabled plugins, file paths, and GStreamer audio pipelines.
+*   **`requirements.txt`** (Optional): Python pip dependencies for installed plugins.
+
+## ⚙️ Configuration Highlights
+
+### Audio Output (Snapcast Link)
+To ensure compatibility with Snapserver, the audio output is forced to **48kHz Stereo 16-bit** and written to the pipe:
+
+```ini
+[audio]
+output = audioresample ! audioconvert ! audio/x-raw,rate=48000,channels=2,format=S16LE ! wavenc ! filesink location=/tmp/snapfifo
+```
+
+## 🚀 Management Commands
+
+**Restart Service:**
+```bash
+sudo systemctl restart mopidy
+```
+
+**Check Status & Logs:**
+```bash
+sudo systemctl status mopidy
+sudo journalctl -u mopidy -f
+```
+
+**Rescan Local Library:**
+```bash
+sudo mopidy local scan
+```
+
+**Config Location:**
+*   `/etc/mopidy/mopidy.conf` (System Service)
+*   `~/.config/mopidy/mopidy.conf` (User Mode)