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
screenOnTurn the screen on
screenOffTurn the screen off
forceSleepForce sleep immediately

URL & web

CommandParametersDescription
loadUrlurl (string)Navigate to a URL
loadStartUrlNavigate to the configured start URL
refreshTabReload the current page
clearCacheClear the browser cache
clearWebstorageClear localStorage and sessionStorage
clearCookiesClear all cookies
resetWebviewFully reset the WebView

Screensaver

CommandParametersDescription
startScreensaverStart screensaver / daydream
stopScreensaverStop screensaver

Text-to-speech

CommandParametersDescription
textToSpeechtext, locale (optional)Speak text aloud
stopTextToSpeechStop speaking

Volume

CommandParametersDescription
setVolumelevel (0–100)Set media volume

App control

CommandParametersDescription
restartAppRestart the kiosk app
startApplicationpackageLaunch an app by package name
toForegroundBring kiosk app to foreground
toBackgroundSend kiosk app to background
exitAppExit the kiosk app

Kiosk lock

CommandParametersDescription
lockKioskEnable kiosk lock mode
unlockKioskpinUnlock kiosk mode

Media playback

CommandParametersDescription
playSoundurlPlay an audio file
stopSoundStop audio playback
playVideourlPlay a video
stopVideoStop video playback

Maintenance

CommandParametersDescription
enableLockedModeEnable maintenance/locked mode
disableLockedModeDisable maintenance mode
setOverlayMessagemessageShow an overlay message

JavaScript injection

CommandParametersDescription
injectJavascriptscriptExecute JavaScript in the WebView

Screenshot & camera

CommandParametersDescription
screenshotCapture a screenshot (returned as image)