changedetection.io  by dgtlmoon

Intelligent website change detection and monitoring

Created 5 years ago
31,266 stars

Top 1.3% on SourcePulse

GitHubView on GitHub
Project Summary

Summary dgtlmoon/changedetection.io offers a free, open-source tool for automated website change detection, monitoring, and real-time alerts. It targets users needing to track content updates, price changes, stock availability, and website integrity, providing a powerful alternative to paid services with advanced AI features.

How It Works The system utilizes flexible fetchers, supporting both fast HTTP requests and JavaScript rendering via Playwright/WebDriver for dynamic pages. Users can precisely target elements using CSS selectors, XPath, or a Visual Selector tool. A key feature is AI integration (via LiteLLM) for natural language intent definition (e.g., "alert only on price drops") and generating concise change summaries, reducing alert noise. Interactive browser steps enable pre-detection actions like logins.

Quick Start & Requirements Installation is available via Docker (docker compose up -d) or pip (pip3 install changedetection.io). Playwright/WebDriver is needed for dynamic sites. Raspberry Pi and ARM devices are supported. Documentation is accessible via the GitHub wiki.

Highlighted Details

  • AI-driven change detection with plain-language intents and automated summaries.
  • Visual Selector for precise element targeting.
  • Interactive browser steps for complex site interactions.
  • Broad notification support via Apprise (Discord, Slack, Email, Webhooks, etc.).
  • Monitoring of PDF text changes, file size, and checksums.
  • JSON API monitoring with JSONPath/jq filtering.
  • Configurable fetchers (HTTP vs. JavaScript).
  • Import support for .xlsx and plain text lists.
  • Comprehensive REST API.

Maintenance & Community The project acknowledges contributors, including Constantin Hong. Commercial support is offered via email.

Licensing & Compatibility The primary project license is not explicitly stated in the README, though a sub-component uses the MIT license. Users should verify license terms for commercial use. A broad disclaimer places responsibility on the user for compliance with monitored sites' terms and laws.

Limitations & Caveats AI/LLM features transmit data to third-party providers, requiring user responsibility for compliance, costs, and managing API access. AI outputs may contain inaccuracies ("hallucinations") or omissions and should not be solely relied upon. The project includes an "as-is" disclaimer, shifting liability for usage and consequences to the end-user.

Health Check
Last Commit

11 hours ago

Responsiveness

Inactive

Pull Requests (30d)
48
Issues (30d)
19
Star History
518 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.