Unter der Haube
Docker-basierte Player, API-first SaaS, MCP für AI-Integration — alles was dein Technikteam für die Evaluierung braucht.
SaaS-Plattform
media-player.app ist ein vollständig verwalteter Cloud-Service. Kein eigener Server, keine Installation, keine Wartung. Du kümmerst dich um deine Inhalte — wir um die Infrastruktur.
Gehostet & verwaltet
Docker als Runtime
Architektur
Jedes Display wird von drei isolierten Docker-Containern betrieben. Läuft auf jedem Linux-System mit Docker — vom Raspberry Pi bis zum x86-Server. Klare Verantwortlichkeiten, unabhängig skalierbar und einzeln aktualisierbar.
Agent
SteuerungsebeneGeräteregistrierung, Token-Verwaltung, Content-Download und Playlist-Scheduling. Stellt eine lokale API auf Port 7071 bereit, über die der Playback-Container gesteuert wird.
Playback
Wiedergabe-EbeneEinheitliche lokale API auf Port 7070. Nutzt mpv für hardware-beschleunigtes Video (DRM/KMS) und Chromium im Kiosk-Modus für Web-Inhalte. Verwaltet Übergänge zwischen Elementen.
Heartbeat
MonitoringSendet regelmäßig Gesundheitsdaten ans Backend: CPU-Temperatur, Last, Speicher, Festplatte. Implementiert Watchdog-Logik für automatische Container-Neustarts.
Storage-Architektur
Update-Mechanismus
Unterstützte Hardware
Die Player-Software ist Docker-basiert und läuft auf jedem Linux-System mit Docker. Optimiert für ARM64 (Raspberry Pi) und AMD64 (x86-Server, Mini-PCs). Unterstützung für kommerzielle SoC-Displays ist in Planung.
Raspberry Pi 5
EmpfohlenRaspberry Pi 4
UnterstütztLinux x86 / Mini-PC
UnterstütztCommercial Display SoC
GeplantPlayback Engine
Hybride Wiedergabe: mpv für Video und Bilder mit Hardware-Beschleunigung via DRM/KMS/VAAPI, Chromium für Web-Inhalte im Kiosk-Modus. Der Agent-Container steuert die Wiedergabe über eine lokale REST-API.
mpv — Video & Bilder
Hardware-beschleunigte Dekodierung über V4L2 M2M (Raspberry Pi) oder VAAPI (x86). Framebuffer-Ausgabe über DRM/KMS für minimale Latenz, ohne X11 oder Wayland.
Chromium — Web-Inhalte
Headless Chromium im Kiosk-Modus für HTML-Seiten, Dashboards und interaktive Inhalte. Steuerung über Chrome DevTools Protocol (CDP).
| Format | Codec / Decoder | HW-Beschleunigung | Max. Auflösung |
|---|---|---|---|
| H.264 / AVC | h264_v4l2m2m | ✓ Hardware | 4K 30fps |
| H.265 / HEVC | hevc_v4l2m2m | ✓ Hardware | 4K 60fps |
| VP9 | vp9_v4l2m2m | ✓ Hardware | 4K 30fps |
| AV1 | av1 (SW) | — CPU | 1080p |
| JPEG / PNG | GPU decode | ✓ Hardware | 4K |
| HTML / CSS / JS | Chromium | — CPU | Fullscreen |
Content Pipeline
Vom Upload bis zur Wiedergabe: Jede Datei wird verifiziert, versioniert und atomar auf die Player synchronisiert. Der Player spielt immer einen konsistenten Stand — nie einen halben Download.
Upload & Versionierung
Verifizierung & Storage
Plan-Sync & Aktivierung
Sicherheit
Multi-Tenant Isolation, verschlüsselte Kommunikation und tokenbasierte Authentifizierung. Kein Gerät hat Zugriff auf Daten anderer Tenants.
Authentifizierung
Tenant-Isolation
Geräte-Sicherheit
Transport-Sicherheit
REST API
Die gesamte Plattform ist API-first. Alles, was das Dashboard kann, kannst du auch über die REST API automatisieren. OpenAPI-Dokumentation inklusive.
# Player abrufen
GET /api/v1/players
GET /api/v1/players/{id}
GET /api/v1/players/{id}/health
# Inhalte erstellen
POST /api/v1/media-items
POST /api/v1/playlists
POST /api/v1/channels
# Zuordnungen
PUT /api/v1/playlists/{id}/items
PUT /api/v1/channels/{id}/playlists
# Authentifizierung
Authorization: Bearer {token}
X-Tenant-ID: {tenant_id}
Content-Type: application/jsonRESTful JSON API
Konsistente Ressourcen-Struktur, HTTP-Verben, Standard-Statuscodes. JSON Request/Response.
OpenAPI 3.1 Docs
Automatisch generierte, interaktive API-Dokumentation. Teste Endpunkte direkt im Browser.
Cursor-Pagination
Effiziente Seitenblätterung für große Datenmengen. Filter, Sortierung und Suche auf allen Listen.
MCP — AI-Integration
media-player.app implementiert das Model Context Protocol (MCP) als First-Class-Integrationssurface. Neben der REST API können AI-Agents, n8n-Workflows und LangChain-Pipelines die Plattform direkt steuern.
Was ist MCP?
Das Model Context Protocol ist ein offener Standard für die Kommunikation zwischen AI-Agents und externen Systemen. Statt einer proprietären API können beliebige AI-fähige Clients (Claude, GPT, eigene LLMs) die Plattform über Tools, Resources und Prompts steuern.
MCP Tools
Anwendungsfälle
Sicherheit
Monitoring & Telemetrie
Jedes Display sendet in konfigurierbaren Intervallen Gesundheitsdaten an das Backend. Der Heartbeat-Container sammelt System-Metriken und Playout-Events.
| Metrik | Quelle | Intervall |
|---|---|---|
| CPU Temperature | /sys/class/thermal | 30s |
| CPU Load | /proc/loadavg | 30s |
| Memory Usage | /proc/meminfo | 30s |
| Disk Usage | statvfs() | 60s |
| Network Latency | API ping | 60s |
| Playout Events | Playback Engine | realtime |
| Container Status | Docker API | 30s |
| Display State | HDMI / CEC | 30s |
Netzwerk-Anforderungen
Die Player benötigen eine ausgehende Internetverbindung. Eingehende Ports müssen nicht geöffnet werden — der Player verbindet sich zum Backend, nicht umgekehrt.
Ausgehende Verbindungen
Bandbreite & Offline
Auf einen Blick
SaaS-Plattform
Player Runtime
Plattformen
Integration
Monitoring
Sicherheit
Überzeugt?
Teste media-player.app kostenlos oder wirf einen Blick in die API-Dokumentation.
Wir nutzen deine E-Mail ausschließlich zur Launch-Benachrichtigung. Kein Spam.