Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

Visual Regression Tracker

github.com

  • Free plan
  • Windows
  • macOS
  • Linux
  • Web
  • iPhone and iPad
  • Android
  • API
  • Self-hosted
7.9 Club score Visit github.com

What Visual Regression Tracker is

Visual Regression Tracker is an open-source, self-hosted application for detecting unexpected visual changes. It compares submitted screenshots with accepted baseline images and keeps baseline history over time. Teams can exclude image regions that should not affect a comparison, and choose Pixelmatch, Looks-Same, Odiff, or a VLM comparison provider for each project. A standalone JAR also compares PDFs and images from a folder. The dashboard provides side-by-side, diff, scrubber, and onion-skin views, with one-click approval. Feature branches inherit the main branch baseline until a change is approved, while builds can post commit status to GitHub or GitLab. Docker images are used for setup, and the project says self-hosting keeps data inside the user’s intranet. Integrations include agents for Playwright, Cypress, CodeceptJS, and Robot Framework, SDKs for JavaScript, Java, Python, and .NET, and a REST API for other languages. Screenshot uploads are limited to 20 MB.

Who it suits

It suits teams running visual checks for web, mobile, or desktop interfaces wherever screenshots can be captured. Self-hosting and the listed CI/CD integrations fit development teams managing their own infrastructure.

Good to know, and what to watch

  • Open-source Apache-2.0 project
  • Supports multiple comparison methods
  • Includes approval and branch-baseline workflows
  • Integrates with major test frameworks and SDKs
  • Keeps self-hosted data inside the intranet
  • Screenshot upload payloads max out at 20 MB
  • Setup uses Docker images
  • Each project has one owner
  • Optional Elasticsearch logging uses extra resources

The verdict

Visual Regression Tracker covers image comparison, review, approvals, and CI status in a self-hosted package. Its 20 MB upload ceiling and owner-based access model should be considered during setup.

What the maker publishes

Access control
The project documentation says each project has one owner, and members can view snapshots and approve changes while owner-only actions are restricted. source
API
The README says REST API interfaces allow use from programming languages beyond the listed SDKs. source
Baseline history
The project tracks baseline history and lets users ignore image regions that should not affect comparisons. source
Baseline history
The tool tracks how baseline images change over time and supports ignoring selected image regions. source
Branch baselines
The documentation says feature branches inherit the main branch baseline until a change is approved. source
Comparison methods
The README lists Pixelmatch, Looks-Same, Odiff, and a VLM comparison provider, configurable per project. source
Comparison methods
Available comparison providers include Pixelmatch, Looks-Same, Odiff, and a vision-language-model option, configurable per project. source
Data location
The project describes its self-hosted deployment as keeping data inside the user's intranet. source
Deployment
The GitHub project describes itself as open source and self hosted, with setup using Docker images. source
Deployment
Setup uses Docker images, and Docker must be installed on the host machine. source
Framework integrations
The repository lists native agents for Playwright, Cypress, CodeceptJS, and Robot Framework. source
Framework support
The README lists agents for Playwright, Cypress, CodeceptJS, and Robot Framework, plus SDKs for JavaScript, Java, Python, and .NET. source
How it works
It compares submitted images pixel by pixel against accepted baseline images and reports unexpected changes. source
License
The GitHub repository identifies its license as Apache-2.0. source
Logging
Optional Elasticsearch logging can be monitored through Kibana and uses additional memory and CPU. source
PDF comparison
A standalone JAR can compare PDF files and images from a folder. source
Platform coverage
It supports visual testing for web, mobile, and desktop wherever a screenshot can be captured. source
Pull request gating
The documentation says builds can post commit status to GitHub or GitLab. source
Purpose
Visual Regression Tracker compares uploaded screenshots with accepted baselines to identify visual changes. source
Purpose
Visual Regression Tracker is an open-source, self-hosted tool for visual testing and managing test results. source
Review workflow
The dashboard supports side-by-side, diff, scrubber, and onion-skin comparisons, with one-click approval. source
SDKs and API
It provides JavaScript, Java, Python, and .NET SDKs, plus a REST API for other languages. source
Support and community
The README directs users to a Telegram group and invites bug reports, questions, ideas, and feedback through tickets. source
Supported image inputs
The README says it can compare PDFs as well as images using a standalone jar. source

Checked against the maker's pages on 9 Oct 2026.