- Home
- Visual Regression Testing Software
- Visual Regression Tracker
Visual Regression Tracker
What it is
Visual Regression Tracker compares submitted screenshots with accepted images to flag visual changes across web, mobile, and desktop projects wherever a screenshot can be captured. It is open source and self-hosted, with Docker images for setup and data kept inside the user’s intranet. Projects can retain baseline history, exclude regions from comparisons, and select Pixelmatch, Looks-Same, Odiff, or a VLM comparison provider. A review dashboard provides side-by-side, diff, scrubber, and onion-skin views, with one-click approval. Feature branches use the main branch baseline until a change is approved, and builds can report commit status to GitHub or GitLab. Integrations include agents for Playwright, Cypress, CodeceptJS, and Robot Framework, SDKs for JavaScript, Java, Python, and .NET, and a REST API for other languages. A standalone JAR handles PDFs as well as images. The documented maximum screenshot upload payload is 20 MB. Each project has one owner; members can view snapshots and approve changes, while some actions are owner-only. The project is free and licensed under Apache-2.0.
For and against
For
- Free and open source under Apache-2.0
- Supports four comparison methods
- Offers review views and one-click approval
- Integrates with GitHub and GitLab build status
- Includes SDKs and a REST API
Against
- Maximum screenshot upload payload is 20 MB
- Each project has one owner
- Some actions are restricted to the owner
The verdict
Visual Regression Tracker brings baseline comparison, review, and approval into a self-hosted workflow. Check its upload limit and owner-only controls against your project’s needs.
Who it suits
It suits teams that need screenshot-based visual checks in web, mobile, or desktop workflows and want to host the service themselves. It may also suit developers looking for framework agents, SDKs, or a REST API.
On the record
- 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.docs.vregt.com · read 4 Oct 2026
- API
- The README says REST API interfaces allow use from programming languages beyond the listed SDKs.github.com · read 4 Oct 2026
- Baseline history
- The tool tracks how baseline images change over time and supports ignoring selected image regions.github.com · read 9 Oct 2026
- Branch baselines
- The documentation says feature branches inherit the main branch baseline until a change is approved.docs.vregt.com · read 4 Oct 2026
- Comparison methods
- Available comparison providers include Pixelmatch, Looks-Same, Odiff, and a vision-language-model option, configurable per project.github.com · read 9 Oct 2026
- Data location
- The project describes its self-hosted deployment as keeping data inside the user's intranet.github.com · read 9 Oct 2026
- Deployment
- Setup uses Docker images, and Docker must be installed on the host machine.github.com · read 9 Oct 2026
- Framework integrations
- The repository lists native agents for Playwright, Cypress, CodeceptJS, and Robot Framework.github.com · read 9 Oct 2026
- Framework support
- The README lists agents for Playwright, Cypress, CodeceptJS, and Robot Framework, plus SDKs for JavaScript, Java, Python, and .NET.github.com · read 4 Oct 2026
- How it works
- It compares submitted images pixel by pixel against accepted baseline images and reports unexpected changes.github.com · read 9 Oct 2026
- License
- The GitHub repository identifies its license as Apache-2.0.github.com · read 9 Oct 2026
- Logging
- Optional Elasticsearch logging can be monitored through Kibana and uses additional memory and CPU.github.com · read 9 Oct 2026
- PDF comparison
- A standalone JAR can compare PDF files and images from a folder.github.com · read 9 Oct 2026
- Platform coverage
- It supports visual testing for web, mobile, and desktop wherever a screenshot can be captured.github.com · read 9 Oct 2026
- Pull request gating
- The documentation says builds can post commit status to GitHub or GitLab.docs.vregt.com · read 4 Oct 2026
- Purpose
- Visual Regression Tracker is an open-source, self-hosted tool for visual testing and managing test results.github.com · read 9 Oct 2026
- Review workflow
- The dashboard supports side-by-side, diff, scrubber, and onion-skin comparisons, with one-click approval.docs.vregt.com · read 4 Oct 2026
- SDKs and API
- It provides JavaScript, Java, Python, and .NET SDKs, plus a REST API for other languages.github.com · read 9 Oct 2026
