CorrelAidxNL / changedetection.io

changedetection.io - The best and simplest self-hosted open source website change detection monitoring and notification service. An alternative to Visualping, Watchtower etc. Designed for simplicity - the main goal is to simply monitor which websites had a text change. Open source web page change detection - Now also includes XPATH and JSON API change detection and monitoring support!
https://github.com/dgtlmoon/changedetection.io
Apache License 2.0
0 stars 0 forks source link

changedetection.io

Release Version Docker Pulls License

changedetection.io

Self-Hosted, Open Source, Change Monitoring of Web Pages

Know when web pages change! Stay ontop of new information!

Live your data-life pro-actively instead of re-actively.

Free, Open-source web page monitoring, notification and change detection. Don't have time? Try our $6.99/month subscription - unlimited checks and watches!

Self-hosted web page change monitoring

Get your own private instance now! Let us host it for you!

Try our $6.99/month subscription - unlimited checks and watches! , half the price of other website change monitoring services and comes with unlimited watches & checks!

Example use cases

Need an actual Chrome runner with Javascript support? We support fetching via WebDriver!

Screenshots

Examine differences in content.

Easily see what changed, examine by word, line, or individual character.

Self-hosted web page change monitoring context difference

Please :star: star :star: this project and help it grow! https://github.com/dgtlmoon/changedetection.io/

Target elements with the Visual Selector tool.

Available when connected to a playwright content fetcher (available also as part of our subscription service)

Self-hosted web page change monitoring context difference

Installation

Docker

With Docker composer, just clone this repository and..

$ docker-compose up -d

Docker standalone

$ docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io dgtlmoon/changedetection.io

Windows

See the install instructions at the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Microsoft-Windows

Python Pip

Check out our pypi page https://pypi.org/project/changedetection.io/

$ pip3 install changedetection.io
$ changedetection.io -d /path/to/empty/data/dir -p 5000

Then visit http://127.0.0.1:5000 , You should now be able to access the UI.

Now with per-site configurable support for using a fast built in HTTP fetcher or use a Chrome based fetcher for monitoring of JavaScript websites!

Updating changedetection.io

Docker

docker pull dgtlmoon/changedetection.io
docker kill $(docker ps -a|grep changedetection.io|awk '{print $1}')
docker rm $(docker ps -a|grep changedetection.io|awk '{print $1}')
docker run -d --restart always -p "127.0.0.1:5000:5000" -v datastore-volume:/datastore --name changedetection.io dgtlmoon/changedetection.io

docker-compose

docker-compose pull && docker-compose up -d

See the wiki for more information https://github.com/dgtlmoon/changedetection.io/wiki

Filters

XPath, JSONPath and CSS support comes baked in! You can be as specific as you need, use XPath exported from various XPath element query creation tools.

(We support LXML re:test, re:math and re:replace.)

Notifications

ChangeDetection.io supports a massive amount of notifications (including email, office365, custom APIs, etc) when a web-page has a change detected thanks to the apprise library. Simply set one or more notification URL's in the [edit] tab of that watch.

Just some examples

discord://webhook_id/webhook_token
flock://app_token/g:channel_id
gitter://token/room
gchat://workspace/key/token
msteams://TokenA/TokenB/TokenC/
o365://TenantID:AccountEmail/ClientID/ClientSecret/TargetEmail
rocket://user:password@hostname/#Channel
mailto://user:pass@example.com?to=receivingAddress@example.com
json://someserver.com/custom-api
syslog://

And everything else in this list!

Self-hosted web page change monitoring notifications

Now you can also customise your notification content!

JSON API Monitoring

Detect changes and monitor data in JSON API's by using the built-in JSONPath selectors as a filter / selector.

image

This will re-parse the JSON and apply formatting to the text, making it super easy to monitor and detect changes in JSON API results

image

Parse JSON embedded in HTML!

When you enable a json: filter, you can even automatically extract and parse embedded JSON inside a HTML page! Amazingly handy for sites that build content based on JSON, such as many e-commerce websites.

<html>
...
<script type="application/ld+json">
  {"@context":"http://schema.org","@type":"Product","name":"Nan Optipro Stage 1 Baby Formula  800g","price": 23.50 }
</script>

json:$.price would give 23.50, or you can extract the whole structure

Proxy configuration

See the wiki https://github.com/dgtlmoon/changedetection.io/wiki/Proxy-configuration

Raspberry Pi support?

Raspberry Pi and linux/arm/v6 linux/arm/v7 arm64 devices are supported! See the wiki for details

Support us

Do you use changedetection.io to make money? does it save you time or money? Does it make your life easier? less stressful? Remember, we write this software when we should be doing actual paid work, we have to buy food and pay rent just like you.

Firstly, consider taking out a change detection monthly subscription - unlimited checks and watches , even if you don't use it, you still get the warm fuzzy feeling of helping out the project. (And who knows, you might just use it!)

Or directly donate an amount PayPal Donate

Or BTC 1PLFN327GyUarpJd7nVe7Reqg9qHx5frNn

Support us!

Commercial Support

I offer commercial support, this software is depended on by network security, aerospace , data-science and data-journalist professionals just to name a few, please reach out at dgtlmoon@gmail.com for any enquiries, I am more than glad to work with your organisation to further the possibilities of what can be done with changedetection.io