Home assistant add-on: changedetection.io

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

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

Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

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:

Go to ⚙ Settings > Dashboards
Click ➕ Add Dashboard at the bottom corner
Select the Webpage option, and paste the Web UI URL you got from the add-on page.
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.

Options

Option	Type	Default	Description
`PGID`	int	`0`	Group ID for file permissions
`PUID`	int	`0`	User ID for file permissions
`TZ`	str		Timezone (e.g., `Europe/London`)
`BASE_URL`	str		Full URL when running behind reverse proxy
`TIMEOUT`	int	`60000`	Request timeout in milliseconds

Example Configuration

PGID: 0
PUID: 0
TZ: "Europe/London"
BASE_URL: "https://changedetection.mydomain.com"
TIMEOUT: 60000

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?headless=true&blockAds=true&stealth=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:

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.

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

5.3 KiB Raw Blame History Unescape Escape