Gerätezustand: CLI-Befehle

Das Gerät eines Bildschirms oder die Geräte einer Flotte neu starten.

screen reboot (<id>... | --tag TAG | --folder ID) [--yes] [--expires-in DURATION] [--expect-rev REVISION]

screenrig screen reboot scr_LOBBY
screenrig screen reboot scr_LOBBY --expires-in 2h
screenrig screen reboot --tag Lobby --yes
screenrig screen reboot --folder sfd_01EXAMPLEFOLDER000000000 --yes

Der Player startet das Gerät neu, nicht nur sich selbst. Ein Bildschirm, der online ist, erhält den Neustart sofort (state sent); ein Offline-Bildschirm hält ihn queued und erhält ihn, wenn er vor expires_at online kommt, 24 Stunden nach der Anfrage, sofern --expires-in nichts anderes sagt. Die Antwort enthält reboot_id, state und expires_at. Ein neuerer Neustart ersetzt einen noch wartenden. screen show listet die commands des Bildschirms auf: Ein gesendeter Neustart wird done, sobald das Gerät meldet, dass es gebootet hat, und screen command cancel bricht einen noch wartenden ab. In einer Flotte enthält reboot jedes Ergebnisses dasselbe state. Eine abgelehnte oder fehlgeschlagene Anfrage und eine exakte Wiederholung derselben Anfrage zählen nicht zum Limit pro Bildschirm. Vom Moment des Sendens eines Neustarts, bis das Gerät meldet, dass es gebootet hat, oder zehn Minuten vergehen, öffnet der Bildschirm keinen screen_offline- oder display_disconnected-Alarm; eine Meldung zu einem von beiden, die dann fällig wird, wartet bis zum Ende dieses Zeitraums plus ihrer Wartezeit, und eine crashing-Meldung wird als planned_reboot übersprungen. Eine Bedingung, die danach noch gilt, öffnet normal.

Die Caches des Players eines Bildschirms oder der Player einer Flotte leeren.

screen clear-cache (<id>... | --tag TAG | --folder ID) [--yes] [--expires-in DURATION] [--expect-rev REVISION]

screenrig screen clear-cache scr_LOBBY
screenrig screen clear-cache scr_LOBBY --expires-in 2h
screenrig screen clear-cache --tag Lobby --yes

Der Player löscht seine heruntergeladenen Medien, Anwendungspakete und Daten-Caches, behält Kopplung, Identität und Einstellungen und ruft dann das Manifest und die Inhalte erneut ab; der Bildschirm kann seinen Ladezustand zeigen, während sich die Inhalte wieder füllen. Er erreicht nur einen Player, der clear_cache meldet. Einem Online-Bildschirm wird die Anfrage sofort gesendet (state sent); ein Offline-Bildschirm hält sie als queued und bekommt sie gesendet, wenn er vor expires_at online geht, 24 Stunden nach der Anfrage, sofern --expires-in nichts anderes festlegt. Die Antwort enthält command_id, command, state und expires_at. Ein Player, der die Fähigkeit nicht meldet, antwortet mit 409 command_unsupported, und nichts wird gesendet; in einer Flotte schlägt dieser Bildschirm allein fehl. screen show listet den Befehl unter commands auf und markiert ihn, sobald der Player meldet, als done oder failed mit cause und einem kurzen detail: cleared, wenn die Caches geleert sind und der erneute Abruf begonnen hat, oder clear_failed, wenn ein Cache nicht geleert werden kann. Ein gesendeter Befehl ohne Bericht bleibt sent. Ein neuerer Befehl derselben Art ersetzt einen noch in der Warteschlange stehenden, und screen command cancel bricht einen noch in der Warteschlange stehenden ab. In einer Flotte enthält command jedes Ergebnisses dasselbe state. Eine Flotte (mehrere IDs, --tag oder --folder) braucht --yes. Eine abgelehnte oder fehlgeschlagene Anfrage und eine exakte Wiederholung derselben Anfrage zählen nicht zum Limit von 2 Anfragen für clear-cache, restart-app und update-software zusammen pro Bildschirm pro 10 Minuten.

Die Anwendung des Players eines Bildschirms oder der Player einer Flotte neu starten.

