dgtlmoon
7a66b69158
|
3 years ago | |
|---|---|---|
| .github | 3 years ago | |
| changedetectionio | 3 years ago | |
| .dockerignore | 4 years ago | |
| .gitignore | 3 years ago | |
| CONTRIBUTING.md | 3 years ago | |
| Dockerfile | 3 years ago | |
| LICENSE | 4 years ago | |
| MANIFEST.in | 3 years ago | |
| Procfile | 3 years ago | |
| README-pip.md | 3 years ago | |
| README.md | 3 years ago | |
| app.json | 3 years ago | |
| btc-support.png | 4 years ago | |
| changedetection.py | 3 years ago | |
| docker-compose.yml | 3 years ago | |
| heroku.yml | 3 years ago | |
| requirements-dev.txt | 3 years ago | |
| requirements.txt | 3 years ago | |
| runtime.txt | 3 years ago | |
| screenshot-diff.png | 4 years ago | |
| screenshot-notifications.png | 4 years ago | |
| screenshot.png | 3 years ago | |
| setup.py | 3 years ago | |
README.md
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.
Open source web page monitoring, notification and change detection.
Get your own instance now on Lemonade!
- Automatic Updates, Automatic Backups, No Heroku "paused application", don't miss a change!
- Javascript browser included
- Pay with Bitcoin
Example use cases
- Products and services have a change in pricing
- Governmental department updates (changes are often only on their websites)
- New software releases, security advisories when you're not on their mailing list.
- Festivals with changes
- Realestate listing changes
- COVID related news from government websites
- University/organisation news from their website
- Detect and monitor changes in JSON API responses
- API monitoring and alerting
- Changes in legal and other documents
- Trigger API calls via notifications when text appears on a website
- Glue together APIs using the JSON filter and JSON notifications
- Create RSS feeds based on changes in web content
- You have a very sensitive list of URLs to watch and you do not want to use the paid alternatives. (Remember, you are the product)
Need an actual Chrome runner with Javascript support? We support fetching via WebDriver!
Screenshots
Examining differences in content.
Please ⭐ star ⭐ this project and help it grow! https://github.com/dgtlmoon/changedetection.io/
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
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.
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!
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.
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
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
Windows native support?
Sorry not yet :( https://github.com/dgtlmoon/changedetection.io/labels/windows
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.
Please support us, even small amounts help a LOT.
BTC 1PLFN327GyUarpJd7nVe7Reqg9qHx5frNn
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