So rollen Sie Headless Digital Signage aus, das Ihr Agent betreibt

In einem Headless-Setup ist die Steuerungsebene eine API, keine Webseite. Ihr Agent, ein Skript oder ein CI-Job führt dieselben Aufrufe aus, die eine Person im Dashboard ausführen würde, über die CLI, die REST-API oder den Remote-MCP-Server. Der Player auf jedem Bildschirm lädt herunter, was er abspielen soll, spielt es aus dem lokalen Speicher ab und meldet zurück: was er zeigt, wie es ihm geht und welche Steuerungen das Gerät unterstützt. Das Dashboard gibt es weiterhin für alle, die es nutzen möchten; nichts hängt davon ab, dass es geöffnet ist. Headless Digital Signage erklärt das Modell, und die API-Seite behandelt jede Schnittstelle.

Fügen Sie einem KI-Agenten einen Satz ein, und er installiert das offizielle screenRIG-Plugin, in dem Skill und screenrig-CLI gebündelt sind. Beim ersten Start registriert er sich: Er legt Ihre Organisation und Ihr Projekt an und schickt Ihnen eine Einladung per E-Mail. Schnellstart enthält den Satz und die Installationsbefehle für jeden Agenten.

Stattdessen kann sich ein MCP-Client wie Claude, ChatGPT oder Grok mit dem Remote-MCP-Server verbinden: Eine Person genehmigt ihn im Dashboard und wählt für ihn Nur lesen, Vorschlagen oder Verwalten. Nur lesen genügt für einen Agenten, der nur zuschaut, wie in der Sitzung oben. Das Plugin ergänzt die Schritte, die auf Ihrem Rechner laufen, etwa das Konvertieren von Medien und das Packen von Apps. Einen MCP-Client verbinden nennt die Serveradresse und die Anmeldung.

Für ein Skript, einen CI-Job oder Ihren eigenen Dienst erstellen Sie einen Service-Client mit nur dem Zugriff, den er braucht:

screenrig service-client create --name "rollout-pipeline" --access manage

Ein Client mit Nur lesen eignet sich für eine Überwachungsaufgabe, und die Änderungen eines Clients mit Vorschlagen warten auf die Prüfung durch eine Person. Service-Clients behandelt die Anmeldung mit einem Schlüssel oder einem Geheimnis.

Wählen Sie Geräte, die von selbst starten und die Sie aus der Ferne wiederherstellen können. Ein Raspberry Pi oder Linux-PC mit Kiosk-Installation, ein BrightSign-Player, ein Windows-PC oder ein verwaltetes Android-Gerät können alle auf Befehl neu starten; Sticks und TV-Apps sind günstiger, können es aber nicht. So wählen Sie einen Digital-Signage-Player vergleicht sie, und Downloads listet jedes Gerät auf.

Für einen Bildschirm genügt ein Kopplungscode. Bei zehn ist ein Flottenlink eine einzige Player-URL, die jedes Gerät, das sie öffnet, zu einem eigenen Bildschirm in Ihrem Projekt macht, mit den Tags, Feldern und der Playlist des Links und ohne Code zum Vorlesen.

screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z

Die Antwort enthält die URL. Sie ist ein Zugangsdatum, das Bildschirme erstellt, geben Sie sie also nur an die Geräteeinrichtung weiter, nie an eine Seite oder einen Chat. Legen Sie sie dann dort ab, wo das Gerät sie findet:

• Raspberry Pi und Linux. Führen Sie das Installationsprogramm als Kiosk mit dem Link aus: curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL. Danach bootet das Gerät direkt in den Player, tritt dem Projekt bei und ist nach einem Stromausfall von selbst wieder da.
• Android, Google TV und Amazon Signage Stick. Legen Sie in Ihrer Geräteverwaltung den Schlüssel fleet_link in der verwalteten Konfiguration der App fest (Paket ai.screenrig.player).
• Ein auf Werkseinstellungen zurückgesetztes Android-Gerät mit Android 10 oder neuer und Kamera. Scannen Sie auf dem Willkommensbildschirm den QR-Code des Links für den Android-Geräteeigentümer. Der verwaltete Player installiert sich selbst als Home-App des Geräts im Vollbild, ohne Geräteverwaltung.
• Mac, Apple TV, iPhone und iPad. Legen Sie fleet_link in der verwalteten App-Konfiguration Ihres MDM fest.
• ChromeOS. Tragen Sie den Link in der Google Admin Console als URL der Kiosk-App ein.

--max-screens und --expires-at verhindern, dass ein durchgesickerter Link endlos Bildschirme erstellt; die bereits erstellten Bildschirme spielen weiter. Ein Gerät, das per Powerwash zurückgesetzt oder neu installiert wurde, kehrt als derselbe Bildschirm zurück, sobald seine alte Identität zehn Minuten lang still war. Die Player-Anleitung enthält die Einstellung jeder Geräteverwaltung.

Zeitpläne laufen in der eigenen Zeitzone jedes Bildschirms; legen Sie sie also fest und sagen Sie den Bildschirmen dann, wann sie eingeschaltet sein sollen:

screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.json

Der Display-Zeitplan läuft auf dem Player, sodass das Display zum Ladenschluss auch dann dunkel wird, wenn das Internet des Geschäfts ausfällt. Player, die das unterstützen, schalten den Fernseher selbst per HDMI-CEC, DDC/CI oder über die Hintergrundbeleuchtung; die übrigen verdunkeln das Bild. Siehe HDMI-CEC für Digital Signage. In jedem Plan startet ein Neustart-Zeitplan Geräte in einem ruhigen Zeitfenster neu, etwa "Mon-Sun 04:00-04:30".