screen restart-app (<id>... | --tag TAG | --folder ID) [--yes] [--expires-in DURATION] [--expect-rev REVISION]

screenrig screen restart-app scr_LOBBY
screenrig screen restart-app scr_LOBBY --expires-in 2h
screenrig screen restart-app --tag Lobby --yes

Der Player startet seine Anwendung neu, nicht das Gerät (ein Web-Player lädt seine Seite neu) und meldet sich aus dem neu gestarteten Prozess. Er erreicht nur einen Player, der restart_app meldet; screen reboot startet das Gerät neu. Einem Online-Bildschirm wird die Anfrage sofort gesendet (state sent); ein Offline-Bildschirm hält sie als queued und bekommt sie gesendet, wenn er vor expires_at online geht, 24 Stunden nach der Anfrage, sofern --expires-in nichts anderes festlegt. Die Antwort enthält command_id, command, state und expires_at. Ein Player, der die Fähigkeit nicht meldet, antwortet mit 409 command_unsupported, und nichts wird gesendet; in einer Flotte schlägt dieser Bildschirm allein fehl. screen show listet den Befehl unter commands auf und markiert ihn, sobald der Player meldet, als done oder failed mit cause und einem kurzen detail: restarted oder restart_failed, wenn der Neustart nicht beginnen kann. Ein gesendeter Befehl ohne Bericht bleibt sent. Ein neuerer Befehl derselben Art ersetzt einen noch in der Warteschlange stehenden, und screen command cancel bricht einen noch in der Warteschlange stehenden ab. In einer Flotte enthält command jedes Ergebnisses dasselbe state. Eine Flotte (mehrere IDs, --tag oder --folder) braucht --yes. Eine abgelehnte oder fehlgeschlagene Anfrage und eine exakte Wiederholung derselben Anfrage zählen nicht zum Limit von 2 Anfragen für clear-cache, restart-app und update-software zusammen pro Bildschirm pro 10 Minuten.

Den Player eines Bildschirms oder die Player einer Flotte auf die neueste Version aktualisieren.

screen update-software (<id>... | --tag TAG | --folder ID) [--yes] [--expires-in DURATION] [--expect-rev REVISION]

screenrig screen update-software scr_LOBBY
screenrig screen update-software scr_LOBBY --expires-in 2h
screenrig screen update-software --tag Lobby --yes

Der Player prüft jetzt auf die neueste Player-Version und installiert sie, wo seine Plattform dem Player erlaubt, sich selbst zu aktualisieren; ein Web-Player aktualisiert seinen Service Worker und lädt dann neu. Er erreicht nur einen Player, der update meldet: Ein aus einem Store installierter oder von einer Geräteverwaltung verwalteter Player aktualisiert sich über diesen Kanal. Einem Online-Bildschirm wird die Anfrage sofort gesendet (state sent); ein Offline-Bildschirm hält sie als queued und bekommt sie gesendet, wenn er vor expires_at online geht, 24 Stunden nach der Anfrage, sofern --expires-in nichts anderes festlegt. Die Antwort enthält command_id, command, state und expires_at. Ein Player, der die Fähigkeit nicht meldet, antwortet mit 409 command_unsupported, und nichts wird gesendet; in einer Flotte schlägt dieser Bildschirm allein fehl. screen show listet den Befehl unter commands auf und markiert ihn, sobald der Player meldet, als done oder failed mit cause und einem kurzen detail: up_to_date, wenn die neueste Version bereits läuft, updated, sobald die neue Version gestartet ist, oder, bei einem Fehler, update_check_failed, download_failed, install_failed oder no_update_channel. Ein gesendeter Befehl ohne Bericht bleibt sent. Ein neuerer Befehl derselben Art ersetzt einen noch in der Warteschlange stehenden, und screen command cancel bricht einen noch in der Warteschlange stehenden ab. In einer Flotte enthält command jedes Ergebnisses dasselbe state. Eine Flotte (mehrere IDs, --tag oder --folder) braucht --yes. Eine abgelehnte oder fehlgeschlagene Anfrage und eine exakte Wiederholung derselben Anfrage zählen nicht zum Limit von 2 Anfragen für clear-cache, restart-app und update-software zusammen pro Bildschirm pro 10 Minuten.

