Skip to content
CAI
Software that uses CAICheck a score

dgtlmoon/changedetection.io

42.9

Weak · 16 November 2026

40.2k

lines of production code

Python

with JavaScript

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add complete Spanish translation (es)

The application now includes a full Spanish language translation, allowing users to interface with the UI in Spanish. This covers key areas such as adding new watches, managing backups, and restoring data. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio; UI now follows the device's light/dark setting by default; Browser fetchers can now capture and store original PDFs for change detection.

changedetectionio/translations/es · medium confidence · unverified

Add price data follower accept/reject endpoints

Users can now explicitly accept or reject the automatic tracking of LD+JSON price data for a watch. Accepting switches the watch to the 'restock\_diff' processor and queues it for immediate re-scanning, while rejecting simply disables the tracking flag without re-scanning.

_changedetectionio/blueprint/price\_data\follower · high confidence

Added Extract Data UI for regex-based text extraction from watch history

A new 'Extract Data' tab has been added to the watch history interface, allowing users to apply regular expressions to extract specific text patterns from all historical data of a watch. The UI includes a form for entering the regex pattern, inline help explaining how regex groups map to columns (with the date always in the first column), and a link to an external regex testing tool.

changedetectionio/processors/templates · high confidence

Added Indonesian and Russian translations and updated translation guidelines

The application now includes full translation files for Indonesian (id) and Russian (ru), making these languages available in the user interface. Additionally, a new Translators Guide (README.md) has been added to the translations directory, establishing best practices for maintaining \.po\ files, such as avoiding fragmented \msgid\s and handling CJK-specific formatting. The translation catalog (\messages.pot\) has also been updated to reflect the latest source strings.

changedetectionio/translations · high confidence

Added Portuguese (Brazil) translations

Users can now see the application interface in Portuguese (Brazil), with translations covering key areas such as adding new watches, managing backups, and restoring data. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio; UI now follows the device's light/dark setting by default.

_changedetectionio/translations/pt\BR · medium confidence · unverified

Added Traditional Chinese (Taiwan) translation support

Users can now see the interface in Traditional Chinese (Taiwan). This change introduces the zh\_Hant\_TW locale, providing translations for key UI elements such as the watch creation flow, backup and restore operations, and browser selection options.

_changedetectionio/translations/zh\_Hant\TW · high confidence

Added Turkish language support

Users can now view the application interface in Turkish. This change adds a complete set of translations for the Turkish locale, covering key areas such as adding new watches, managing backups, and restoring data. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio; UI now follows the device's light/dark setting by default.

changedetectionio/translations/tr · medium confidence · unverified

Initial Korean language support added

The application now includes a Korean (ko) translation file, enabling the user interface to be displayed in Korean for users with this language preference. This adds the necessary localization strings for core features such as adding watches, managing backups, and configuring browser settings.

changedetectionio/translations/ko · high confidence

Initial project scaffolding and Docker build configuration

This change introduces the foundational structure for the application, including a multi-stage Dockerfile based on Python 3.11 (Debian Bookworm) that configures locales for correct number formatting and sets up the entrypoint to handle extra packages. It also adds a \docker-compose.yml\ for containerized deployment, a \setup.py\ for pip installation, and development tooling configurations such as \.ruff.toml\ for linting and \.pre-commit-config.yaml\ for code quality checks.

(repo-wide) · high confidence

Introduce Progressive Web App (PWA) support for mobile installation and sharing

The application now supports installation as a Progressive Web App on mobile devices. This adds a PWA manifest, a lightweight service worker to enable Android WebAPK registration, and a QR code generator in the Settings page to simplify phone installation. It also implements an Android Web Share Target, allowing users to share links from other apps directly into the watch list's quick-add form. The feature respects reverse-proxy sub-paths and requires HTTPS (or an explicit override) to offer the install UI.

changedetectionio · high confidence

Introduce intent-based LLM change evaluation and non-blocking summaries

The \changedetectionio/llm\ module now provides an intent-based change evaluation system that uses the LLM to determine if a page diff matches a user's specific monitoring intent (e.g., price drops, new products) rather than just detecting any change. This includes a BM25-based relevance trimmer to focus context, robust parsing of LLM responses (including reasoning blocks and JSON), and a non-blocking background job system for generating AI change summaries to prevent UI blocking during long LLM calls.

changedetectionio/llm · high confidence

Japanese language support added to the application

The application now includes a Japanese (ja) translation file, enabling Japanese language support for the user interface. This addition covers translations for core features such as adding new watches, managing backups, and restoring data, allowing Japanese-speaking users to interact with the system in their native language. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio; UI now follows the device's light/dark setting by default.

changedetectionio/translations/ja · medium confidence · unverified

LLM-based fallback for price and restock detection

A new LLM fallback plugin has been added to the restock diff processor to handle cases where standard structured data extraction (JSON-LD, microdata) fails. When built-in methods cannot determine both price and availability, the system now sends a cleaned, trimmed version of the page content to a configured Large Language Model to extract structured JSON results. This includes configurable content limits (defaulting to 15,000 characters) and a local result cache to avoid redundant API calls for unchanged pages, enabling more robust price and stock monitoring for complex product pages. Also in this area: 7 commits (0 fixes) modifying changedetectionio; Plugins can now perform LLM price/stock extraction without requiring litellm; Browser fetchers can now capture and store original PDFs for change detection.

