Skip to content

Latest commit

 

History

History

changedetection.io

Home assistant add-on: changedetection.io

Donate Donate

Version Ingress Arch

Codacy Badge GitHub Super-Linter Builder

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

Stargazers repo roster for @alexbelgium/hassio-addons

downloads evolution

About

Changedetection.io provides free, open-source web page monitoring, notification and change detection.

This addon is based on the docker image from linuxserver.io.

Configuration

Main app

Web UI can be found at <your-ip>:5000, also accessible from the add-on page.

Sidebar shortcut

You can add a shortcut pointing to your Changedetection.io instance with the following steps:

  1. Go to ⚙ Settings > Dashboards
  2. Click ➕ Add Dashboard at the bottom corner
  3. Select the Webpage option, and paste the Web UI URL you got from the add-on page.
  4. Fill in the title for the sidebar item, an icon (suggestion: mdi:vector-difference), and a relative URL for that panel (e.g. change-detection). Lastly, confirm it.

Configurable options

PGID: user
GPID: user
TZ: Etc/UTC specify a timezone to use, see https://en.wikipedia.org/wiki/List_of_tz_database_time_zones#List
BASE_URL: Specify the full URL (including protocol) when running behind a reverse proxy

Connect to browserless Chrome (from @RhysMcW)

In HA, use the File Editor add-on (or Filebrowser) and edit the Changedetection.io config file at /homeassistant/addons_config/changedetection.io/config.yaml.

Add the following line to the end of it:

PLAYWRIGHT_DRIVER_URL: ws://2937404c-browserless-chrome:3000/chromium?launch={"defaultViewport":{"height":720,"width":1280},"headless":false,"stealth":true}&blockAds=true

Remember to add a blank line at the end of the file too according to yaml requirements.

The 2937404c-browserless-chrome hostname is displayed in the UI, on the Browserless Chromium addon page: image

You can also fetch it:

  • By using SSH and running docker exec -i hassio_dns cat "/config/hosts"
  • From the CLI in HA, using arp
  • You should also be able to use your HA IP address.

Then restart the Changedetection.io add-on - after that you can use the browser options in Changedetection.io.

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other Hass.io add-on.

  1. Add my Hass.io add-ons repository to your Hass.io instance.
  2. Install this add-on.
  3. Click the Save button to store your configuration.
  4. Start the add-on.
  5. Check the logs of the add-on to see if everything went well.
  6. Carefully configure the add-on to your preferences, see the official documentation for for that.