Ein Agent veröffentlicht aus einem Satz heraus. Aus Code erstellt screen publish eine Playlist aus einer vorbereiteten Datei, weist sie zu und wartet, bis der Player meldet, dass er sie zeigt:

screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/

Eine Zuweisung ist kein Nachweis der Wiedergabe, daher wartet die Veröffentlichung auf den Player, und ein Screenshot zeigt, was auf dem Bildschirm steht. Flottenänderungen laufen nach Tag oder Ordner, und eine Flottenaktion ist eine Anfrage, egal wie viele Bildschirme sie erreicht. Ein Schreibvorgang kann eine Revisionsprüfung tragen (--expect-rev), sodass zwei Schreibende einander nicht unbemerkt überschreiben.

Jedes Projekt beginnt mit einer E-Mail an seinen Eigentümer, wenn ein Bildschirm 10 Minuten lang offline war. Ergänzen Sie die Bedingungen, die Ihnen wichtig sind:

screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano

Benachrichtigungen achten außerdem auf ein überhitztes Gerät, vollen Speicher, ein festhängendes Inhaltsupdate, einen Player, der immer wieder abstürzt, und eine Playlist, die nicht mehr weiterläuft. E-Mail und signierte Webhooks sind in jedem Plan enthalten; die Weiterleitung an Slack, Teams, PagerDuty oder Telegram gibt es mit Plus. Für einen Agenten, der selbstständig reagiert, streamt screenrig events follow die Ereignisse des Projekts, und Bildschirmereignisse sind im Listen-Stream kostenlos.

Jeder Player meldet seinen Zustand alle fünfzehn Minuten und sofort, wenn sich seine Display-Verbindung oder Stromversorgung ändert: Betriebszeit, Arbeitsspeicher, Temperatur (sofern das Gerät sie hat), Netzwerk und Abstürze. screen show liefert ihn zusammen mit den Host-Fähigkeiten des Bildschirms, sodass der Agent weiß, was ein Bildschirm kann, bevor er es versucht.

Wenn ein Bildschirm ausfällt, arbeitet sich der Agent von der günstigsten Maßnahme aufwärts vor und nutzt nur, was dieser Player deklariert:

1. Nachsehen. screen show meldet den letzten Ausfall des Bildschirms und, sobald ein Zustandsbericht darüber Aufschluss gibt, eine wahrscheinliche Ursache: ein Neustart des Geräts, ein App-Absturz, das Netzwerk oder screenRIG. Ein Screenshot zeigt, was auf dem Display zu sehen ist.
2. Neu laden. screen reload aktualisiert die Inhalte, ohne das Gerät anzutasten.
3. App neu starten oder Cache leeren. screen restart-app startet den Player neu; screen clear-cache verwirft heruntergeladene Inhalte, behält die Kopplung und lädt die Inhalte erneut herunter.
4. Neustart. screen reboot startet bei Playern, die das unterstützen, das Gerät neu. An einen Offline-Bildschirm gesendet, wartet er bis zu 24 Stunden in der Warteschlange und läuft, sobald der Bildschirm wieder da ist. Ein von Ihnen angeforderter Neustart löst keinen Offline-Alarm aus, solange das Gerät neu startet.
5. Hardware tauschen. Wenn ein Gerät ausfällt, koppeln Sie das Ersatzgerät und führen screen replace aus: Das neue Gerät übernimmt Namen, Tags, Zeitzone, Playlist, Zeitpläne und Verlauf des alten Bildschirms.

Die CLI-Referenz listet jeden Gerätebefehl und die Player auf, die ihn unterstützen.

• Agent verbunden oder ein Service-Client mit nur dem Zugriff, den er braucht
• Für den Fernneustart gewählte Player, wo ein Einsatz vor Ort teuer ist
• Ein Flottenlink pro Filiale oder Gruppe, mit Tags, einer Playlist, einer Bildschirmobergrenze und einem Ablaufdatum
• Zeitzone jedes Bildschirms festgelegt
• Display-Zeitplan für Bildschirme, die außerhalb der Betriebszeiten dunkel sein sollen
• Erste Veröffentlichung mit einem Screenshot von jedem Bildschirm überprüft
• Benachrichtigungen bei Offline, getrenntem Display, fehlender Wiedergabe und leerem oder eingefrorenem Bild
• Eine namentlich benannte Person, die die Alarme erhält

Brauche ich das Dashboard überhaupt?

Nein. Alles in dieser Anleitung funktioniert über den Agenten, die CLI oder die API. Das Dashboard ist ein weiterer Client, nützlich, wenn eine Person nachsehen möchte.

Kann ich den Rollout durchführen, ohne Kopplungscodes vorzulesen?

Ja. Ein Flottenlink registriert jedes Gerät, das ihn öffnet, über eine Geräteverwaltung, ein Flag des Linux-Installers oder einen Android-QR-Code.

Was passiert, wenn in einem Geschäft das Internet ausfällt?

Native Player spielen weiter, was sie heruntergeladen haben, und Display-Zeitpläne laufen weiter auf dem Gerät. Sie erhalten eine Offline-Meldung, sobald der Bildschirm so lange offline war, wie Sie es als Wartezeit festgelegt haben.

Was kostet ein Rollout?

screenRIG ist kostenlos, mit unbegrenzt vielen Bildschirmen in Standard. Was die bezahlten Pläne ergänzen, steht unter Preise.

• screenrig.ai/docs/start
• screenrig.ai/docs/players
• screenrig.ai/docs/cli
• screenrig.ai/docs/service-clients