boWave/AUDIO_SETUP_REAL.md

🎵 Echtes Audio Setup - Spotify & AirPlay

✅ FIXES ANGEWENDET

1. VITE_USE_MOCK = false

• Dashboard nutzt jetzt echte Services
• Keine Mock-Daten mehr
• Verbindet zu Mopidy, Snapcast, SignalK

2. Karte crasht nicht mehr

• Simple Navigation Map (ohne MapLibre)
• Zeigt Position, Kurs, Geschwindigkeit
• Kein externer Tile-Server nötig

---

🎯 WICHTIG: Audio im Dev-Mode

Warum hörst du NICHTS?

Im Dev-Mode:

Spotify/AirPlay/Mopidy
    ↓
/tmp/audio/*.pcm (Named Pipes)
    ↓
Snapserver (Docker)
    ↓
Snapclients (Docker mit --player file:filename=null)
    ↓
🔇 Audio wird VERWORFEN (null player)

Warum?

• Docker kann nicht direkt zu Windows-Lautsprechern
• Audio-Pipes funktionieren nicht über Docker Desktop VM-Grenze
• Die Zonen nutzen --player file:filename=null = stumm

---

🔊 3 WEGE UM AUDIO ZU HÖREN

Option 1: Snapcast Web Audio (Browser) ✅ EINFACHST

So gehts:

1. Öffne: http://localhost:1780
2. Klicke auf 🔊 Symbol (oben rechts)
3. Wähle eine Zone (z.B. "zone-salon")
4. Browser fragt nach Mikrofon-Berechtigung → Erlaube (nutzt nur Audio OUT!)
5. Musik in Mopidy starten → http://localhost:6680/iris/
6. Audio läuft über deinen Browser!

Vorteile:

• ✅ Keine Installation
• ✅ Funktioniert sofort
• ✅ Web Audio API (Chrome, Firefox, Edge)

Nachteile:

• ⚠️ Tab muss offen bleiben
• ⚠️ Kann latency haben (~500ms)

---

Option 2: Snapclient auf Windows (Native) ✅ BESTE QUALITÄT

Installation:

1. Download: https://github.com/badaix/snapcast/releases/latest
2. Datei: snapclient-X.XX.X-win64.zip
3. Entpacken nach C:\Program Files\Snapcast\

Starten:

# Terminal öffnen
snapclient --host localhost --port 1704 --hostID windows-pc --player wasapi

Oder mit make (falls installiert):

make windows-audio

Vorteile:

• ✅ Perfekte Audio-Qualität
• ✅ Niedrige Latenz (~20ms)
• ✅ Native Windows Audio (WASAPI)

Nachteile:

• ⚠️ Muss manuell gestartet werden
• ⚠️ Extra Terminal-Fenster

---

Option 3: Docker Zone mit PulseAudio (WSL2) ⚠️ NUR LINUX

Nur wenn du WSL2 mit PulseAudio hast:

# In WSL2 Terminal
pulseaudio --start

Dann in docker-compose.dev.yml:

zone-windows:
  build: ./docker/snapclient
  command: ["--hostID", "zone-windows", "--player", "pulse"]
  environment:
    - PULSE_SERVER=unix:/run/user/1000/pulse/native
  volumes:
    - /run/user/1000/pulse:/run/user/1000/pulse

Nicht empfohlen für Windows!

---

🎵 MUSIK QUELLEN AKTIVIEREN

Spotify Connect ✅

Im Dev-Mode läuft librespot als Stub (dummy).

Um echtes Spotify zu nutzen:

Option A: Librespot auf Windows (EMPFOHLEN)

# Download: https://github.com/librespot-org/librespot/releases
# Oder mit Rust installieren:
cargo install librespot

# Starten:
librespot --name "Bordanlage" --backend rodio

Dann in Spotify App → Geräte → "Bordanlage" auswählen

Option B: Docker librespot (Production Mode)

# Nutze docker-compose.yml (ohne .dev overlay)
docker compose up -d librespot

⚠️ Aber: Audio geht nach /tmp/audio/spotify.pcm → Du hörst nichts!

---

AirPlay ✅

Shairport-Sync läuft im Docker.

Von iPhone/Mac:

1. Control Center öffnen
2. AirPlay Symbol
3. "Bordanlage AirPlay" auswählen
4. Musik abspielen

⚠️ Problem: Audio geht nach /tmp/audio/airplay.pcm → Du hörst nichts!

Lösung:

• Nutze Snapcast Web Audio (Option 1)
• Oder native Snapclient (Option 2)
• AirPlay → Pipe → Snapserver → Snapclient → Windows!

---

Mopidy (Local Files + Radio) ✅

Läuft bereits!

Musik abspielen:

1. Öffne: http://localhost:6680/iris/
2. Klicke "Browse" → "TuneIn"
3. Suche "BBC Radio" oder "NDR"
4. Klicke auf Sender → Play

Local Files:

1. Kopiere MP3/FLAC nach ./music/
2. Library Scan triggern:

   curl -X POST http://localhost:6680/mopidy/rpc `
     -H "Content-Type: application/json" `
     -d '{"jsonrpc":"2.0","id":1,"method":"library.refresh"}'
   

3. Warte ~30 Sek
4. Reload Mopidy UI → Files sind da!

---

🧪 AUDIO TEST WORKFLOW

Test 1: Mopidy → Snapcast → Browser

1. Öffne: http://localhost:6680/iris/
   → Klicke Browse → TuneIn
   → Wähle "BBC Radio 1"
   → Klicke Play

2. Öffne: http://localhost:1780
   → Klicke 🔊 Symbol
   → Wähle "zone-salon"
   → Erlaube Browser Audio

3. Musik sollte jetzt laufen! 🎵

Falls nicht:

• F12 → Console → Fehler?
• Snapcast Web zeigt "zone-salon" connected?
• Mopidy zeigt "Playing"?

---

Test 2: Dashboard Player

1. Öffne: http://localhost:8090

2. Klicke Tab "Audio"
   → Klicke "Radio" Sub-Tab
   → Suche "BBC" oder "NDR"
   → Klicke auf Sender

3. Zurück zu "Overview" Tab
   → Player zeigt Track
   → [▶] Play/Pause funktioniert

4. Browser Audio aktivieren (Snapcast Web)
   → http://localhost:1780
   → 🔊 Symbol → Zone wählen

---

🔧 TROUBLESHOOTING

Problem: "Dashboard zeigt 'Audio not connected'"

Ursache: Mopidy WebSocket Connection failed

Fix:

# Mopidy Logs prüfen
docker compose -f docker-compose.yml -f docker-compose.dev.yml logs mopidy

# Mopidy neu starten
docker compose -f docker-compose.yml -f docker-compose.dev.yml restart mopidy

# Browser neu laden (Ctrl+R)

Problem: "Zones zeigen alle 'offline'"

Ursache: Snapcast JSON-RPC Connection failed

Fix:

# Snapserver Logs prüfen
docker compose -f docker-compose.yml -f docker-compose.dev.yml logs snapserver

# Snapserver neu starten
docker compose -f docker-compose.yml -f docker-compose.dev.yml restart snapserver

# Alle Zonen neu starten
docker compose -f docker-compose.yml -f docker-compose.dev.yml restart zone-salon zone-cockpit zone-bug zone-heck

Problem: "Snapcast Web Audio funktioniert nicht"

Check:

1. Nutzt du Chrome/Firefox/Edge? (Safari hat Probleme)
2. Hast du Mikrofon-Berechtigung erteilt? (wird für Web Audio benötigt)
3. Tab bleibt offen?
4. F12 → Console → Web Audio Fehler?

Fix:

// Browser Console:
navigator.mediaDevices.getUserMedia({ audio: true })
  .then(() => console.log("✅ Audio erlaubt"))
  .catch(err => console.log("❌ Audio blockiert:", err))

Problem: "Spotify Device wird nicht gefunden"

Im Dev-Mode:

• librespot läuft als Stub (dummy)
• Nutze native librespot auf Windows (siehe oben)

Production Mode:

• docker-compose.yml nutzen (ohne .dev)
• Aber: Audio geht nach Pipe, du hörst nichts!
• → Nutze native librespot

---

📊 SERVICE STATUS PRÜFEN

# Alle Audio Services
docker compose -f docker-compose.yml -f docker-compose.dev.yml ps | findstr "mopidy snapserver zone"

# Mopidy API Test
curl http://localhost:6680/mopidy/rpc -X POST -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"core.get_version"}'

# Snapcast Status (WebSocket, schwieriger zu testen)
# → Nutze http://localhost:1780 (Web UI)

# SignalK API Test
curl http://localhost:3000/signalk/v1/api/vessels/self

---

✅ ZUSAMMENFASSUNG

Was funktioniert JETZT:

✅ Dashboard:

• Echte Services (VITE_USE_MOCK=false)
• Kein Karten-Crash mehr (Simple Map)
• Audio Player zeigt echte Mopidy-Daten

✅ Audio System:

• Mopidy läuft (Port 6680)
• Snapserver läuft (Port 1704, 1705, 1780)
• 4 Zonen connected (aber stumm)

✅ Musik Quellen:

• Mopidy + Iris (Local Files + TuneIn Radio)
• Shairport (AirPlay Receiver)
• librespot (Spotify Connect - als Stub)

Was du noch tun musst:

❗ Audio hören:

1. Einfach: Snapcast Web Audio (http://localhost:1780 → 🔊)
2. Best: Native Snapclient auf Windows

❗ Spotify aktivieren:

• Native librespot auf Windows starten (siehe Anleitung oben)

❗ AirPlay testen:

• iPhone → AirPlay → "Bordanlage AirPlay"
• Audio hören → Snapcast Web Audio aktivieren

---

🚢 AUF DEM BOOT (später)

Dann funktioniert ALLES automatisch:

• Echte ALSA-Lautsprecher in Zonen
• Spotify Connect über Boot-Netzwerk
• AirPlay über Boot-Netzwerk
• Alles läuft ohne Windows

Setup: Siehe KIOSK_SETUP.md