Ünner de Huuv
Docker-basierte Player, API-first SaaS, MCP för AI-Integration — allens wat dien Technikteam för de Evalueeren bruukt.
SaaS-Plattform
media-player.app is een vollstännig verwaltet Cloud-Service. Keen egen Server, keen Installatschon, keen Wartung. Du kümmerst di üm dien Inholden — wi üm de Infrastruktur.
Gehostet & verwaltet
Docker as Runtime
Architektur
Jedes Display warrt vun dree isoleerte Docker-Containers bedreven. Löppt op jedes Linux-System mit Docker — vun'n Raspberry Pi bit to'n x86-Server. Klare Verantwoortlichkeiten, unafhängig skaleerbar un enkel aktualiseerbar.
Agent
StüürungsebeneGeräteregistreeren, Token-Verwaltung, Content-Download un Playlist-Scheduling. Stellt een lokale API op Port 7071 bereit, över de de Playback-Container stüürt warrt.
Playback
Weergave-EbeneEenheitliche lokale API op Port 7070. Bruukt mpv för hardware-beschleunigte Video (DRM/KMS) un Chromium in'n Kiosk-Modus för Web-Inholden. Verwaltet Övertöge twüschen Elementen.
Heartbeat
MonitoringSendt regelmatig Gesundheitsdaten an't Backend: CPU-Temperatuur, Last, Speeker, Fastplaat. Implementeert Watchdog-Logik för automaatsche Container-Neestarts.
Storage-Architektur
Update-Mechanismus
Ünnerstütte Hardware
De Player-Software is Docker-basiert un löppt op jedes Linux-System mit Docker. Optimeert för ARM64 (Raspberry Pi) un AMD64 (x86-Server, Mini-PCs). Ünnerstüttung för kommerzielle SoC-Displays is in Planung.
Raspberry Pi 5
EmpfohlenRaspberry Pi 4
ÜnnerstüttLinux x86 / Mini-PC
ÜnnerstüttCommercial Display SoC
PlantPlayback Engine
Hybride Weergave: mpv för Video un Biller mit Hardware-Beschleunigung via DRM/KMS/VAAPI, Chromium för Web-Inholden in'n Kiosk-Modus. De Agent-Container stüürt de Weergave över een lokale REST-API.
mpv — Video & Biller
Hardware-beschleunigte Dekodeerung över V4L2 M2M (Raspberry Pi) oder VAAPI (x86). Framebuffer-Utgave över DRM/KMS för minimale Latenz, ahn X11 oder Wayland.
Chromium — Web-Inholden
Headless Chromium in'n Kiosk-Modus för HTML-Sieden, Dashboards un interaktive Inholden. Stüürung över Chrome DevTools Protocol (CDP).
| Format | Codec / Decoder | HW-Beschleunigung | Max. Uplö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
Vun't Upload bit to de Weergave: Jede Datei warrt verifizeert, versioneert un atomaar op de Player synchroniseert. De Player speelt jümmer een konsistenten Stand — nienich een halven Download.
Upload & Versioneerung
Verifizeerung & Storage
Plan-Sync & Aktiveerung
Sekerheit
Multi-Tenant Isolatschon, verschlüsselte Kommunikatschon un tokenbasierte Authentifizeerung. Keen Gerät hett Togriep op Daten vun annere Tenants.
Authentifizeerung
Tenant-Isolatschon
Geräte-Sekerheit
Transport-Sekerheit
REST API
De hele Plattform is API-first. Allens, wat dat Dashboard kann, kannst du ook över de REST API automatiseeren. OpenAPI-Dokumentatschon inbegrepen.
# Player afrogen
GET /api/v1/players
GET /api/v1/players/{id}
GET /api/v1/players/{id}/health
# Inholden opstellen
POST /api/v1/media-items
POST /api/v1/playlists
POST /api/v1/channels
# Toordnungen
PUT /api/v1/playlists/{id}/items
PUT /api/v1/channels/{id}/playlists
# Authentifizeerung
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
Automaatsch genereerte, interaktive API-Dokumentatschon. Test Endpunkten direkt in'n Browser.
Cursor-Pagination
Effiziente Siedenblättern för grote Datenmengen. Filter, Sorteerung un Söök op all Listen.
MCP — AI-Integration
media-player.app implementeert dat Model Context Protocol (MCP) as First-Class-Integratschonssurface. Neben de REST API köönt AI-Agents, n8n-Workflows un LangChain-Pipelines de Plattform direkt stüüren.
Wat is MCP?
Dat Model Context Protocol is een open Standard för de Kommunikatschon twüschen AI-Agents un externe Systemen. Ansteed vun een proprietäre API köönt beliebige AI-fähige Clients (Claude, GPT, egen LLMs) de Plattform över Tools, Resources un Prompts stüüren.
MCP Tools
Anwendungsfälle
Sekerheit
Monitoring & Telemetrie
Jedes Display sendt in konfigureerbare Intervallen Gesundheitsdaten an dat Backend. De Heartbeat-Container sammelt System-Metriken un Playout-Events.
| Metrik | Quell | 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 |
Nettwark-Anforderungen
De Player bruken een utgahnde Internetverbindung. Ingahnde Ports mööt nich opmaakt warrn — de Player verbindt sik to't Backend, nich annersom.
Utgahnde Verbindungen
Bandbreite & Offline
Op een Blick
SaaS-Plattform
Player Runtime
Plattformen
Integration
Monitoring
Sekerheit
Övertuugt?
Probeer media-player.app gratis ut oder kiek in de API-Dokumentatschon.
Wi bruken dien E-Mail blots för de Launch-Nachricht. Keen Spam.