Discover / Data & Research
changedetection.io
by dgtlmoonPython
Self hosted website change monitoring tool for tracking competitor updates and pricing.
Maturity: experimental because latest release 0.55.8 is pre 1.0. Derived from release and commit history, not a rating.
- Stars
- 33k
- Forks
- 1.9k
- Downloads / mo
- 25k
- Last commit
- 2026-07-31
- License
- Apache-2.0
- Open issues
- 366
Market and trust evidence
Edition not yet matchedNo exact skills.sh identity match is available for this repository. Repository adoption and freshness remain visible above; install momentum is not inferred.
Trust analysis is a screening signal, not a security warranty. Read the ranking and trust methodology.
In practice
Written by AI from this repository’s README · high confidenceThere is no way to know when a price, stock level or page section changed without checking the page by hand.
Use it when
Use it when you want to watch specific parts of pages, including behind a login, and be alerted only on the changes you care about.
Not the right pick when
The Visual Selector and Browser Steps need a Playwright content fetcher enabled, which the README ties to the subscription service.
Capabilities
- notifications via Discord, Email, Slack, Telegram and Webhook
- visual selector to target parts of a page
- browser steps for logins, clicks and form entry
- restock and price change detection for product pages
- diff view by word, line or character
- LLM connected change rules and plain language summaries
Requirements
- Playwright content fetcher for Visual Selector and Browser Steps
- an LLM provider or local endpoint for the AI change rules
Cost: Open source with a paid cloud option
Install
Derived from the published package name in the repository, not from a model.
Video walkthroughs
Monitoring with ChangeDetection.io: the guide to monitoring the web
ChangeDetection.io is a private self-hosted website change detection and price monitor service
Third-party YouTube uploads matched to this tool by title, channel and repository name on 2026-08-03. Not made, reviewed or endorsed by SkillPilot. View counts and publish months are as of the match date and the month is approximate. Nothing loads from YouTube until you press play.
What the repository ships
Detected from the actual files in the repository root.
Latest release 0.55.8
Published 2026-07-13
What's Changed
- feat: Czech translation updated and refined by @svetlemodry in https://github.com/dgtlmoon/changedetection.io/pull/4203
- fix: extract <title> from pages with large <head> sections (#4217) by @crossi-dev in https://github.com/dgtlmoon/changedetection.io/pull/4220
- Restock rename original price to last price by @dgtlmoon in https://github.com/dgtlmoon/changedetection.io/pull/4227
- fix: Tag RSS feed ignores security token when password protection is enabled by @medzin in https://github.com/dgtlmoon/changedetection.io/pull/4235
- LLM: strip sampling params and retry when the model rejects them by @quinnypig in https://github.com/dgtlmoon/changedetection.io/pull/4241
- fix: URL validation rejects valid URLs with '|' in the anchor/fragment (#4209) by @AmirF194 in https://github.com/dgtlmoon/changedetection.io/pull/4243
- fix: .gitignore the real test-log path (changedetectionio/tests/logs) by @AmirF194 in https://github.com/dgtlmoon/changedetection.io/pull/4247
- Add Russian (ru) translation by @Marfa in https://github.com/dgtlmoon/changedetection.io/pull/4236
- Bump the all group across 1 directory with 2 updates by @dependabot[bot] in https://github.com/dgtlmoon/changedetection.io/pull/4238
- fix: don't error watches when Content-Type is JSON but body isn't parsable (#3827) by @TowyTowy in https://github.com/dgtlmoon/changedetection.io/pull/4250
- fix: safe-empty restock default so restock notification tokens work for any watch by @ebarkhordar in https://github.com/dgtlmoon/changedetection.io/pull/4249
- LLM - Raise or remove LLM timeout when local endpoint detected #4225 by @dgtlmoon in https://github.com/dgtlmoon/changedetection.io/pull/4254
- [i18n] JavaScript UI strings not covered by translations #4233 by @dgtlmoon in https://github.com/dgtlmoon/changedetection.io/pull/4255
- [feature] Restock LLM fallback: make the 8000 char content limit configurable, change to 15,000 chars by default #4213 by @dgtlmoon in https://github.com/dgtlmoon/changedetection.io/pull/4257
New Contributors
- @crossi-dev made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4220
- @medzin made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4235
- @quinnypig made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4241
- @AmirF194 made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4243
- @Marfa made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4236
- @TowyTowy made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4250
- @ebarkhordar made their first contribution in https://github.com/dgtlmoon/changedetection.io/pull/4249
Full Changelog: https://github.com/dgtlmoon/changedetection.io/compare/0.55.7...0.55.8
Tags
README
Detect Website Changes Automatically — Monitor Web Page Changes in Real Time
Monitor websites for updates — get notified via Discord, Email, Slack, Telegram, Webhook and many more.
Detect web page content changes and get instant alerts.
Ideal for monitoring price changes, content edits, conditional changes and more.
[![Release Version][release-shield]][release-link] [![Docker Pulls][docker-pulls]][docker-link] [![License][license-shield]](LICENSE.md)
Get started with website page change monitoring straight away. Don't have time? Try our $8.99/month subscription, use our proxies and support! , _half the price of other website change monitoring services!_
- Chrome browser included.
- Nothing to install, access via browser login after signup.
- Super fast, no registration needed setup.
- Get started watching and receiving website change notifications straight away.
- See our tutorials and how-to page for more inspiration
AI-powered website change detection — smart alerts and plain-language summaries
Stop drowning in noise. Connect any LLM (OpenAI, Gemini, Anthropic, Ollama and more) and go from _"something changed"_ to _"only the thing you care about changed"_.
AI change detection rules — write a plain-English intent once: _"notify me only when the price drops below $50"_, _"alert me when the item comes back in stock"_, _"ignore navigation and footer changes"_. The AI evaluates every detected diff against your intent and silently suppresses everything irrelevant. Fewer false positives, zero noise.
AI change summaries — instead of staring at a raw diff, your notification reads _"Price dropped from $89.99 to $67.00"_ or _"3 new products added to the listing"_. Works globally or per-watch, with full control over the prompt.
Works with any model you already pay for — GPT-4o-mini and Gemini Flash handle this well at fractions of a cent per check. Or run it entirely locally with Ollama, vLLM, LM Studio, or any OpenAI-compatible self-hosted endpoint — pick the OpenAI-compatible (vLLM, LM Studio, llama.cpp) option in the provider dropdown and point it at your server's /v1 URL. Powered by LiteLLM, giving you seamless access to 100+ supported providers and models.
_Note: Available in our subscription/hosted service from June 2026_
Target specific parts of the webpage using the Visual Selector tool.
Available when connected to a <a href="https://github.com/dgtlmoon/changedetection.io/wiki/Playwright-content-fetcher">playwright content fetcher</a> (included as part of our subscription service)
Easily see what changed, examine by word, line, or individual character.
Perform interactive browser steps
Fill in text boxes, click buttons and more, setup your changedetection scenario.
Using the Browser Steps configuration, add basic steps before performing change detection, such as logging into websites, adding a product to a cart, accept cookie logins, entering dates and refining searches.
After Browser Steps have been run, then visit the Visual Selector tab to refine the content you're interested in.
Requires Playwright to be enabled.
Awesome restock and price change notifications
Enable the _"Re-stock & Price detection for single product pages"_ option to activate the best way to monitor product pricing, this will extract any meta-data in the HTML page and give you many options to follow the pricing of the product.
Easily organise and monitor prices for products from the dashboard, get alerts and notifications when the price of a product changes or comes back in stock again!
Set price change notification parameters, upper and lower price, price change percentage and more.
Always know when a product for sale drops in price.
Example use cases
- Products and services have a change in pricing
- _Out of stock notification_ and _Back In stock notification_
- Monitor and track PDF file changes, know when a PDF file has text changes.
- 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
- Discogs restock alerts and monitoring
- Realestate listing changes
- Know when your favourite whiskey is on sale, or other special deals are announced before anyone else
- COVID related news from government websites
- University/organisation news from their website
- Detect and monitor changes in JSON API responses
- JSON 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
- Monitor HTML source code for unexpected changes, strengthen your PCI compliance
- 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)
- Get notified when certain keywords appear in Twitter search results
- Proactively search for jobs, get notified when companies update their careers page, search job portals for keywords.
- Get alerts when new job positions are open on Bamboo HR and other job platforms
- Website defacement monitoring
- Pokémon Card Restock Tracker / Pokémon TCG Tracker
- RegTech - stay ahead of regulatory changes, regulatory compliance
_Need an actual Chrome runner with Javascript support? We support fetching via WebDriver and Playwright!</a>_
Key Features
- Lots of trigger filters, such as "Trigger on text", "Remove text by selector", "Ignore text", "Extract text", also using regular-expressions!
- Target elements with xPath 1 and xPath 2, CSS Selectors, Easily monitor complex JSON with JSONPath or jq
- Switch between fast non-JS and Chrome JS based "fetchers"
- Track changes in PDF files (Monitor text changed in the PDF, Also monitor PDF filesize and checksums)
- Easily specify how often a site should be checked
- Execute JS before extracting text (Good for logging in, see examples in the UI!)
- Override Request Headers, Specify
POSTorGETand other methods - Use the "Visual Selector" to help target specific elements
- Configurable proxy per watch
- Send a screenshot with the notification when a change is detected in the web page
We recommend and use Bright Data global proxy services, Bright Data will match any first deposit up to $150 using our signup link.
Please :star: star :star: this project and help it grow! https://github.com/dgtlmoon/changedetection.io/
Conditional web page changes
Easily configure conditional actions, for example, only trigger when a price is above or below a preset amount, or when a web page includes (or does not include) a keyword
<img src="./docs/web-page-change-conditions.png" style="max-width:80%;" alt="Conditional web page changes" title="Conditional web page changes" />
Schedule web page watches in any timezone, limit by day of week and time.
Easily set a re-check schedule, for example you could limit the web page change detection to only operate during business hours.
Or perhaps based on a foreign timezone (for example, you want to check for the latest news-headlines in a foreign country at 0900 AM),
<img src="./docs/scheduler.png" style="max-width:80%;" alt="How to monitor web page changes according to a schedule" title="How to monitor web page changes according to a schedule" />
Includes quick short-cut buttons to setup a schedule for business hours only, or weekends.
We have a Chrome extension!
Easily add the current web page to your changedetection.io tool, simply install the extension and click "Sync" to connect it to your existing changedetection.io install.
Goto the Chrome Webstore to download the extension. ( Or check out the GitHub repo )
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
:latest tag is our latest stable release, :dev tag is our bleeding edge master branch.
Alternative docker repository over at ghcr - ghcr.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 -f name=changedetection.io -q)
docker rm $(docker ps -a -f name=changedetection.io -q)
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
Different browser viewport sizes (mobile, desktop etc)
If you are using the recommended sockpuppetbrowser (which is in the docker-compose.yml as a setting to be uncommented) you can easily set different viewport sizes for your web page change detection, see more information here about setting up different viewport sizes.
Filters
XPath(1.0), JSONPath, jq, 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:match 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 <a href="https://github.com/caronc/apprise">apprise</a> 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://
<a href="https://github.com/caronc/apprise#popular-notification-services">And everything else in
Truncated. Read the full README on GitHub ↗