Einen Befehl abbrechen, der für einen Offline-Bildschirm noch in der Warteschlange steht.

screen command cancel <id> <command_id> [--expect-rev REVISION]

screenrig screen command cancel scr_01EXAMPLESCREEN00000000 rbt_01EXAMPLEREBOOT00000000

Er bricht ein reboot, reload, clear_cache, restart_app oder update ab, das auf einen Offline-Bildschirm wartet, sodass es nie gesendet wird. Nur ein Befehl in der Warteschlange lässt sich abbrechen. Ein bereits gesendeter Befehl (sent oder done) antwortet mit 409 resource_conflict und der Meldung "The command was already sent.", ein Befehl, der nicht mehr in der Warteschlange steht (expired, cancelled oder superseded), antwortet mit 409 resource_conflict und der Meldung "The command is no longer queued.", und eine ID, die der Bildschirm nicht auflistet, antwortet mit 404 not_found. Die Antwort ist der Bildschirm mit dem Befehl im Zustand cancelled, und die Bildschirmrevision ändert sich nicht.

Schalten Sie jetzt die Anzeige eines Bildschirms oder einer Flotte von Anzeigen ein oder aus oder heben Sie diese Überschreibung auf.

screen display [set] (<id>... | --tag TAG | --folder ID) --power on|off [--until TIME | --for DURATION] [--expect-rev REVISION]
screen display clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION]

screenrig screen display scr_LOBBY --power off --for 2h
screenrig screen display --tag Lobby --power on
screenrig screen display scr_A scr_B --power off --for 8h
screenrig screen display clear --tag Lobby

screen display ID ist die Kurzform von screen display set ID; clear nimmt weder --power noch --until oder --for an. screen display ist eine manuelle Überschreibung des Anzeigeplans. Ohne --until oder --for endet sie an der nächsten Grenze des Plans; eine spätere Änderung des Anzeigeplans oder der Zeitzone verschiebt dieses Ende zur neuen Grenze. Ohne Grenze in den nächsten acht Tagen, zum Beispiel ohne aktivierten Plan, bleibt sie bis screen display clear oder einem Ersatz bestehen. screen display clear beendet die Überschreibung, sodass der Anzeigeplan wieder gilt; ohne eine solche ist die Anzeige an.

Das Speichern einer Überschreibung wartet nicht auf den Player. display.override_status vergleicht einen neueren Display-Bericht damit: matches, mismatch, pending, stale oder unknown; matches beschreibt den Bericht, nicht die Ausführung des Befehls. Die Warnung display_power_mismatch nennt einen aktuellen, abweichenden Bericht und display_power_unconfirmed besagt, dass ein neuerer verwertbarer Bericht nötig ist; prüfen Sie daher screen show, bevor Sie einen Screenshot aufnehmen. display_scrim_only bedeutet, dass der Player nur eine schwarze Überlagerung steuert: on entfernt sie und sendet keinen Hardware-Aufweckbefehl. Ein Bildschirm in einem geschützten Ordner lehnt eine Display-Änderung ab (protected_target).

Anzeigen, einstellen oder löschen, wann das Display eines Bildschirms eingeschaltet ist.

screen display-schedule show <id>
screen display-schedule set (<id>... | --tag TAG | --folder ID) --file FILE [--expect-rev REVISION]
screen display-schedule clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION]

screenrig screen display-schedule set scr_LOBBY --file hours.json
screenrig screen display-schedule set --tag Cafe --file hours.json

Ein Display-Zeitplan ist {enabled, windows}, beides Pflicht, und windows listet 1 bis 16 Zeitfenster auf, in denen das Display eingeschaltet ist, in der Zeitzone des Bildschirms; außerhalb jedes Fensters wechselt das Display in den Standby. Der Player wertet ihn auf dem Gerät aus, sodass er offline weiter funktioniert. Ein Fenster, dessen end am oder vor seinem start liegt, überschreitet Mitternacht, und ein Fenster ohne start und end deckt den ganzen Tag ab. enabled: false behält die Fenster und lässt das Display an. display-schedule show antwortet mit display_schedule (null, wenn keiner vorhanden ist) und dem display-Status des Bildschirms. Die gespeicherte Ausgabe lässt sich bearbeiten und mit set --file zurücksenden. Ein Bildschirm in einem geschützten Ordner lehnt eine Änderung seines Display-Zeitplans ab (protected_target).

