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!!
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
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.
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
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.
The display component supports the following services:
- display.load_url
- display.set_brightness
- display.turn_off
- display.turn_on
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