Skip to content

README.md

Latest commit

 

History

History
106 lines (71 loc) · 3.54 KB

README.md

File metadata and controls

106 lines (71 loc) · 3.54 KB
Raw

Breeze

Stop clicking "OK" after Windows Hello recognizes you.

CI Crates.io License

English | 한국어

Windows Hello face recognition works great — except it still asks you to click "OK" every single time. That extra click is just noise.

Breeze removes it. It monitors Windows Hello credential dialogs, detects successful face recognition, and auto-confirms — silently, as a Windows Service.

How It Works

Windows Hello recognizes your face
        ↓
Credential dialog appears with "OK" button
        ↓
Breeze detects it via UI Automation API
        ↓
Confirms automatically (only for face recognition, not PIN)
        ↓
You're in. Zero clicks.

Install

cargo install breeze-wh
breeze-wh install

That's it. Breeze runs silently in the background.

Upgrade

breeze-wh upgrade

Fetches the latest breeze-wh.exe from GitHub Releases and swaps it in place. The old exe is kept as breeze-wh.exe.old and removed on the next reboot (Windows won't let a running exe delete itself).

Service state is preserved across the upgrade:

  • Running → stopped, exe replaced, started again
  • Stopped → exe replaced only
  • Not installed → exe replaced only

Note: upgrade pulls from GitHub Releases, not crates.io. After an upgrade, cargo install --list will still show the older version — breeze-wh --version reports what's actually on disk.

Commands

  • breeze-wh install — Install and start the service
  • breeze-wh uninstall — Stop and unregister the service
  • breeze-wh start — Start the service
  • breeze-wh stop — Stop the service
  • breeze-wh status — Show current service state
  • breeze-wh upgrade — Upgrade to the latest release (see above)
  • breeze-wh --version — Print the installed version

install / uninstall / start / stop / upgrade all need admin rights — they auto-request elevation via UAC, you don't need to launch an elevated shell yourself.

How It's Built

Breeze is a single binary that runs in two modes:

  • Service mode — Runs in Session 0 as a Windows Service. Detects user logon/logoff and spawns the helper in the user's desktop session. Automatically restarts it on crash with exponential backoff.

  • Helper mode — Runs in the user session with elevated privileges. Subscribes to UI Automation focus events to detect Credential Dialog Xaml Host windows. On detection, scans the UI tree in a single pass:

    • PasswordField present → PIN mode → skip
    • OkButton present without PasswordField → face recognition → click
    • OkButton not yet visible → watch StructureChanged events until it appears

All detection uses language-independent AutomationId and ClassName properties, so it works regardless of your Windows display language.

Configuration

Config file: C:\ProgramData\Breeze-WH\config.toml (created on install)

enabled = true
debounce_ms = 2000
log_level = "info"
log_max_files = 7

Logs: C:\ProgramData\Breeze-WH\logs\

Requirements

  • Windows 10 / 11
  • Windows Hello face recognition configured
  • Rust toolchain (to install via cargo)

License

MIT OR Apache-2.0