Skip to content

Platform validation matrix

This page answers a narrower question than platform support. Support says what is published and installable. This page says what a person has actually run on a real machine, with the evidence, and where nobody has.

  • Evidence was read from the public issues, merged pull requests and CI runs listed in the evidence log on 2026-10-16 (one row, Windows arm64, corrected on 2026-10-20 from E23). Nothing here is inferred from how the code looks. If a cell has no entry in the log, it says UNVERIFIED.
  • The latest release at that date is v2.42.0. Hardware evidence is for the version named in each entry, and a later release does not inherit it.
  • The words and the rules for what counts are in the evidence standard. The Mac-specific plan is the macOS validation campaign.

The project maintainer has no Mac and no Windows machine, and CI cannot answer a permission prompt or hear a microphone. Every hardware cell below exists because a volunteer ran the check.

Reading a cell

Word Meaning
Verified (HW) A named human, a real device, the exact version, with output.
Failed (HW) The same, and it did not work. Kept until a positive record replaces it.
CI only An automated job passed; no person has tried it.
Reported Someone says so, but the record is missing a field (usually the OS build or the raw doctor output). The Gap column names it.
Blocked Cannot be tried until a named issue is resolved.
UNVERIFIED Nobody has tried it.

E<n> points to a row in the evidence log. A cell's version is the YazSes version that was tested.

macOS

Apple silicon and Intel are separate rows: they ship separate .dmg files.

