This tool can be used to display a Lovelace view of your Home Assistant instance on a jailbroken Kindle device. It regularly takes a screenshot which can be polled and used as a screensaver image of the online screensaver plugin.

If you're looking for a way to render your own HTML, see my other project hass-kindle-screensaver which renders a React page and can be adapted to your specific needs.

This tool regularly takes a screenshot of a specific page of your home assistant setup. It converts it into the PNG grayscale format which Kindles can display.

Using my own Kindle 4 setup guide or the online screensaver extension for any jailbroken Kindle, this image can be regularly polled from your device so you can use it as a weather station, a display for next public transport departures etc.

You may simple set up the sibbl/hass-lovelace-kindle-screensaver docker container. The container exposes a single port (5000 by default).

You can access the image by doing a simple GET request to e.g. http:https://localhost:5000/ to receive the most recent image.

Home Assistant related stuff:

* Array means that you can set HA_SCREENSHOT_URL_2, HA_SCREENSHOT_URL_3, ... HA_SCREENSHOT_URL_n to render multiple pages within the same instance. If you use HA_SCREENSHOT_URL_2, you can also set ROTATION_2=180. If there is no ROTATION_n set, then ROTATION will be used as a fallback. You can access these additional images by making GET Requests http:https://localhost:5000/2, http:https://localhost:5000/3.png etc.

You may also simply use the docker-compose.yml file inside this repository, configure everything in there and run docker-compose up.

From time to time, you may need to restart the process. You can do this by sending a GET request to /exit endpoint. This will exit the process. Simply set your docker container to restart: unless-stopped to automatically restart it.

http:https://localhost:5000/exit

Some advanced variables for local usage which shouldn't be necessary when using Docker:

• OUTPUT_PATH=./output.png (destination of rendered image. OUTPUT_2, OUTPUT_3, ... is also supported)
• PORT=5000 (port of server, which returns the last image)
• USE_IMAGE_MAGICK=false (use ImageMagick instead of GraphicsMagick)
• UNSAFE_IGNORE_CERTIFICATE_ERRORS=true (ignore certificate errors of e.g. self-signed certificates at your own risk)

There is a automated build on the Docker Hub. lanrat/hass-screenshot

version: '3.7'

services:
  hass-screenshot:
    container_name: hass-screenshot
    image: lanrat/hass-screenshot
    deploy:
      resources:
        limits:
          memory: 1G
    environment:
      - TZ=America/Los_Angeles
      - HA_BASE_URL=HOME_ASSISTANT_URL
      - HA_ACCESS_TOKEN=HOME_ASSISTANT_URL
      - LANGUAGE=en
      - MQTT_SERVER=MQTT_SERVER_IP
      - REAL_TIME=true
      - RENDERING_DELAY=2
      - COLOR_MODE=GrayScale
        # image 1
      - HA_SCREENSHOT_URL=/lovelace-infra/hud1?kiosk
      - RENDERING_SCREEN_HEIGHT=825
      - RENDERING_SCREEN_WIDTH=1200
      - GRAYSCALE_DEPTH=3
        # image 2
      - HA_SCREENSHOT_URL_2=/lovelace-infra/hud2?kiosk
      - RENDERING_SCREEN_HEIGHT_2=800
      - RENDERING_SCREEN_WIDTH_2=600
      - GRAYSCALE_DEPTH_2=4
        # image 3
      - HA_SCREENSHOT_URL_3=/lovelace-infra/hud3?kiosk
      - RENDERING_SCREEN_HEIGHT_3=800
      - RENDERING_SCREEN_WIDTH_3=600
      - GRAYSCALE_DEPTH_3=4
    restart: unless-stopped
    ports:
      - 5000:5000
    healthcheck:
      test: "wget --no-verbose --tries=1 --spider http:https://localhost:5000/ || exit 1"
      interval: 60s
      timeout: 5s
      retries: 3
      start_period: 60s