_changedetectionio/processors/restock\diff/plugins · medium confidence · unverified

New Conditions system for watch filtering

A new 'Conditions' module has been added, allowing users to define complex filtering rules (such as value comparisons, text matching, and regex checks) on watch snapshots. This feature introduces a plugin-based architecture using the pluggy library, enabling extensible operators and data fields, and includes a dedicated API endpoint to verify condition rules against current page content.

changedetectionio/conditions · high confidence

New Imports page with Distill.io and XLSX support

A new Imports page has been added, providing a unified interface for importing watch lists. Users can now paste URLs directly, import monitors via Distill.io JSON exports, or upload XLSX files with custom column mapping. The page also includes a link to the Backup Restore functionality.

changedetectionio/blueprint/imports/templates · high confidence

New Levenshtein similarity and word count condition plugins

Users can now apply conditions based on text similarity and content length. The new Levenshtein plugin calculates similarity metrics (distance, ratio, and percent similar) between the latest and previous snapshots, with a safeguard to skip statistics for very large documents (over 100,000 characters) to prevent performance issues. The word count plugin provides a simple metric of the number of words in the latest snapshot. Both plugins register new fields for use in change detection conditions and display their respective statistics in the edit page UI.

changedetectionio/conditions/plugins · high confidence

New REST API endpoints for managing watches, tags, notifications, and system state

The API module now exposes dedicated endpoints for importing watches (Import.py), managing notification URLs (Notifications.py), searching watches (Search.py), and handling tags (Tags.py), alongside existing watch and system info endpoints. These endpoints validate inputs against the OpenAPI specification, support background processing for large imports, and enforce security checks such as CSS injection prevention for tag colors and timezone validation for watch schedules.

changedetectionio/api · high confidence

New backup management interface with restore capabilities

The backups section now includes a dedicated UI for creating and restoring backups. Users can request new backups, view existing ones, and permanently remove them via a CSRF-protected form. A new 'Restore' tab allows uploading .zip backup files (created on/after v0.53.1) to restore watches and groups, with options to include/replace existing groups and watches. The interface enforces upload size limits and displays status indicators for ongoing operations.

changedetectionio/blueprint/backups/templates · high confidence

New dedicated Add Watch UI with live visual preview and secure URL filtering

The 'Add Watch' workflow now uses a dedicated UI that provides a live visual preview of the target page before saving. This allows users to select specific elements to monitor via a visual selector, and the system automatically pre-selects a browser capable of rendering screenshots and element data. The snapshot endpoint is secured against SSRF by enforcing strict URL validation (addressing [GHSA redacted]) and requires POST requests with CSRF protection.

_changedetectionio/blueprint/add\_watch\ui · high confidence

New diff rendering module with word-level highlighting and change extraction tokens

A new \changedetectionio/diff\ module has been introduced to handle diff rendering, providing word-level inline highlighting for changes using the \diff-match-patch\ library. This module supports configurable tokenization strategies (simple whitespace or HTML-aware) to accurately detect changes within lines while preserving HTML tags. It introduces new notification tokens \{{diff\_changed\_from}}\ and \{{diff\_changed\_to}}\, which allow users to extract only the specific old or new values from a change, rather than the entire line. The implementation includes specific logic to handle whole-line replacements and nested highlighting, ensuring that diff outputs are correctly formatted for email clients that may strip certain HTML tags.

changedetectionio/diff · high confidence

New fast OpenCV-based screenshot comparison processor

A new processor module (image\_ssim\_diff) has been added that replaces the legacy SSIM-based comparison with a fast OpenCV algorithm, offering 50-100x faster performance. This processor supports visual region selection via CSS/XPath selectors or manual bounding boxes, allows per-watch sensitivity tuning, and generates three-panel diff views (Previous, Current, Difference) with red highlights. It also includes an optional Pixelmatch backend for better anti-aliasing detection on text-heavy screenshots.

_changedetectionio/processors/image\_ssim\diff · high confidence

New import functionality for URLs, Distill.io, and XLSX files

Users can now import watch lists directly into Change Detection IO via a new import page. This feature supports bulk importing from plain text URL lists, migrating existing monitors from Distill.io via JSON, and uploading XLSX files (including Wachete format and custom column mappings). The system handles validation, respects the configured watch limit, and integrates the imported items into the scheduler without requiring manual queueing.

changedetectionio/blueprint/imports · high confidence

New interactive UI components for browser automation, diff navigation, and data conditions

The application introduces several new JavaScript modules to enhance the user interface. A new 'Browser Steps' interface allows users to visually select and configure automated browser actions (click, type, wait) on a live page preview, including a session keep-alive countdown. A 'Comparison Slider' widget enables users to interactively compare two images (before/after) by dragging a handle. The 'Conditions' module provides a dynamic UI for adding, removing, and verifying data rules (e.g., price ranges) against current snapshots. Additionally, the diff viewing experience is improved with a 'Diff Overview' module for keyboard-based version stepping and a collapsible filter panel, and a 'Diff Render' module that adds a visual minimap to jump directly to specific changes within the diff text.

changedetectionio/static/js · high confidence

New restock and price tracking processor with configurable alerts

A new \restock\_diff\ processor is introduced to monitor product availability and price changes. It allows users to configure triggers for restock events (Out of Stock to In Stock), set absolute price limits (min/max), and define percentage-based change thresholds. The processor supports notification tokens like \{{restock.price}}\ and \{{restock.previous\_price}}\, and provides a visual timeline of price history with statistical summaries (min, max, median, percentiles) in the watch history view.