{"enabled": true, "windows": [{"days": ["mon", "tue", "wed", "thu", "fri"], "start": "07:00", "end": "19:00"}, {"days": ["sat"]}]}

screen show --human druckt Display: mit der angeforderten Leistung, deren Quelle (manuelle Übersteuerung, Display-Zeitplan oder Standard) und bis wann in der Bildschirm-Zeitzone, die Zeitplanfenster und die vom Player gemeldete Leistung, nach 35 Minuten ohne Bericht als veraltet markiert.

Die Lautstärke eines Bildschirms einstellen oder ihn stummschalten, bei einem Bildschirm oder einer Flotte.

screen volume (<id>... | --tag TAG) [--level 0-100] [--mute | --unmute] [--expect-rev REVISION]

screenrig screen volume scr_LOBBY --level 40
screenrig screen volume scr_LOBBY --mute
screenrig screen volume scr_LOBBY --unmute
screenrig screen volume --tag Lobby --level 25 --unmute

Ein Bildschirm hat eine Lautstärke: einen Pegel von 0 bis 100 und eine Stummschaltung. Die Stummschaltung behält den Pegel, daher stellt das Aufheben der Stummschaltung ihn wieder her. Ein Bildschirm, der online ist, wendet die Änderung sofort an; ein Offline-Bildschirm wendet die neueste Anfrage an, sobald er wieder online ist, und eine neuere Anfrage ersetzt eine frühere. Eine später im eigenen Einstellungsmenü des Players vorgenommene Änderung hat bis zum nächsten screen volume Vorrang, und eine Änderung des Pegels dort hebt die Stummschaltung auf. screen show meldet volume mit der neuesten requested-Änderung und, als reported, level und muted, die der Player erreicht hat, sowie hardware: true, wenn der Pegel den Geräte- oder Panel-Ausgang erreicht, false, wenn es die eigene Verstärkung des Players ist; stale wird nach 35 Minuten ohne Meldung true. Nur ein Player, der die Fähigkeit volume deklariert, wendet sie an: Jeder andere Bildschirm antwortet mit 409 volume_unsupported (Exit-Code 5), und nichts wird aufgezeichnet. Ein archivierter Bildschirm antwortet mit screen_archived, und ein Bildschirm, der noch auf die Kopplung wartet, antwortet mit resource_conflict. Ein Bildschirm in einem geschützten Ordner lehnt die Änderung ab (protected_target), und in einer Flotte lehnt ein einziger geschützter Bildschirm die ganze Anfrage ab. Die Bildschirmseite im Dashboard bietet dieselbe Lautstärke-Steuerung.

Einen Bildschirm nach einiger Zeit ohne Nutzung abdunkeln oder diese Funktion ausschalten.

screen display-idle <id> --after SECONDS --wake WAKE [--expect-rev REVISION]
screen display-idle <id> --off [--expect-rev REVISION]

screenrig screen display-idle scr_LOBBY --after 300 --wake touch
screenrig screen display-idle scr_LOBBY --after 600 --wake touch,presence --expect-rev 4
screenrig screen display-idle scr_LOBBY --off

Der Bildschirm wird nach --after Sekunden ohne Berührung oder Tastendruck oder, wenn --wake presence aufführt, ohne dass jemand vor dem Bildschirm steht, dunkel. Solange er dunkel ist, hält der Player die Wiedergabe an, ohne Wiedergaben und ohne Werbung, und meldet die Display-Stromversorgung als aus; ein Aufweckereignis schaltet den Bildschirm sofort wieder ein und die Wiedergabe wird fortgesetzt, und die Berührung, die einen dunklen Bildschirm aufweckt, wird nicht an die Seite weitergegeben. Ein Anzeigeplan oder eine Überschreibung, die das Panel ausgeschaltet hält, hat Vorrang, ebenso eine Anwendung, die device.display hält, solange ihre Seite auf dem Bildschirm ist. Nur display.idle ändert sich. Ein Player wendet es an, wenn screen show display_power.idle in seinen Host-Fähigkeiten aufführt; die Einstellung wird in jedem Fall gespeichert, und screen show führt sie als Display idle auf. Propose-Zugriff kann sie nicht ändern (insufficient_access), und ein Bildschirm in einem geschützten Ordner lehnt sie ab (protected_target).

