48 lines
1.4 KiB
Markdown
48 lines
1.4 KiB
Markdown
# 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)
|