_changedetectionio/processors/restock\diff · high confidence

New tag/group management interface with AI and restock configuration

A new tags blueprint introduces a dedicated UI for managing groups (tags), allowing users to create, edit, and delete tags that act as abstract configurations for watches. This feature enables applying settings such as custom background colors (with strict hex-color validation to prevent CSS injection), URL-based auto-application patterns, and specific AI/LLM change detection rules (including intent, summary prompts, and append/replace modes) to multiple watches at once. It also supports configuring restock and price monitoring limits at the group level, with options to override individual watch settings or inherit them.

changedetectionio/blueprint/tags · high confidence

New ternary radio widget with customizable labels

A new \TernaryNoneBooleanField\ widget is introduced in the \widgets\ module, providing a horizontal radio button group that supports three states (Yes/No/Default) or two states (Yes/No) in boolean mode. Users can now customize the display text for each option (e.g., using emojis or HTML) via \yes\_text\, \no\_text\, and \none\_text\ parameters, allowing for more descriptive and visually distinct settings in forms.

changedetectionio/widgets · high confidence

New visual diff and image comparison UI styles

The application introduces dedicated CSS files for the diff and image comparison views. The new \diff-image.css\ provides styling for a side-by-side image comparison slider, allowing users to visually inspect screenshot differences with a draggable handle and labeled panels. The \diff.css\ file styles the text-based diff interface, including a sticky header for filter controls, a visual jump-bar to navigate through text changes, and specific highlighting for triggered and ignored text snippets. Additionally, \flag-icons.min.css\ is added to support country flag icons in the UI, and build artifacts (\.dockerignore\, \.gitignore\) are configured to exclude \node\_modules\ and \package-lock.json\ from the styles directory.

changedetectionio/static/styles · high confidence

Processor system refactored into a pluggable architecture with API schema extension

The processor subsystem has been restructured to support a pluggable architecture, allowing new processors (such as the existing \restock\diff\) to be added as sub-packages with their own configuration schemas. Processors can now extend the Watch/Tag API schema by placing an \api.yaml\ file alongside their \\\init\\_.py\, which is automatically merged into the API specification at startup. The system dynamically discovers built-in and plugin processors via \pluggy\, and introduces a standardized contract for difference rendering (\difference\_base.py\) and data extraction (\extract.py\), while also improving content-type detection using \puremagic\.

changedetectionio/processors · high confidence

Proxy scanning tool for watches

A new proxy scanning feature has been added, allowing users to test the accessibility and performance of configured proxies against specific watches. This is implemented via a new \check\_proxies\ blueprint that exposes endpoints to start a scan and check its status. The scan runs in a thread pool, executing a site check for each proxy and reporting results such as status codes (including handling 404s as 'OK' with a warning, or access denied errors) and response times, helping users verify which proxies are working correctly for their monitored content.

_changedetectionio/blueprint/check\proxies · high confidence

RSS feed generation and access control

The application now provides RSS feeds for all changes, individual watches, and specific tags. Access to these feeds is secured via a configurable access token, and the feed content format can be customized to match notification body styles or use system defaults. Invalid characters in feed content are automatically cleaned to ensure valid XML output.

changedetectionio/blueprint/rss · high confidence

Removals

Removal of legacy backend components

The legacy backend implementation files (backend.py, nocache.py, and store.py) have been removed from the codebase. This deletion eliminates the previous Flask application entry point, the custom no-cache decorator, and the original JSON-based data store class, indicating a structural shift in how the application's core logic and data persistence are handled.

backend · high confidence

Removal of legacy dev-docker stub files

The legacy development Docker setup located in the \backend/dev-docker\ directory has been removed. This includes the deletion of the \Dockerfile\ (which previously built a Python 3.8 container running a sleep script), the \build.sh\ script for managing the container lifecycle, and the \sleep.py\ application code. Users relying on this specific directory for local development should note that these files are no longer present.

backend/dev-docker · high confidence

Security

Introduces Pydantic-based validation for LLM and App settings to prevent mass-assignment vulnerabilities

The application model layer now uses Pydantic models to validate and enforce configuration schemas, starting with LLM settings and global application settings. This change introduces strict input validation (using \extra='forbid'\) to prevent unknown or malicious fields from being written to the configuration storage, addressing a CWE-915 mass-assignment vulnerability. Users benefit from more robust configuration handling where invalid settings are rejected at the boundary, ensuring that only declared fields are persisted. The migration plan outlined in the code indicates this is the first step in a broader effort to secure all form and API inputs across the application.

changedetectionio/model · high confidence

SSRF protection and credential-exfiltration guards for LLM settings

The LLM settings interface now validates the \api\_base\ URL against SSRF attacks and prevents accidental credential leakage by refusing to use stored API keys when the request targets a different endpoint than the one saved in the configuration. These security checks apply to both the model-list retrieval and connection-test endpoints, ensuring that operator keys are never sent to unverified or mismatched destinations. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio; UI now follows the device's light/dark setting by default.

changedetectionio/blueprint/settings · medium confidence · unverified

Security fix for reflected XSS and new sidebar display modes

This update addresses a reflected XSS vulnerability ([GHSA redacted]) in the /diff/\<uuid\>/download-patch endpoint by introducing a plaintext\_response helper that forces Content-Type: text/plain, preventing the browser from parsing user-supplied input as markup. Additionally, the application now supports configurable left-rail sidebar modes, allowing users to choose between 'Expand on hover', 'Always expanded', or 'Stays minimal' display behaviors.