Festlegen, ob die Helligkeit eines Bildschirms dem Lichtsensor des Geräts folgt.

screen brightness <id> --mode auto|fixed [--expect-rev REVISION]

screenrig screen brightness scr_LOBBY --mode auto
screenrig screen brightness scr_LOBBY --mode fixed --expect-rev 4

Nur display.brightness ändert sich. Ein Player wendet auto an, wenn screen show brightness.auto in seinen Host-Fähigkeiten aufführt, was ein Gerät nur mit einem Lichtsensor deklariert; eine Anwendung, die die Helligkeit des Displays setzt, hat Vorrang, solange ihre Seite angezeigt wird. Die Einstellung wird in jedem Fall gespeichert, und screen show führt sie als Display brightness auf. Es gelten die Zugriffsregeln von screen display-idle.

Den Videomodus festlegen, den der Player eines Bildschirms an seinem Ausgang einstellt, oder ihn löschen.

screen display-output <id> (--mode MODE | --clear) [--expect-rev REVISION]

screenrig screen display-output scr_LOBBY --mode 3840x2160x60p
screenrig screen display-output scr_LOBBY --mode auto --expect-rev 4
screenrig screen display-output scr_LOBBY --clear

screen show listet die Modi auf, die der Player jetzt einstellen kann, unter Output modes the Player can set, sowie den geltenden Modus. Sobald der Player sie gemeldet hat, ist ein Modus außerhalb dieser Liste invalid_request; wählen Sie daher einen aufgeführten. Nur display.output ändert sich. Ein Player wendet ihn an, wenn screen show display_output.mode in seinen Host-Fähigkeiten auflistet, was ein BrightSign-Player deklariert; jeder andere Modus als auto auf einem anderen Player wird mit display_output_unsupported beantwortet, und das Löschen funktioniert immer. Der Player wendet einen Modus einmal an, startet dafür gegebenenfalls neu und meldet den erreichten Modus. Es gelten die Zugriffsregeln von screen display-idle.

Den Player eines Bildschirms den HDMI-Eingang des Fernsehers über CEC übernehmen lassen oder damit aufhören.

screen display-cec <id> (--on | --off | --clear) [--expect-rev REVISION]

screenrig screen display-cec scr_LOBBY --on
screenrig screen display-cec scr_LOBBY --off --expect-rev 4
screenrig screen display-cec scr_LOBBY --clear

Nur display.cec ändert sich. Ein Player wendet es an, wenn screen show display_power.cec_active_source in seinen Host-Fähigkeiten auflistet, was ein BrightSign-Player deklariert; --on auf einem anderen Player wird mit display_cec_unsupported beantwortet, während --off und --clear immer funktionieren. Der Player sendet nichts, solange ein Anzeigeplan oder eine Überschreibung das Display ausgeschaltet hält, und ein CEC-Fehler beeinträchtigt die Wiedergabe nie. screen show listet die Einstellung als Display CEC auf. Es gelten die Zugriffsregeln von screen display-idle.

Den Player eines Bildschirms auf dem Bildschirm fixieren oder die Fixierung aufheben.

screen kiosk-lock <id> (--on | --off) [--expect-rev REVISION]

screenrig screen kiosk-lock scr_LOBBY --on
screenrig screen kiosk-lock scr_LOBBY --off --expect-rev 4

--on nutzt die Android-Bildschirmfixierung: Die Person am Bildschirm bestätigt sie beim ersten Mal, und Statusleiste, Home und Übersicht sind blockiert, solange der Player fixiert ist. Das Operator-Einstellungsfeld kann die Sperre verlassen, bis das nächste Manifest oder ein Neustart sie wieder anwendet. Ein Player wendet sie an, wenn screen show kiosk_lock in seinen Host-Fähigkeiten aufführt; die Einstellung wird in jedem Fall gespeichert, und screen show führt Kiosk lock auf, solange sie aktiv ist. Mit Propose-Zugriff lässt sie sich nicht ändern (insufficient_access).

