A macOS stealth browser overlay — a transparent, always-on-top web window that reveals on hover and vanishes the instant you need it gone.
Note
Status: v0.1.0 — implemented for macOS. The app builds and is unit-tested; build it yourself with npm run tauri build (see BUILD.md). The real-world stealth behaviors (screen-share hiding, global panic, click-through, concealment) are verified manually on your own Mac — see the checklists in BUILD.md and PLAN.md.
Peekaboo floats any web page as a transparent, resizable window that sits above whatever you're doing. In its default ghost state it's nearly invisible and clicks pass straight through to the app underneath. Move your cursor into its hot-zone and the content sharpens into view; press the global hotkey and it disappears instantly, without a trace.
The whole product fits in one line: "visible only when you want it, gone the instant you need it."
| Feature | What it does | |
|---|---|---|
| 👻 | Ghost overlay | Transparent, frameless, always-on-top window floating above everything else |
| 🫥 | Hover-reveal | Dim + click-through until your cursor enters the hot-zone, then it sharpens |
| 🚨 | Panic hotkey | One system-wide shortcut hides the window instantly — even when unfocused |
| 🙈 | App concealment | Hidden from the Dock, Cmd-Tab, and menu bar (Accessory app) |
| 🎚️ | Opacity control | Separate "idle" and "hover" opacity levels you tune yourself |
| 🖥️ | Screen-share hiding | Best-effort only — see the honest caveat below |
The images below are UI renders of Peekaboo's real interface, generated from its own HTML/CSS. To replace them with live screenshots, capture on macOS — first turn Screen-share hiding off in Settings, since content protection can exclude the window from screenshots on macOS ≤ 14.
1 · Float a page. Launch Peekaboo and it opens as a faint, always-on-top ghost overlay. At its idle opacity it's barely there, and clicks pass straight through to the app underneath.
2 · Reveal on hover. Move your cursor into the overlay's hot-zone and the content sharpens to full opacity so you can read it. Move away and it fades back to a ghost.
3 · Tune it. Click ☰ to open Settings — set the URL and bookmarks, the idle/hover opacity, window size, the 3×3 hot-zone, the panic hotkey, and the concealment toggles.
4 · Vanish. Press the panic hotkey (default ⌘⇧H) — or the ✕ button — and the window disappears instantly, even when another app is focused. Press it again to bring it back exactly where you left off.
A Tauri v2 app with a clear split: a Rust core owns all the stealth — window transparency, always-on-top, click-through, the global panic hotkey, cursor-polling for hover detection, and the reveal/panic state machine — while the WebView only renders the web content and the settings UI.
The hard part isn't the UI; it's macOS window control. Because the overlay is click-through, normal DOM/native hover events don't fire, so hover-reveal is driven by polling the global cursor position against a hot-zone rectangle.
Hiding from screen sharing via macOS content protection does not work on macOS 15 (Sequoia) and later. ScreenCaptureKit — used by Zoom, Meet, and QuickTime — captures the composited framebuffer and ignores the NSWindowSharingNone flag (Tauri #14200, no known workaround). It only helps on macOS ≤ 14 and against legacy screenshot APIs.
So screen-share hiding is treated as best-effort, and the real defense during a screen share is the panic hotkey — hide before or the moment you start sharing.
The full planning & design docs live in docs/ — a 6-page, dark-themed set with working SVG/HTML mockups:
- Overview — vision, threat→defense model, key decisions
- Feature spec — features by priority + verified Tauri APIs
- Screen design — visual mockups: 3-state desktop scenes, overlay anatomy, settings panel
- Architecture & behavior — process model, state machine, hover-detection design
- Tech stack & structure — config, capabilities, code skeletons, build
- Roadmap — phases, verification gates, risk register
The docs are HTML. Open them locally with
open docs/index.html, or enable GitHub Pages to browse online.
- Framework: Tauri v2 (Rust core + system WebView)
- Target: macOS only
- Frontend: TypeScript + Vite
- Key plugin:
global-shortcut(panic hotkey)
v0.1.0 — implemented. Phases 0–4 are done: scaffold → MVP (overlay + panic) → stealth core (hover-reveal) → concealment → settings, persistence & distribution. The automated gates (build, clippy, eslint, tsc, unit tests) pass; the real-world stealth behaviors are verified manually on your Mac. See the roadmap and PLAN.md.
Peekaboo's documentation is maintained in the languages below — the supported language set the in-app localization (i18n) builds on. Language codes follow BCP 47.
| Language | Code | README |
|---|---|---|
| English | en |
README.md |
| 한국어 (Korean) | ko |
README.ko.md |
| 日本語 (Japanese) | ja |
README.ja.md |
| 中文 (Simplified Chinese) | zh |
README.zh.md |
The in-app UI language can be changed in Settings (Auto / English / 한국어 / 日本語 / 中文); Auto follows your system locale. Chinese is Simplified only — Traditional (zh-Hant) falls back to Simplified.
A personal tool. Use responsibly. 🫣