changedetectionio/blueprint · high confidence

Architecture

UI routes reorganized into modular blueprints

The UI endpoint definitions have been restructured from a single monolithic file into separate, modular Flask blueprints (edit, notification, preview, queue, views, diff). This change improves code organization and maintainability by grouping related routes and logic into dedicated modules, while preserving all existing functionality and user-facing behavior.

changedetectionio/blueprint/ui · high confidence

Behavioural changes

10 commits (0 fixes) modifying changedetectionio/blueprint/settings/llm

A change to existing behaviour in changedetectionio/blueprint/settings/llm — 10 commits, 1 file: “MCP - history tools , line\_timeline, restock\_status, find\_change etc (\#4653)”; “AI settings - saving no longer switches off checkboxes the page didn't show (\#4682) (\#4683)”; “MCP - "MCP Note" settings sub-tab, set what assistants are told when they connect (\#4670)”; and 7 more (refs \#4653, \#4682, \#4683, \#4670, \#4636, …).

changedetectionio/blueprint/settings/llm · medium confidence · unverified

14 commits (0 fixes) modifying changedetectionio/blueprint/mcp

A change to existing behaviour in changedetectionio/blueprint/mcp — 14 commits, 3 files: “MCP - history tools , line\_timeline, restock\_status, find\_change etc (\#4653)”; “MCP - history tools round 2: line\_timeline, every match in find\_change, price history in restock\_status (\#4650)”; “MCP - "MCP Note" settings sub-tab, set what assistants are told when they connect (\#4670)”; and 11 more (refs \#4653, \#4650, \#4670, \#4736, \#4636, …).

changedetectionio/blueprint/mcp · medium confidence · unverified

14 commits (0 fixes) modifying changedetectionio/blueprint/settings/llm/templates

A change to existing behaviour in changedetectionio/blueprint/settings/llm/templates — 14 commits, 7 files: “MCP - history tools , line\_timeline, restock\_status, find\_change etc (\#4653)”; “LLM - Thinking budget "Off" also switches thinking off for Claude Haiku/Sonnet 5.x (\#4658)”; “MCP - "MCP Note" settings sub-tab, set what assistants are told when they connect (\#4670)”; and 11 more (refs \#4653, \#4658, \#4670, \#4636, \#4662, …).

changedetectionio/blueprint/settings/llm/templates · medium confidence · unverified

4 commits (1 fix) modifying changedetectionio/jinja2\_custom/plugins

A change to existing behaviour in changedetectionio/jinja2\_custom/plugins — 4 commits (1 fix), 3 files: “Template - Adding \\|regex\_replace\ Re \#3501 (\#3536)”; “Notifications - \|regex\_replace ReDoS timeout now works in any thread (use 'regex' package timeout=) (\#4585)”; “Notifications - Fix \|regex\_replace doing nothing when rendered outside the main thread (\#4577)”; and 1 more (refs \#3501, \#3536, \#4585, \#4577, \#3641, …).

_changedetectionio/browser\_steps, changedetectionio/example\_plugins, changedetectionio/jinja2\custom/plugins · medium confidence · unverified

5 commits (0 fixes) modifying changedetectionio/blueprint/mcp/oauth/templates

A change to existing behaviour in changedetectionio/blueprint/mcp/oauth/templates — 5 commits, 1 file: “MCP OAuth - the consent form posts back under the sub-path (Allow gave a 404 behind a proxy) (\#4664)”; “MCP - OAuth 2.1 sign-in, so claude.ai and ChatGPT in the browser can connect (\#4662)”; “MCP oauth consent dialog cleanup (\#4665)”; and 2 more (refs \#4664, \#4662, \#4665, \#4669, \#4679).

changedetectionio/blueprint/mcp/oauth/templates · medium confidence · unverified

58 commits (2 fixes) modifying changedetectionio/translations/pl

A change to existing behaviour in changedetectionio/translations/pl — 58 commits (2 fixs), 2 files: “i18n: Use \msgctxt\ and correct ja translations for -ed forms (\#4460)”; “API Examples (\#4625)”; “MCP - history tools , line\_timeline, restock\_status, find\_change etc (\#4653)”; and 55 more (refs \#4460, \#4625, \#4653, \#4608, \#4658, …).

changedetectionio/translations/pl · medium confidence · unverified

6 commits (0 fixes) modifying changedetectionio/blueprint/mcp/oauth

A change to existing behaviour in changedetectionio/blueprint/mcp/oauth — 6 commits, 4 files: “MCP OAuth - Claude Code can sign in: loopback redirect URIs match on any port (RFC 8252 7.3) (\#4673)”; “MCP OAuth - authorization server metadata also at {issuer}/.well-known/openid-configuration, so installs under a sub-path are found (\#4663)”; “MCP - OAuth 2.1 sign-in, so claude.ai and ChatGPT in the browser can connect (\#4662)”; and 3 more (refs \#4673, \#4663, \#4662, \#4707, \#4676, …).

changedetectionio/blueprint/mcp/oauth · medium confidence · unverified

6 commits (2 fixes) modifying changedetectionio/jinja2\_custom

A change to existing behaviour in changedetectionio/jinja2\_custom — 6 commits (2 fixs), 3 files: “Template - Adding \\|regex\_replace\ Re \#3501 (\#3536)”; “Memory improvement - Use builtin markupsafe instead of creating a jinja2 template env each time for small strings (\#3836)”; “API - Reject broken Jinja2 templates in url, link\_to\_open, body and headers (shared with the edit form) (\#4587)”; and 3 more (refs \#3501, \#3536, \#3836, \#4587, \#3496, …).

_changedetectionio/jinja2\_custom, changedetectionio/processors/restock\diff/templates · medium confidence · unverified

Background backup creation and restore with security hardening

The backups module now supports creating and restoring backups in the background via a new UI, preventing UI blocking during large operations. This update introduces strict security controls for the restore process, including zip-slip path traversal prevention, zip-bomb decompression size limits, and UUID validation for imported watch and tag directories. Additionally, backup downloads are now restricted to verified backup filenames, and incomplete or running backups are hidden from the download list to ensure data integrity.

changedetectionio/blueprint/backups · high confidence

Browser Steps UI now uses a dedicated asynchronous event loop

The Browser Steps feature has been refactored to run its browser automation tasks in a dedicated, thread-safe asynchronous event loop. This architectural change ensures that interactive browser interactions (such as clicking, typing, and scrolling) do not block the main Flask application thread, leading to a more responsive UI and preventing race conditions or timeouts associated with the previous synchronous connection model.

_changedetectionio/blueprint/browser\steps · high confidence

Complete UI overhaul with new sidebar, dark mode, and mobile navigation

The application's user interface has been completely refactored with a new left-rail navigation sidebar that supports minimal (icon-only) and expanded modes, a comprehensive dark mode theme, and a mobile-optimized hamburger menu with slide-out drawer. This update also introduces new styling for the 'Add Watch' three-pane workspace, Browser Steps interface, and AI/LLM summary displays, alongside improved responsive layouts for conditions tables, pagination, and notification bubbles.

changedetectionio/static/styles/scss/parts · high confidence

Datastore refactored to use individual watch files with atomic writes and schema migrations

The internal data storage mechanism has been restructured to save each watch as an individual JSON file (watch.json) within its own UUID directory, rather than writing a single large JSON file for all watches. This change introduces atomic file writes (using temporary files and rename) to improve crash safety and data integrity, supports optional forced fsync for mission-critical deployments, and includes a new schema migration system (DatastoreUpdatesMixin) that automatically backs up the datastore and applies versioned updates when upgrading. The system also now supports faster JSON serialization via orjson if available.

changedetectionio/store · high confidence

Expanded text filtering and AI change summary controls in the watch edit interface

The watch and group edit pages now include dedicated UI sections for advanced text processing and AI-driven change summaries. Users can configure new text filters such as 'Extract lines containing text', 'Extract text', 'Text to ignore', 'Trigger text', and 'Text that should not be present', along with a 'Strip ignored lines' toggle to refine how page content is compared. Additionally, a new AI section allows users to set change intents and custom change summary prompts, with support for inheriting these prompts from parent groups and appending to them at the watch level.

changedetectionio/templates/edit · high confidence

French language translations updated

The French translation file (messages.po) has been updated with new and revised translations for various UI strings, including watch creation, backup management, and system settings.

changedetectionio/translations/fr · high confidence

Improved Discord notification styling and custom HTTP handler format support

Discord notifications now use colored embeds to visually distinguish added (green), removed (red), and changed (orange/blue) content, replacing the previous broken HTML formatting. Additionally, custom HTTP notification handlers (POST, PUT, etc.) now correctly preserve the \format=\ URL parameter, ensuring that HTML or Markdown bodies are sent intact without being stripped to plain text.

_changedetectionio/notification/apprise\plugin · high confidence

Major UI overhaul with new management pages and AI features

The web interface has been significantly refactored, introducing dedicated pages for managing the check queue (queue.html) and clearing all history (clear\_all\_history.html). The watch editing form (edit.html) now features a tabbed layout with new sections for AI/LLM configuration, Filters & Triggers, and Conditions, alongside a foldout for extra page title/link options. The diff view (diff.html) now includes an AI Change Summary, options to include all intermediate snapshots in the summary, and improved keyboard navigation. Additionally, the preview page (preview.html) has been updated to support highlighting triggered, ignored, and blocked lines, and the diff page now offers options to share diffs as images or ignore specific line patterns.

changedetectionio/blueprint/ui/templates · high confidence

Major UI overhaul with new navigation, dark mode, and mobile support

The application interface has been completely refactored to improve usability and responsiveness. A new sidebar navigation system replaces the previous layout, featuring a mobile hamburger menu, a global search modal, and quick-access controls for pausing, muting, and toggling AI mode. The redesign introduces a native dark mode toggle, improved mobile responsiveness, and better visual feedback for real-time updates. Additionally, the template structure has been modularized with shared components for form fields and settings tabs, and the login form has been updated with autofocus and CSRF protection.

changedetectionio/templates · high confidence

Modernized CSS architecture and new image diff visualization

The application's styling has been refactored into a modular SCSS system, introducing a central settings file for breakpoints and gaps, and a main styles.scss that imports specific component modules (such as dark mode, pagination, and the new action sidebar). This change also introduces a new interactive image comparison feature on the diff page, allowing users to visually inspect screenshot differences using a draggable slider with a checkered background overlay, alongside improved sticky header behavior and mobile responsiveness for the diff view.

changedetectionio/static/styles/scss · high confidence

New browser-injected resources for favicon fetching, element locking, and stock detection

Added a new \res/\ directory containing JavaScript resources injected into the browser context to improve scraping reliability and performance. \favicon-fetcher.js\ now fetches multiple favicon candidates in parallel under a shared 3-second deadline to prevent hangs and prefers the highest-resolution icon. \lock-elements-sizing.js\ and \unlock-elements-sizing.js\ temporarily lock the dimensions of elements in the first viewport during full-page screenshot capture to prevent CSS media queries from resizing headers or ads, ensuring consistent visual diffs. \stock-not-in-stock.js\ provides an expanded, multilingual list of out-of-stock phrases for restock detection, and \xpath\_element\_scraper.js\ includes fixes for handling invisible elements and improving selector generation.

_changedetectionio/content\fetchers/res · high confidence

New exception classes for browser and fetcher errors

A new module \changedetectionio.content\_fetchers.exceptions\ has been introduced, defining specific exception classes for various content fetching failures. These include \Non200ErrorCodeReceived\, \JSActionExceptions\, \BrowserConnectError\, \BrowserFetchTimedOut\, \BrowserStepsStepException\, \PageUnloadable\, \EmptyReply\, \ScreenshotUnavailable\, and \ReplyWithContentButNoText\. This change allows the application to handle and distinguish between different types of browser and HTTP errors more precisely, such as connection timeouts, JS action failures, and empty replies, improving error reporting and handling in the content fetching subsystem.

_changedetectionio/content\fetchers/exceptions · high confidence

New tag/group management interface with custom colors and recheck actions

The tag and group management UI has been updated with a new edit form and overview page. Users can now assign custom background colors to tags/groups, which are applied via generated CSS classes in the overview. The overview page displays the number of watches per group and provides direct actions to recheck, edit, unlink, or delete groups, as well as access RSS feeds for each group. The edit form includes tabs for general settings, AI/LLM features, filters & triggers, and notifications, allowing granular control over how tags apply to watches.

changedetectionio/blueprint/tags/templates · high confidence

Real-time UI updates via Socket.IO replace polling

The application now uses a Socket.IO-based real-time system to push live updates to the web interface, replacing the previous polling mechanism. This change enables immediate reflection of watch status changes (checking, completed, errors), queue length updates, and general statistics without requiring page reloads. Users will experience faster feedback when performing operations like pausing, muting, or rechecking watches, as these actions are now handled via WebSocket signals. The system defaults to Python threading for compatibility with async workers and Playwright, with optional gevent support for high-concurrency scenarios.

changedetectionio/realtime · high confidence

Refactored LLM evaluation engine and content fetcher architecture

The LLM change-summary system has been restructured to support per-watch or per-group prompt inheritance (allowing watches to append to the global prompt rather than replacing it entirely), improved handling of reasoning models (such as Gemini and GPT-5) with smarter token budgeting, and a new Pydantic-based settings model for stricter configuration validation. Concurrently, the content fetching layer has been refactored to split fetcher logic into distinct modules (Playwright, Puppeteer, Requests) and introduce a \FetcherCapabilities\ interface to explicitly declare supported features like browser steps, screenshots, and PDF extraction. The UI now includes a master switch to disable all LLM features and supports self-hosted OpenAI-compatible endpoints, while the diff history view uses a centralized resolver to consistently determine which snapshots are compared.

changedetection.io · high confidence

Refactored content fetcher architecture with improved memory management and security

The content fetching system has been restructured to improve stability, security, and performance. A new modular architecture separates fetcher logic into distinct modules (Playwright, Puppeteer, Requests) with a centralized capability resolution system. Memory usage is significantly reduced for large screenshots by offloading image stitching to a separate subprocess, preventing memory leaks in the main process. Security is enhanced by enforcing URL validation on all navigation actions, including Browser Steps, to prevent Server-Side Request Forgery (SSRF) attacks via file:// or private IP addresses. Additionally, screenshot capture now supports configurable maximum heights and viewport element locking to prevent layout shifts during capture.

_changedetectionio/content\fetchers · high confidence

Refactored notification formatting and service-specific styling

The notification system has been refactored to improve how change diffs are rendered across different channels. HTML notifications now use a dedicated 'HTML Color' format that applies specific CSS styles to highlight added, removed, and changed text, while email notifications are wrapped in a monospace-safe HTML template to preserve layout in clients like Gmail. Service-specific handling has been added for Discord and Telegram, replacing broken HTML tags with native markdown (such as strikethrough and bold) to ensure diffs display correctly. Additionally, the 'Markdown' format has been renamed to 'Markdown to HTML' to clarify that it is converted for apprise before delivery.

changedetectionio/notification · high confidence

Refactored text/HTML/JSON diff processor with new filter capabilities and live preview

The text/HTML/JSON diff processor has been refactored to support a richer set of text filters, including new options to 'Trim whitespace', 'Remove duplicate lines', and 'Extract lines containing text'. The processor now correctly handles \text/\*\ non-HTML content by preserving original line breaks and auto-detecting attachments. A significant improvement is the addition of a live preview for filters in the UI, which allows users to see the output of their filter configurations in real-time, including accurate line-number mapping for ignored text even after extraction transformations. The processor also introduces better error handling for empty filter responses and fixes issues with UTF-8 handling in XPath selectors.

_changedetectionio/processors/text\_json\diff · high confidence

Removal of custom static CSS styles

The custom CSS file (backend/static/css/styles.css) has been deleted, removing specific styling rules for the body text color, link colors, and the content section layout. Users will no longer see these custom visual adjustments, and the interface will rely on inherited base styles or other remaining style sources.

backend/static · high confidence

Removal of legacy Pure CSS layout and watch overview template

The \base.html\ layout template and \watch-overview.html\ page template have been deleted from the backend. This removes the previous implementation that relied on the Pure CSS framework for the navigation menu and the watch management interface, indicating a shift away from this specific UI structure in favor of a new design or templating approach.

backend/templates · high confidence

Restructured settings UI with dedicated notification and AI/LLM tabs

The settings interface has been reorganized into distinct tabs, including a new 'AI / LLM' section for configuring providers and a dedicated 'Notifications' tab for managing Apprise-based alerts. Users can now configure AI change detection features, such as intent filtering and summaries, via a guided UI with provider selection and model management. The notification settings have been extracted into their own blueprint, allowing for cleaner configuration of global notification URLs and formats. Additionally, the UI includes a PWA install option for mobile devices and various other settings refinements. Also in this area: 7 commits (0 fixes) modifying changedetectionio; 7 commits (1 fix) modifying changedetectionio.

changedetectionio/blueprint/settings/notifications, changedetectionio/blueprint/settings/templates · medium confidence · unverified

Updated Simplified Chinese translations for the web interface

The Simplified Chinese (zh) translation file has been updated and recompiled, providing improved and consistent UI copy for users. This change includes fixes for duplicate entries and ensures that new interface strings, such as those for the 'Add watch' flow, backup management, and browser configuration, are properly translated.

changedetectionio/translations/zh · high confidence

Watch list row rendering extracted for real-time updates

The watch list row template has been extracted into a separate file (\watch-overview-single-row.html\) to allow the same markup to be re-rendered and pushed over Socket.IO for real-time row resynchronization, ensuring the client-side row never drifts from the server-rendered list.

changedetectionio/blueprint/watchlist/templates · high confidence

Watchlist filtering and row rendering refactored for consistency and real-time updates

The watchlist view now uses a shared, centralized filtering logic (in \filters.py\) that serves as the single source of truth for both the main watch table and bulk actions, ensuring that filtered views and actions always operate on the same set of watches. Additionally, the rendering context for individual watch rows has been extracted into \row\_context.py\ to guarantee that rows updated via real-time WebSocket pushes remain visually consistent with the server-rendered page, preventing drift in column counts or data display.

changedetectionio/blueprint/watchlist · high confidence

Test coverage

Added SMTP notification tests with a dedicated test server; Added test coverage for LLM evaluation, prompt building, and response parsing; Added tests for Apprise notification plugin assets and custom API handlers; Added tests for SOCKS5 proxy configuration and validation; Added tests for Visual Selector and Browser Steps functionality; Added tests for browser fetcher content retrieval, custom JS execution, and interstitial redirect handling; Added tests for custom browser URL configuration; Added tests for plugin system capabilities; Added tests for proxy configuration and selection; Added tests for restock detection and price change tracking; Expanded test coverage for access control, API validation, and UI browser selection; Expanded unit test coverage for core application logic.

Dependencies

Major dependency overhaul and build system modernization

The project has replaced its legacy, fragmented Python dependency files (backend/requirements.txt, backend/dev-docker/requirements.txt) with a unified, modern requirements.txt that upgrades core frameworks (Flask to 3.1, Selenium to 4.49, Apprise to 1.13.1) and introduces new capabilities like LLM support via litellm and PWA QR codes via segno. Concurrently, the build tooling has been updated to use Node.js 18+ with SASS for CSS processing and Redocly for API documentation generation, while development workflows now utilize Ruff, pre-commit, and Dennis for linting and formatting.

(dependencies) · high confidence

Housekeeping

German translation file updated; Updated British and American English translation files; Updated Czech, Italian, and Ukrainian translation catalogs.

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

This is the PUBLIC form of this artifact. Findings are listed in full, but the details of SECURITY findings — which rule fired, in which file, on which line, and how to fix it — are deliberately withheld, and any secret-scanner results are excluded entirely. Where detail is absent here it was REMOVED FOR PUBLICATION; it is not missing from the analysis. The complete artifact is available from the repository owner.

Score

  • CAI 43 → 43 (-0.1)
  • Rubric changed (rubric-2026.11.1 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 52 → 50 (-1.2)
  • Architecture 90 → 98 (+8.2)
  • Maturity 69 → 69 (-0.0)
  • Readiness 32 → 32 (-0.5)
  • Security 69 → 63 (-5.9)
  • Accessibility 38 → 41 (+2.3)
  • Performance 100 → 100 (+0.0)

Resolved (26)

  • Duplicated block (10 lines × 2) (changedetectionio/content_fetchers/playwright.py)
  • Duplicated block (12 lines × 2) (changedetectionio/blueprint/ui/init.py)
  • Duplicated block (14 lines × 2) (changedetectionio/blueprint/backups/restore.py)
  • Duplicated block (16 lines × 2) (changedetectionio/store/file_saving_datastore.py)
  • Duplicated block (24 lines × 2) (changedetectionio/store/file_saving_datastore.py)
  • Duplicated block (6 lines × 2) (changedetectionio/blueprint/ui/notification.py)
  • Duplicated block (6 lines × 2) (changedetectionio/content_fetchers/puppeteer.py)
  • Duplicated block (6 lines × 3) (changedetectionio/blueprint/ui/init.py)
  • Duplicated block (6 lines × 3) (changedetectionio/content_fetchers/playwright.py)
  • Hotspot: changedetectionio/processors/magic.py (changedetectionio/processors/magic.py)
  • Low: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • Medium: security finding (details withheld)
  • No ADRs found
  • Projects may be oversized for their cohesion
  • Secret: generic-api-key (changedetectionio/api/Search.py)
  • …and 6 more

New (69)

  • Edited copies of one member (3 members, 13+ corresponding lines) (changedetectionio/queue_handlers.py)
  • Edited copies of one member (3 members, 14+ corresponding lines) (changedetectionio/custom_queue.py)
  • Edited copy of a member (10 corresponding lines) (changedetectionio/flask_app.py)
  • Edited copy of a member (10 corresponding lines) (changedetectionio/queue_handlers.py)
  • Edited copy of a member (135 corresponding lines) (changedetectionio/content_fetchers/playwright.py)
  • Edited copy of a member (14 corresponding lines) (changedetectionio/llm/evaluator.py)
  • Edited copy of a member (15 corresponding lines) (changedetectionio/llm/prompt_builder.py)
  • Edited copy of a member (15 corresponding lines) (changedetectionio/notification_service.py)
  • Edited copy of a member (16 corresponding lines) (changedetectionio/queue_handlers.py)
  • Edited copy of a member (19 corresponding lines) (changedetectionio/worker_pool.py)
  • Edited copy of a member (26 corresponding lines) (changedetectionio/store/init.py)
  • Edited copy of a member (41 corresponding lines) (changedetectionio/custom_queue.py)
  • Edited copy of a member (45 corresponding lines) (changedetectionio/notification_service.py)
  • Edited copy of a member (58 corresponding lines) (changedetectionio/custom_queue.py)
  • Edited copy of a member (6 corresponding lines) (changedetectionio/blueprint/watchlist/filters.py)
  • Edited copy of a member (6 corresponding lines) (changedetectionio/custom_queue.py)
  • Edited copy of a member (66 corresponding lines) (changedetectionio/store/file_saving_datastore.py)
  • Edited copy of a member (7 corresponding lines) (changedetectionio/browser_steps/browser_steps.py)
  • Edited copy of a member (7 corresponding lines) (changedetectionio/content_fetchers/exceptions/init.py)
  • Edited copy of a member (7 corresponding lines) (changedetectionio/rss_tools.py)
  • …and 49 more

Changes since last survey

  • 72 commits — 70 feature/other, 2 fixes

By area

  • (root) — 16 commits
  • changedetectionio/translations — 16 commits
  • changedetectionio/blueprint — 10 commits
  • changedetectionio/tests — 7 commits
  • .github/workflows — 3 commits
  • changedetectionio/init.py — 3 commits
  • (repo) — 2 commits
  • changedetectionio/content_fetchers — 2 commits
  • changedetectionio/llm — 2 commits
  • changedetectionio/notification — 2 commits
  • changedetectionio/processors — 2 commits
  • changedetectionio/static — 2 commits
  • changedetectionio/api — 1 commit
  • changedetectionio/model — 1 commit
  • changedetectionio/templates — 1 commit
  • changedetectionio/worker.py — 1 commit
  • docs/THIRD-PARTY-LICENSES.md — 1 commit

Notable commits

  • fix: Fix races behind flaky tests: favicon cache, a new monitor queued twice, first checks before the page or config is ready, queue tests and the worker health check (#4681)
  • fix: fix: keep jinja2 blocks intact when splitting tags from imported URLs (#1516) (#4259)
  • change: 0.70.1
  • change: 0.70.2
  • change: 0.70.3
  • change: AI settings - saving no longer switches off checkboxes the page didn't show (#4682) (#4683)
  • change: API - Watch list and search show each watch's paused and notification_muted (#4685) (#4686)
  • change: Add ja translations for Restock & Price Detection help text (#4694)
  • change: Apprise notifications 2.2.0 - Update requirements.txt
  • change: Bump docker/login-action from 4.7.0 to 4.8.0 in the all group (#4723)
  • change: CI - Test server name should not depend on external DNS (#4729)
  • change: CI - Third-party licence list: regenerate weekly and on release, drift is only a warning on PRs (#4684)
  • change: Clear history - don't fail when a save renames its .tmp file away mid-clear (#4674)
  • change: Fetchers - Optional HAR network recording per watch via HAR_UUID_RECORD (#4539) (#4732)
  • change: LLM - Don't log a misleading SSRF "refused" warning when classifying a local LLM endpoint (#4700) (#4708)
  • change: LLM - Empty or unparsable intent evaluation passes the change through instead of suppressing it (#4661)
  • change: LLM - Thinking budget "Off" also switches thinking off for Claude Haiku/Sonnet 5.x (#4658)
  • change: Logs - Keep notification URL passwords and the browser token out of the log output (#4741)
  • change: MCP - "Allow read-only access without sign-in" setting, for public demos (#4680)
  • change: MCP - "MCP Note" settings sub-tab, set what assistants are told when they connect (#4670)
  • …and 52 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

dgtlmoon/changedetection.io was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 16 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit fdce08421c010b33f541a45dd89b5d10cebc124e — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.73+preprod-52de90b74216.