Anleitung

Auf Geräten installieren

Android

Voraussetzung: Google Chrome (empfohlen) oder Microsoft Edge, Android 8 oder neuer.

1. Die App-Adresse (z. B. https://listiges-kaenguru.github.io/cue-player/) in Chrome öffnen.
2. Chrome zeigt unten „App installieren“ – antippen. Falls nicht: Menü ⋮ → App installieren (bzw. „Zum Startbildschirm hinzufügen“).
3. Die App erscheint auf dem Startbildschirm und in der App-Übersicht und öffnet sich ohne Browserleiste.
4. Einmal mit Internet öffnen – danach funktioniert sie offline.

Empfohlene Einstellungen für den Show-Einsatz:

• Einstellungen → Apps → Chrome → Akku → Nicht eingeschränkt (sonst kann Android den Browser drosseln).
• Bitte-nicht-stören aktivieren (keine Benachrichtigungstöne über die Anlage!).
• In Cue Player unter ⚙ „Bildschirm nicht abschalten“ aktiv lassen.
• In Cue Player unter ⚙ → Speicher → „Dauerhaft: Anfordern“ antippen.
• Audio über Kopfhörerbuchse oder USB-Audio-Interface (USB-C) ausgeben; Bluetooth hat hohe Latenz (100–300 ms) und ist für Shows ungeeignet.

MIDI auf Android: USB-MIDI-Geräte (per OTG-Adapter) werden von Chrome erkannt. Beim Aktivieren von MIDI fragt Chrome nach der Berechtigung.

Windows

Voraussetzung: Microsoft Edge oder Google Chrome (Windows 10/11).

1. App-Adresse öffnen.
2. In der Adressleiste rechts auf das Symbol „App installieren“ (Monitor mit Pfeil) klicken – oder Menü ⋯ → Apps → Diese Website als App installieren (Edge) bzw. ⋮ → Streamen, speichern und teilen → Seite als App installieren (Chrome).
3. Die App bekommt ein eigenes Fenster, einen Startmenü-Eintrag und kann an die Taskleiste angeheftet werden.

Tipps:

• Ausgabegerät (z. B. USB-Interface) in Cue Player unter ⚙ → Ausgabegerät wählen. Um Gerätenamen statt „Ausgang 1, 2 …“ zu sehen, „Namen anzeigen“ klicken und die Mikrofon-Freigabe erlauben (wird nur für die Gerätenamen benötigt).
• Windows-Systemklänge für die Show abschalten.
• Energieoptionen: „Höchstleistung“, Bildschirmschoner aus.

Linux

Voraussetzung: Chromium, Google Chrome, Brave oder Microsoft Edge.

1. App-Adresse öffnen.
2. Installieren-Symbol in der Adressleiste anklicken (oder Menü ⋮ → … → Seite als App installieren).
3. Der Browser legt einen Starter (.desktop-Datei) an – die App erscheint im Anwendungsmenü.

Hinweise:

• Firefox kann die Seite benutzen, aber nicht als App installieren und bietet keine Ausgabegerät-Auswahl. Für den Show-Betrieb Chromium-basierte Browser verwenden.
• Chromium als Snap/Flatpak: Für MIDI-Geräte ggf. Zugriff erlauben (snap connect chromium:alsa, bzw. bei Flatpak --device=all).
• Audio läuft über PulseAudio/PipeWire. Mit PipeWire lässt sich die Ausgabe der App mit qpwgraph/helvum frei routen – auch auf mehrkanalige Interfaces.
• Zeigt die installierte App nur einen grauen Buchstaben statt des Icons, konnte der Browser die Icons bei der Installation nicht laden (z. B. Version vor 0.5.1 auf einem Apache-Server). Die App deinstallieren und nach dem Update neu installieren – das Icon wird nur bei der Installation übernommen.

Diese Anleitung beschreibt Cue Player 0.5.5. Sie entspricht der Datei docs/INSTALLATION.md im Quelltext.