Run tests, capture screenshots, record videos, and collect browser logs right next to the website you're testing. Keep all your testing work in Chrome without switching tabs.
- Run manual tests – Follow test steps and mark results.
- Capture screenshots – Take, annotate, crop, and blur screenshots.
- Record your screen – Capture browser activity and attach video recordings.
- Capture browser logs – Collect console errors, warnings, and network requests.
- Create test cases – Write new tests in Markdown and add parameters.
- Record test steps – Turn your actions on a website into test steps automatically.
- Open Testomat.io in the Chrome Web Store and click Add to Chrome, then Add extension.
- Click the puzzle icon in Chrome's toolbar and pin Testomat.io.
- Click the pinned icon — the panel opens and asks you to connect.
Chrome 123 or newer. Chrome updates the extension by itself. Details and pictures, and how to run it from source: Install and update.
- Connect. Press Open Testomat.io & authorize, paste the token it gives you, press Connect, pick your project. → Connect
- Open a run. Runs tab → click a run → click a test.
- Mark it. Tick the steps, press Passed, Failed or Skipped
(with a comment), then the › arrow in the test's pager (or
Nfor the next untested test). Nothing navigates on its own. → Run a manual run - Attach evidence. In the test's Attachments fold: Attach screenshot opens an annotator over the page, Attach screen recording records the tab; with Rec on, marking a test Failed attaches its console & network log by itself.
| Page | Covers |
|---|---|
| Install and update | Add from the Chrome Web Store, pin the icon, updates, install from source |
| Connect | Authorize, pick a project, self-hosted instances, basic mode |
| Run a manual run | Runs, steps, statuses, comments, hotkeys, finish, working offline |
| Attach a screenshot | Capture the tab, annotate over the page, full-page shots |
| Attach a screen recording | Record the tab, review and trim, attach |
| Console & network log | Rec: the log that lands on a failed result |
| Create tests | Add by title, write in the editor, parameters |
| Step recorder | Do the flow once, the test writes itself; polish with AI |
| Settings and shortcuts | Every setting with its default, sign out, keyboard shortcuts |
The extension uploads only to your own Testomat.io instance. What is stored, what is sent and when — including where Polish with AI goes after that — every permission and why it is needed, and every off switch: PRIVACY.md.
Bugs and feature requests go to this repository's Issues. A useful report says what you clicked, what happened (with the exact wording of any message), your Chrome version, and whether the Basic mode pill was showing. Please leave out API tokens and run URLs you would rather keep private.
docs/architecture.md— module map, data flows, the permission model, storage keys, known traps.docs/host-handoff.md— signing the panel in from an app that launched the browser (handoff.json).
There is no build step: extension/ runs exactly as it is checked in. The
end-to-end suite lives outside this tree and drives a live Testomat.io
account, so pull requests are verified by maintainers by hand; a few test
seams in the shipped code look unused from here — see architecture §5.3
and leave them alone.
MIT — see LICENSE. Vendored under extension/vendor/ with their
own licence files: showdown (MIT) and
OverType (MIT); icon paths from
Material Symbols (Apache-2.0); JetBrains
Mono and Fira Mono under the SIL Open Font License (extension/shared/fonts/OFL.txt
and OFL-FiraMono.txt).
