Visual Regression Tracker
github.com
- Free plan
- Windows
- macOS
- Linux
- Web
- iPhone and iPad
- Android
- API
- Self-hosted
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.