Setup Install First launch Permissions Capture + transcription Text injection Start / restart / stop Update path Last human validation Gap / next tester
Apple silicon, .dmg Verified (HW) E2 E3. 2.37.2 and 2.40.0: drag to Applications works; the unsigned-app prompt appears as documented. Verified (HW) E3. 2.40.0: opens after the "Open Anyway" step in System Settings; menu-bar icon appears. Failed (HW) E3. 2.40.0: Accessibility and Input Monitoring both switched on, yet doctor and the daemon log say denied; unchanged after tccutil reset. Cause unknown (#562). Verified (HW) E1. 2.29.0, 2026-08-21: verify captured, passed the silence gate and transcribed a test phrase. Not repeated on a later release. Blocked E3. The hotkey never fires on 2.40.0 (#562), and nobody has run yazses verify --type, which reaches the injector without the key. No report has seen typed text on a Mac. Failed (HW) E3. 2.40.0: doctor said "Daemon: not running" while one ran; an old daemon outlived days and a relaunch exited as a duplicate. Whether Quit was used is unknown (#578). UNVERIFIED 2026-10-05 (E3) Needs a Mac on v2.43.0 or later, the first to carry the #562 doctor fix. The first-run permission-prompt fix (#562, #578) is on main and not yet released. Run the reporter script.
Apple silicon, Homebrew cask Reported E4 E5. The cask installs once brew trust MSKazemi/yazses is run. Both runs used a stale 2.18.2 tap, not today's. Reported E4. 2.18.2 tap: the app did not stay running and showed no icon. Predates the fixes; not the behaviour of a current build. Reported E4. 2.18.2 tap: no prompt appeared. Same caveat. UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED 2026-08-28 (E4, stale tap) Anyone on today's cask: brew trust MSKazemi/yazses, install, then the reporter script.
Apple silicon, pipx UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none The permission goes to the terminal app, not to a bundle. #182 and #216 both ask; nobody has walked it.
Intel, .dmg CI only E21. The x86_64 .dmg builds and its contents are verified on an Intel runner (v2.42.0). CI only E21. The bundle's --cli --version and doctor run on that runner; a GUI launch is not exercised. UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none An Intel Mac with the x86_64 .dmg. #216 still tells testers the .dmg will not work; that text is out of date.
Intel, pipx UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none An Intel Mac. This route outlives GitHub's Intel runners (see platform support).

Windows

Setup Install First launch Permissions Capture + transcription Text injection Start / restart / stop Update path Last human validation Gap / next tester
Windows 11 x64, pipx or install script Reported E10 E12. 2.36.0: install script (E10) and pipx (E12). Reported E10 E11. 2.36.0: daemon starts; doctor clean apart from an autostart warning. UNVERIFIED Reported E10 E11. Two independent reports, 2.36.0, built-in laptop microphone, base.en, CPU int8. Reported E10 E11. Browser, VS Code, PowerShell, Notepad, terminal. Failed (HW) E12 E13. 2.36.0: start printed a traceback though the daemon came up; restart crashed. Both fixed in ece081f. On that commit the hotkey set in config was not applied after restart, and a blank console window stayed open. No later hardware result is posted (#330 was closed on 2026-10-21 after the fixes landed; there is no newer hardware record). UNVERIFIED 2026-09-30 (E13) Re-run the #330 checklist on v2.41.0 or later. Reports E10 and E11 lack the OS build and the raw doctor text. Nobody has said whether a privacy prompt appeared.
Windows 11 x64, Scoop Reported E12. 2.36.0. UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED Failed (HW) E12. 2.36.0: same start and restart failures as above, reproduced on this route too. UNVERIFIED 2026-09-08 (E12) The Scoop bucket is still open work (#79). Needs a full run, not only lifecycle.
Windows 11 x64, .exe installer CI only E22. Silent install, payload present, yazses-cli --version and doctor run, PATH entry added and removed (v2.42.0). CI only E22. The CLI runs; the windowed app is not launched. UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none No human report names this route.
Windows 11 arm64, .exe installer CI only E22 E23. The windows-arm64 leg passed the same install, run and uninstall checks on v2.42.0, but that file was an x64 build; from v2.43.1 there is no arm64 installer and ARM PCs run the x64 one (E23). CI only E22 UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none A Windows-on-ARM device running the x64 installer. A runner has no microphone and no hold-to-talk key.
Windows 10 x64, any route UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none #217. The one volunteer asked has no Windows 10 machine (E40).

Linux

Setup Install First launch Permissions Capture + transcription Text injection Start / restart / stop Update path Last human validation Gap / next tester
Ubuntu 24.04, GNOME Wayland UNVERIFIED UNVERIFIED UNVERIFIED Reported E30. Dell Inspiron built-in microphone with PipeWire 1.0.5: clean capture at the default vad_threshold. Version and install route not stated. UNVERIFIED UNVERIFIED UNVERIFIED 2026-09-10 (E30, merge date) #206 has no report. Wayland injection is the open question.
Ubuntu 24.04, GNOME X11 UNVERIFIED UNVERIFIED UNVERIFIED Reported E31 E32. Built-in and external microphones. No version stated. Reported E31 E32. VS Code, Bash, gedit (E31); terminal, VS Code, commit messages (E32). UNVERIFIED UNVERIFIED 2026-09-30 (E31) E32 is the maintainer's own machine, so treat it as the least independent entry here. #207 is still open.
Any other distro or desktop UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED UNVERIFIED none The open slots: #171, #172, #180, #181, #208 to #215. None has a comment.

Not shown because there is no hardware evidence to put in a row: FreeBSD and the other BSDs (see platform support), and the snap, Flatpak, apt and Nix routes on any desktop. Those are published, which is a statement about availability and not about validation.

What CI covers

CI is a floor, and the cells above that say CI only rest on it.

  • E20. The test suite passes on Linux, macOS and Windows runners, and on Linux arm64, at the commit this page was written against. The suite mocks audio and the speech model (AGENTS.md), so it cannot show that anything was heard.
  • E21, E22. The release builds produce the macOS and Windows installers and exercise the built bundle (version, doctor, install and uninstall on Windows). They do not launch the windowed app.
  • What no runner can prove. The header of macos-smoke.yml states it: Accessibility, Input Monitoring and Microphone prompts, Gatekeeper, real dictation and the menu-bar icon need a GUI session and a human.

Evidence log

Dates are the date of the report. Handles are public GitHub handles from the linked thread.

ID Source Tester Date Setup and version
E1 #182, attachment comment, result quoted by the maintainer @happytester-funbugs 2026-08-21 Apple M2, macOS 26.6.2, .dmg, v2.29.0 (the latest then)
E2 #182 comment @happytester-funbugs 2026-09-23 Mac mini, Apple M2, macOS 26.6.2, .dmg arm64, v2.37.2
E3 #562 and its comments @happytester-funbugs 2026-10-01 to 2026-10-05 Mac mini, Apple M2, macOS 26.6.2, .dmg arm64, fresh install, v2.40.0
E4 PR #318 (merged 2026-08-28), SHOWCASE.md entry @hoti-code 2026-08-28 Apple M5, macOS 26.5.1, Homebrew cask, tap then at 2.18.2
E5 #182 comment @slegarraga 2026-08-21 Apple M4, macOS 26.6, Homebrew cask, 2.18.2. Stopped before the permission prompts
E10 #183 comment @visheshbpatel 2026-09-03 Windows 11 (build not stated), install script, v2.36.0
E11 PR #328 (merged 2026-09-03) @fall-water-zxc 2026-09-03 Windows 11 Home, built-in microphone, v2.36.0
E12 #330 @fall-water-zxc 2026-09-08 Windows 11 Home, Scoop and pipx, v2.36.0
E13 #330 comment 09-15, 09-22, 09-30 @fall-water-zxc 2026-09-15 to 2026-09-30 Windows 11 Home, pipx environment at commit ece081f
E20 test.yml run 38796431889 CI 2026-10-15 Commit 6edac14c: ubuntu, macos-latest, windows-latest, ubuntu-24.04-arm
E21 build-macos.yml run 37237196913 CI 2026-10-04 Tag v2.42.0, macos-arm64 and macos-x86_64 legs
E22 build-windows.yml run 37237196915 CI 2026-10-04 Tag v2.42.0, windows-x64 and windows-arm64 legs
E23 v2.43.1 release notes maintainer 2026-10-17 Windows arm64 installer dropped: the asset had been an x64 build (added 2026-10-20)
E30 PR #333 (merged 2026-09-10) @Akgithub2028 2026-09-10 Ubuntu 24.04 LTS, GNOME Wayland, PipeWire 1.0.5, Dell Inspiron 15 3520
E31 PR #546 (merged 2026-09-30), SHOWCASE.md entry @AmothissacrajT 2026-09-30 Ubuntu 24.04.5, X11, Razer HyperClear and built-in microphones
E32 SHOWCASE.md entry, commit b6e61dab @MSKazemi (maintainer) 2026-08-01 Ubuntu, GNOME X11, built-in microphone. No version stated
E40 #217 comment @visheshbpatel 2026-10-01 Declined: no Windows 10 machine

Further Windows 11 entries exist in SHOWCASE.md (#317, #391, #547). They state an operating system and a microphone but no version or build, so they are not counted as evidence in any cell above.

Keeping this page honest

  • A maintainer adds a row to the log when a report arrives, and changes only the cells that report covers. A report that fills in more of the evidence record upgrades a cell from Reported to Verified (HW).
  • A Failed (HW) cell is replaced only by a newer hardware record, never by a merged fix.
  • tests/test_validation_matrix.py fails the build when a cell uses a word outside the table above, claims evidence without an E<n> that exists in the log, or when the log holds a row without a link.