Zeigt an, setzt oder löscht, wann das Backend das Gerät eines Bildschirms neu startet.

screen reboot-schedule show <id>
screen reboot-schedule set (<id>... | --tag TAG | --folder ID) (--window SPEC... | --file FILE) [--disabled] [--expect-rev REVISION]
screen reboot-schedule clear (<id>... | --tag TAG | --folder ID) [--expect-rev REVISION]

screenrig screen reboot-schedule set scr_LOBBY --window "Mon-Sun 04:00-04:30"
screenrig screen reboot-schedule set --tag Cafe --window "Mon-Fri 04:00-04:30" --window "Sat,Sun 05:00-06:00"
screenrig screen reboot-schedule set scr_LOBBY --file reboots.json --expect-rev 4
screenrig screen reboot-schedule set --folder sfd_01EXAMPLEFOLDER000000000 --window "Mon-Sun 04:00-04:30"

Zu Beginn jedes Fensters löst screenRIG in der Zeitzone des Bildschirms denselben Neustart aus wie screen reboot, sodass "Mon-Sun 04:00-04:30" den Bildschirm jeden Tag um 04:00 Uhr Ortszeit neu startet. commands in screen show listet ihn mit source schedule auf, und screen show und reboot-schedule show geben next_reboot_at aus. Ein Fenster, dessen Ende auf oder vor seinem Beginn liegt, überschreitet Mitternacht, und ein Fenster ohne Zeiten deckt den ganzen Tag ab. Die gespeicherte Ausgabe von reboot-schedule show kann bearbeitet und mit set --file zurückgesendet werden:

{"enabled": true, "windows": [{"days": ["mon", "tue", "wed", "thu", "fri", "sat", "sun"], "start": "04:00", "end": "04:30"}]}

Ein Online-Bildschirm erhält den Neustart sofort. Ein Offline-Bildschirm behält ihn nur in der Warteschlange, bis sein Fenster endet, sodass ein Neustart nie außerhalb des Fensters landet: Ein Bildschirm, der danach zurückkehrt, erhält keinen. Ein Start innerhalb einer Lücke bei der Umstellung auf Sommerzeit löst zur ersten gültigen Minute des Fensters aus, und eine Wiederholung bei der Umstellung auf Winterzeit löst einmal pro Fenster und lokalem Datum aus. Ein geplanter Neustart ersetzt nie einen von einer Person angeforderten, der noch auf den Bildschirm wartet; der Termin wird mit screen.reboot_skipped (reboot_pending) übersprungen. Der Bildschirm braucht einen Player, der reboot deklariert; ein Bildschirm, der reboot später verliert, überspringt jedes Fenster und behält seinen Plan. Eine Änderung der Zeitzone bricht die noch wartenden geplanten Neustarts ab und verschiebt next_reboot_at in die neue Zone. Ein von einem Plan gesendeter Neustart löst keinen Offline-Alarm aus, wie unter screen reboot. screen.reboot_schedule_changed erfasst jedes Setzen oder Löschen. Eine Datei ist {enabled, windows}, beides Pflicht. Neustartpläne sind in jedem Plan enthalten. In einer Flotte ist jedes Ergebnis das des jeweiligen Bildschirms: reboot_unsupported für einen Bildschirm, dessen Player nicht neu starten kann.

Lesen Sie die tägliche Verfügbarkeit eines Bildschirms über UTC-Tage.

screen uptime <id> [--day-from YYYY-MM-DD] [--day-to YYYY-MM-DD] [--format json|csv|xlsx|pdf] [--output FILE]

screenrig screen uptime scr_01EXAMPLESCREEN00000000
screenrig screen uptime scr_01EXAMPLESCREEN00000000 --day-from 2026-09-01 --day-to 2026-09-30
screenrig screen uptime scr_01EXAMPLESCREEN00000000 --format xlsx --output uptime.xlsx

