Home Assistant Display Platform

With Fully Kiosk Browser Component

This project is for a display platform for Home Assistant that can be remotely controlled. The initial use-case for this is to control Fully Kiosk Browser using it's built-in REST API.

Warning: If you are upgrading from a previous version, please note that some of the service calls have changed!!

Features

This component currently supports the following features of Fully Kiosk Browser:

turning the screen of the tablet on and off,
reloading the start page,
loading a provided URL,
adjusting the tablet screen brightness,
turning the tablet screensaver on, off and adjusting the screensaver brightness.
playing a mp3 file located on the tablet or on a http url

Installation

Clone the repository into a convenient location and then symlink the display and fully_kiosk folders into custom_components. Ensure the trailing slash is not included on the symlink source.

$ git clone https://github.com/daemondazz/homeassistant-displays.git $CONFIGDIR/third_party/displays_git
$ ln -s $CONFIGDIR/third_party/displays_git/custom_components/display $CONFIGDIR/custom_components/display
$ ln -s $CONFIGDIR/third_party/displays_git/custom_components/fully_kiosk $CONFIGDIR/custom_components/fully_kiosk

Then you need to add a display: section to your configuration file with the IP addresses of the displays you want to control:

display:
  - platform: fully_kiosk
    name: Kitchen Tablet
    host: 192.168.1.100
    password: 1234

On the tablet, you will need to enable the Remote Administration (from local network only should be fine) and set a Remote Admin Password.

Updating

If you used the above method for installation, you can update by simply performing a git pull and restarting home assistant.

$ cd $CONFIGDIR/third_party/displays_git
$ git pull
$ service homeassistant restart

Usage

Once installed, you should have a new Display card on your main HA Overview page. The state card for each tablet will show some information about the tablet, such as manufacturer, model and battery status and allow the screen to be turned on and off.

Display Platform Services

The display component supports the following services:

display.load_url
display.set_brightness
display.turn_off
display.turn_on

Fully Browser Kiosk Specific Services

The fully_kiosk platform provides the following services:

fully_kiosk.load_start_url
fully_kiosk.say
fully_kiosk.screensaver_start
fully_kiosk.screensaver_stop
fully_kiosk.set_screensaver_brightness
fully_kiosk.sound_play
fully_kiosk.sound_stop