[External integration] Fully Kiosk Browser

Development
1

Hi everyone :waving_hand:

I just released v1.0.0 of my external integration for Fully Kiosk Browser, the app that turns an Android tablet into a kiosk screen (wall dashboard, reception kiosk, etc.). It allows you to discover your tablets and control them directly from Gladys, without a cloud account.

GitHub Repo: GitHub - vincentBesseau/gladys-fullykiosk: External Gladys Assistant integration to discover Fully Kiosk Browser tablets via MQTT and control them through their local HTTP REST API. · GitHub

What it does

Two ways to discover your tablets, depending on your Fully Kiosk edition:

  • Via MQTT (Fully Kiosk PLUS license required): passive, the integration reads the JSON deviceInfo reports that Fully Kiosk already publishes on its own. It can either launch and manage its own Mosquitto broker (nothing to install, credentials automatically generated), or connect to an MQTT broker you already have.
  • Add by IP (free edition): an action directly queries the tablet’s REST API to add it and save its password in a single step - no broker required. If you only use this mode, a « Disable MQTT Â» setting avoids running a broker for nothing.

In both cases, control is then done via the tablet’s local REST API (http://<ip>:2323/?cmd=...), protected by the remote administration password defined in Fully Kiosk.

Features per tablet

Feature Effect
Screen Turns the tablet screen on/off
Kiosk Lock Enables/disables Fully Kiosk’s kiosk mode (lockdown)
Screensaver Starts/stops the screensaver
Current Page (Read) The URL/app currently in the foreground
Load a URL Immediately loads the written URL
Text-to-Speech Makes the tablet say a text
Restart App Restarts the Fully Kiosk application
Reload Start URL Reloads the configured startup URL
Restart Device Full reboot (requires Device Owner/root Android)
Clear Cache Clears the browser cache
Quit App Exits the Fully Kiosk application
Battery / Charging (Read) When the tablet reports them

And several configuration actions:

  • Add a tablet by IP — IP + REST API password, no need for MQTT.
  • Set a tablet’s REST API password — for a tablet already discovered via MQTT: dropdown of added tablets, no need to type an IP.
  • Display dedicated broker credentials — address, username, password, and MQTT topic to enter in Fully Kiosk (dedicated broker mode).
  • Refresh the list of tablets — forces a new publication of known tablets on the MQTT side.

Installation

In Gladys, add the integration by pointing to this repo: GitHub - vincentBesseau/gladys-fullykiosk: External Gladys Assistant integration to discover Fully Kiosk Browser tablets via MQTT and control them through their local HTTP REST API. · GitHub. The complete details of the configuration steps (choosing the broker mode, enabling MQTT or Remote Administration on the Fully Kiosk side…) are in the docs/fr.md of the repo.

Known Limitations

  • 100% local network: nothing works if the tablet (or the MQTT broker, in MQTT mode) is unreachable.
  • MQTT reporting is reserved for the Fully Kiosk PLUS license - hence the « Add a tablet by IP Â» action for the free edition.
  • No real-time feedback: the dashboard only reflects the actual state after the next scheduled MQTT report (or a manual poll, every ~10 min).
  • « Restart Device Â» and some commands require the tablet to be Device Owner (or rooted), otherwise Fully Kiosk rejects the command.

Full details (and a few Fully Kiosk quirks documented along the way) in the repo. Coded with the help of Claude Code, Apache-2.0 license.

Feel free to test - feedback and issues welcome on the GitHub repo :slightly_smiling_face:

2 Likes