BeamPi

Beamer-Videoplayer für den Raspberry Pi — kompletter Neubau von BeamerPi mit Node.js 24 und moderner Web-UI.

Ein Loop-Video läuft in Dauerschleife im Vollbild (mpv). Per Trigger (Web-UI, HTTP-API oder Webhook) wird das jeweils nächste Video der aktiven Playlist einmal abgespielt, danach geht es zurück zum Loop.

Funktionen

• Playlists mit Loop-Video und geordneter Trigger-Videoliste (erstellen, bearbeiten, umbenennen, duplizieren, löschen, starten)
• Playlist-Editor mit Video-Bibliothek (Ordnerbaum, Ordner-Filter inkl. „Hauptverzeichnis"), Suche, Browser-Vorschau und Drag-&-Drop-Sortierung
• Live-Status (Standby / Loop / On Air) per Server-Sent-Events
• Live-Vorschau im Dashboard: zeigt positionssynchron, was der Beamer gerade ausgibt – mit Fortschritts-Laufband und Restzeit-Anzeige des laufenden Videos
• Lautstärkeregler steuert die komplette System-Lautstärke (ALSA/amixer, z. B. HDMI-Ausgang), nicht nur mpv
• Einstellungen: Audio-Ausgabegerät, Videoverzeichnis, Auto-Start-Playlist
• Video-Upload mit wählbarem Zielordner und „Neuen Ordner anlegen" direkt im Browser (auch verschachtelte Unterordner)
• Ausgehende Webhooks bei Trigger-Start und Trigger-Ende (sendet JSON per POST; schlägt das fehl, wird ersatzweise ein GET-Aufruf versucht)
• GPIO-Taster pro Playlist: jede Playlist kann einen eigenen BCM-Pin definieren (Taster zwischen Pin und GND, interner Pull-up). Ein Druck schaltet genau diese Playlist zum nächsten Video weiter und aktiviert sie bei Bedarf; jeder Pin gehört nur einer Playlist. Die Entprellzeit gilt global (Einstellungen); benötigt das Paket gpiod
• USB-Stick-Modus mit Hotplug: vorbereiteten USB-Stick einstecken – auch im laufenden Betrieb, ganz ohne Web-Oberfläche und ohne Neustart
• Trigger-Schutz: solange ein getriggertes Video läuft, werden weitere Trigger (Web, GPIO, Webhook, Auto-Trigger) ignoriert – erst nach Videoende geht es weiter
• Software-Update per Knopfdruck unter „Einstellungen → Software-Update": zieht den neuesten Stand direkt von GitHub und startet neu – Playlists, Videos und Einstellungen bleiben erhalten
• HTTP-API kompatibel zum Original

USB-Stick-Modus (ohne Technikkenntnisse)

Für Leute, die weder Linux noch die Web-Oberfläche anfassen möchten: einen USB-Stick so vorbereiten und einstecken – der Stick übernimmt dann automatisch die Wiedergabe, egal ob beim Einschalten oder im laufenden Betrieb.

So wird der Stick vorbereitet (FAT32 oder exFAT formatiert):

USB-Stick/
├─ Videos/
│  ├─ 001.mp4        ← Videos in Abspielreihenfolge benennen
│  ├─ 002.mp4
│  ├─ 003.mp4
│  └─ loop.mp4       ← optional: läuft in Dauerschleife zwischen den Videos
└─ beampi.txt        ← Wartezeit für den Auto-Trigger

Inhalt von beampi.txt (legt fest, wie lange zwischen zwei Videos gewartet wird):

minuten=1
sekunden=30

Sobald der Stick steckt, gilt: Der loop.mp4 läuft in Dauerschleife (ohne loop.mp4 bleibt der Hintergrund schwarz). Alle 1 min 30 s wird automatisch das nächste Video aus Videos/ abgespielt – der Reihe nach, danach wieder von vorn. Fehlt beampi.txt, gilt eine Wartezeit von 30 Sekunden.

Der Stick wird schreibgeschützt gelesen (die Videos werden nicht verändert), daher kann er jederzeit gefahrlos abgezogen werden. Hotplug: Du kannst ihn im laufenden Betrieb einstecken oder abziehen – BeamPi schaltet automatisch um, ein Neustart ist nicht nötig. Steckt kein Stick, läuft BeamPi normal mit den gespeicherten Playlists; beim Abziehen kehrt es von selbst dorthin zurück.

Anmeldung

Die Web-UI ist passwortgeschützt. Erstanmeldung: Benutzer admin, Passwort beampi – danach wird ein Passwortwechsel erzwungen. Die Sitzung bleibt 180 Tage gespeichert (Cookie). Passwort später ändern: Einstellungen → „Passwort ändern".

Passwort vergessen – auf dem Pi im Projektverzeichnis (/opt/beampi):

npm run set-password -- "MeinNeuesGeheim"   # neues Passwort direkt setzen
npm run reset-password                       # zurück auf admin/beampi (Zwangswechsel)

Beides beendet alle offenen Sitzungen und braucht keinen Server-Neustart. Alternativ schlicht data/auth.json löschen und den Dienst neu starten – das setzt ebenfalls auf admin/beampi zurück.

Ohne Anmeldung erreichbar bleiben die Maschinen-Endpunkte für Trigger-Hardware: /api/trigger und /webhook/<playlist>.

HTTP-API

Methode	Pfad	Beschreibung
GET/POST	/api/trigger	Nächstes Video triggern, optional ?playlist=Name
POST	/webhook/<playlist>	Playlist starten und sofort erstes Video triggern
GET	/api/status	Player-Status + aktive Playlist + Fortschritt
GET	/api/player/position	Abspielposition des laufenden Videos (von mpv)
GET	/api/state	Kompletter Zustand (Playlists, Settings, Status)
GET	/api/events	Server-Sent-Events-Stream mit Live-Status
GET	/api/playlists	Alle Playlists
POST	/api/playlists	Playlist anlegen {name, loop_video, videos, gpio_pin} (gpio_pin optional, BCM 0–27 oder leer)
PUT	/api/playlists/<name>	Playlist ändern (inkl. gpio_pin)
DELETE	/api/playlists/<name>	Playlist löschen
POST	/api/playlists/<name>/rename	Playlist umbenennen {name} – aktive/Auto-Start-Referenzen ziehen mit
POST	/api/playlists/<name>/duplicate	Playlist duplizieren (optional {name})
POST	/api/playlists/<name>/start	Playlist aktivieren
GET	/api/videos	Video-Bibliothek (Liste, Baum, Größen/Dauern, freier Speicher)
GET	/api/thumbs/<pfad>	Thumbnail eines Videos (wird on-demand erzeugt)
DELETE	/api/files	Videodatei löschen {path}
POST	/api/files/rename	Datei umbenennen/verschieben {from, to} – Playlists ziehen mit
DELETE	/api/folders	Leeren Ordner löschen {path}
GET	/videos/<pfad>	Videodatei streamen (Range-Support)
GET/PUT	/api/settings	Einstellungen lesen/schreiben
PUT	/api/volume	Lautstärke/Stumm setzen {volume, muted}
PUT	/api/auto-trigger	Auto-Trigger setzen {enabled, interval_s}
GET	/api/audio-devices	Verfügbare mpv-Audio-Ausgänge auflisten
POST	/api/folders	Ordner anlegen {path}
POST	/api/upload	Videos hochladen (multipart, Feld video_files)
GET	/api/version	Installierte Version + Abgleich mit GitHub {current, latest, update_available}
POST	/api/update	Self-Update anstoßen (zieht den neuesten Stand, startet neu)

Installation auf dem Raspberry Pi

Voraussetzungen: Raspberry Pi OS (Desktop), Node.js ≥ 24, mpv.

sudo apt install -y mpv
sudo mkdir -p /opt/beampi && sudo chown pi:pi /opt/beampi
# Projektdateien nach /opt/beampi kopieren, dann:
cd /opt/beampi && npm install --omit=dev
sudo cp deploy/beampi.service deploy/beampi-usb.service deploy/beampi-usb-umount.service /etc/systemd/system/
sudo cp deploy/99-beampi-usb.rules /etc/udev/rules.d/   # USB-Hotplug
sudo udevadm control --reload-rules
sudo systemctl daemon-reload
sudo systemctl enable --now beampi-usb.service   # USB-Stick beim Boot mounten
sudo systemctl enable --now beampi

beampi-usb.service hängt einen vorbereiteten USB-Stick (siehe oben) schreibgeschützt nach /media/beampi-usb ein. Ohne Stick passiert nichts. Die Mount-Skripte (mount-usb.sh/umount-usb.sh) werden direkt aus /opt/beampi/deploy/ ausgeführt – sie müssen nicht extra kopiert werden.

USB-Hotplug: Mit der udev-Regel 99-beampi-usb.rules wird ein Stick auch im laufenden Betrieb automatisch eingehängt bzw. beim Abziehen wieder ausgehängt – BeamPi prüft alle paar Sekunden auf Änderungen und startet die USB-Show bzw. kehrt zum Normalbetrieb zurück, ganz ohne Neustart.

Web-UI: http://<pi-ip>:8080

Konfiguration über Umgebungsvariablen: PORT (Standard 8080), BEAMPI_DATA_DIR (Datenverzeichnis, Vorgabe ./data), BEAMPI_VIDEO_DIR (Videoverzeichnis, Vorgabe /opt/beampi/videos).

Deployment

./deploy.sh pusht zu GitHub und synchronisiert per rsync auf den Pi. Der Dienst wird nur neu gestartet, wenn sich Server-Code geändert hat — reine UI-Änderungen laufen ohne Unterbrechung der Wiedergabe ein. ./deploy.sh --no-push überspringt den GitHub-Push.

Das SSH-Passwort liest das Skript aus .deploy-pass (nicht im Repo) oder $BEAMPI_SSH_PASS; mit eingerichtetem SSH-Key braucht es gar keins. Host/Pfad/Port sind per BEAMPI_HOST, BEAMPI_PATH, BEAMPI_PORT übersteuerbar.

Self-Update vom Pi aus

Statt deploy.sh kann der Pi sich auch selbst aktualisieren: „Einstellungen → Software-Update → Jetzt aktualisieren". Dahinter steckt deploy/self-update.sh — es lädt den aktuellen main-Stand als Tarball von GitHub (kein git-Clone nötig), ersetzt den Code per rsync (ohne data/, videos/, node_modules/, Secrets), ruft npm install und beendet den Dienst; systemd (Restart=always) startet ihn mit dem neuen Code neu. Voraussetzung: curl, tar und rsync auf dem Pi (Standard bei Raspberry Pi OS). Da der reguläre Weg ohnehin lokal → GitHub → Pi läuft, zieht der Knopf genau den Stand, den deploy.sh zuvor gepusht hat.