Skip to content

Remote Commands

Commands are sent via POST /api/devices/{id}/command with body { "cmd": "<command>", ...params }.

Commands unavailable for a given provider are hidden in the UI and return 501 from the API.

Screen control

CommandParametersDescription
screenOn—Turn the screen on
screenOff—Turn the screen off
forceSleep—Force sleep immediately

URL & web

CommandParametersDescription
loadUrlurl (string)Navigate to a URL
loadStartUrl—Navigate to the configured start URL
refreshTab—Reload the current page
clearCache—Clear the browser cache
clearWebstorage—Clear localStorage and sessionStorage
clearCookies—Clear all cookies
resetWebview—Fully reset the WebView

Screensaver

CommandParametersDescription
startScreensaver—Start screensaver / daydream
stopScreensaver—Stop screensaver

Text-to-speech

CommandParametersDescription
textToSpeechtext, locale (optional)Speak text aloud
stopTextToSpeech—Stop speaking

Volume

CommandParametersDescription
setVolumelevel (0–100)Set media volume

App control

CommandParametersDescription
restartApp—Restart the kiosk app
startApplicationpackageLaunch an app by package name
toForeground—Bring kiosk app to foreground
toBackground—Send kiosk app to background
exitApp—Exit the kiosk app

Kiosk lock

CommandParametersDescription
lockKiosk—Enable kiosk lock mode
unlockKioskpinUnlock kiosk mode

Media playback

CommandParametersDescription
playSoundurlPlay an audio file
stopSound—Stop audio playback
playVideourlPlay a video
stopVideo—Stop video playback

Maintenance

CommandParametersDescription
enableLockedMode—Enable maintenance/locked mode
disableLockedMode—Disable maintenance mode
setOverlayMessagemessageShow an overlay message

JavaScript injection

CommandParametersDescription
injectJavascriptscriptExecute JavaScript in the WebView

Screenshot & camera

CommandParametersDescription
screenshot—Capture a screenshot (returned as image)