data.items listet eine Zeile pro UTC-Tag mit aufgezeichnetem Zustand, älteste zuerst: online_s, offline_s, availability (online über die aufgezeichnete Zeit; null wenn nichts aufgezeichnet wurde), coverage (Anteil des Tages mit aufgezeichnetem Zustand), intervals und live für einen Tag, der das offene Intervall bis jetzt einschließt. Zeit ohne aufgezeichneten Zustand senkt coverage und ist niemals Ausfallzeit. Tage ohne Aufzeichnung haben keine Zeile.

Online- und Offline-Übergänge eines Bildschirms auflisten, neueste zuerst.

screen presence <id> [--since TIME] [--until TIME]

screenrig screen presence scr_01EXAMPLESCREEN00000000 --since 7d
screenrig screen presence scr_01EXAMPLESCREEN00000000 --since 2026-09-01T00:00:00Z --until 2026-09-08T00:00:00Z

data.items trägt at, state und detected_on_reconnect auf einem Offline, den der Server erst bemerkte, als der Bildschirm wieder verbunden wurde (at ist dann, wenn sein Präsenz-Lease endete). Die CLI folgt next_cursor bis zum Ende und antwortet auf jeden Übergang mit next_cursor null, also schränken Sie einen langen Bereich mit --since ein.

Gesundheitsberichte eines Bildschirms über die Zeit auflisten, jeder Bericht oder eine Zusammenfassung pro Stunde.

screen health-history <id> [--from TIME] [--to TIME] [--resolution raw|hour] [--format json|csv|xlsx|pdf] [--output FILE]

screenrig screen health-history scr_01EXAMPLESCREEN00000000 --from 6h
screenrig screen health-history scr_01EXAMPLESCREEN00000000 --from 30d --resolution hour
screenrig screen health-history scr_01EXAMPLESCREEN00000000 --from 30d --resolution hour --format csv --output health.csv

raw antwortet mit data.samples, jeder akzeptierte Bericht ist geformt wie das health von screen show ohne stale. hour antwortet mit data.hours, eine Zusammenfassung pro UTC-Stunde: Berichte, Spitzen- und Durchschnittstemperatur, Spitzenlast und Speicherverhältnis, schwächstes Wi-Fi-Signal, display_disconnected, und Spitzenanzahl von Abstürzen und Renderer-Neustarts. Die CLI folgt next_cursor bis zum Ende, also schränken Sie einen langen Rohbereich ein oder verwenden Sie --resolution hour. Rohberichte kommen innerhalb von Sekunden und stündliche Zusammenfassungen innerhalb von etwa 5 Minuten an.

Prüft, ob eine Playlist in den Speicher passt, den der Player eines Bildschirms zuletzt gemeldet hat, bevor die Playlist zugewiesen wird.

screen storage-forecast <id> --playlist-id ID [--playlist-rev REVISION]

screenrig screen storage-forecast scr_01EXAMPLESCREEN00000000 --playlist-id pl_01EXAMPLEPLAYLIST000000
screenrig screen storage-forecast scr_01EXAMPLESCREEN00000000 --playlist-id pl_01EXAMPLEPLAYLIST000000 --playlist-rev 7

Er schreibt nichts: keine Zuweisung, keine Bildschirmrevision, kein Ereignis. Lesezugriff genügt, und ein Bildschirm nimmt höchstens 30 Prüfungen pro Minute an. data.fit ist fits, partial (einige Seiten bleiben außen vor), none_fit (nichts wird geladen) oder unknown (der Bildschirm hat nie Speicher gemeldet, oder der Inhalt der Playlist ist nicht bereit). data.excluded_page_count zählt die ausgelassenen Seiten, data.required_bytes ist der Bedarf der gesamten Playlist, data.capacity_bytes das, was der Player als nutzbar gemeldet hat, data.basis ist reported_capacity und data.received_at ist der Zeitpunkt der Meldung des Players. Bei fit unknown sind die Byte-Werte und received_at null. Ein Bericht, der älter als 24 Stunden ist, wird als veraltet markiert, aber weiterhin verwendet. Wenn die Playlist nicht passt, enthält die Antwort eine Warnung storage_full: Geben Sie Speicher auf dem Gerät frei, auf dem der Player läuft, und prüfen Sie erneut. Cache und Speicher erklärt den Plan. Eine gespeicherte Zuweisung bestätigt die Wiedergabe nicht.