DockPeek is a macOS menu-bar app that shows live window previews when you hover over Dock icons, mimicking the Windows taskbar preview behavior.

Stars

6

7-day growth

No data

Forks

1

Open issues

2

License

AGPL-3.0

Last updated

2026-07-30

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It achieves this without injecting into the Dock or disabling System Integrity Protection, relying solely on Accessibility and ScreenCaptureKit APIs, and is fully notarized for easy installation.

Who it is for

  • macOS users who miss Windows taskbar previews
  • Power users managing multiple open windows
  • Developers interested in macOS API usage (Accessibility, ScreenCaptureKit)
  • Users with accessibility needs (VoiceOver support, Reduce Motion)

Use cases

  • Quickly preview a window without switching apps
  • Identify which app window contains the needed content
  • Efficient window management on crowded desktops
  • Accessible interaction for users relying on VoiceOver

Strengths

  • No Dock injection or SIP modifications required
  • Apple-notarized and signed, no Gatekeeper warnings
  • Configurable hover delay, thumbnail size, and per-app exclusions
  • Respects system accessibility settings (Reduce Motion, Reduce Transparency)

Considerations

  • Requires macOS 14 or later (Apple Silicon or Intel)
  • One-time grant of Accessibility and Screen Recording permissions
  • Previews only capture window images via ScreenCaptureKit (no video or interaction within preview)

README quick start

DockPeek — dock-preview.app

Hover any running app in the macOS Dock and get a live preview of its windows — the way the Windows taskbar does it. Runs as a quiet menu-bar app; no Dock injection, no disabling SIP, no system-wide hacks.

Install

  1. Download the latest .dmg from the Releases page.
  2. Open it and drag dock-preview to Applications.
  3. Launch it — the app is signed and notarized by Apple, so it opens with no Gatekeeper warning.
  4. Grant Accessibility and Screen Recording in the onboarding window, then click Relaunch.

Prefer to build it yourself? See Build & run.

How it works

PieceAPI
Detect which Dock icon the cursor is overAccessibility (AXUIElementCopyElementAtPosition, AXDockItem)
Resolve the icon to a running appDock item AXURL → bundle id → NSRunningApplication
Capture window thumbnailsScreenCaptureKit (SCScreenshotManager.captureImage)
Show the previewBorderless non-activating NSPanel above the icon

It never injects into com.apple.dock. It only observes via the Accessibility API and reads window images via ScreenCaptureKit — both gated behind one-time, per-app macOS permissions.

Permissions (granted once)

  1. Accessibility — to read which Dock icon the cursor is over and its frame.
  2. Screen Recording — to capture the window images shown in the preview.

Nothing is recorded, saved, or sent anywhere; images live only in memory to draw the thumbnail. A friendly onboarding window walks you through both, with a Relaunch button because Screen Recording only re-evaluates on launch.

Build & run

./build.sh            # compiles + assembles dock-preview.app + ad-hoc signs it
open ./dock-preview.app

Then grant the two permissions in the onboarding window. dock-preview.app lands in the project root and launches on double-click.

Regenerate the icon after editing tools/make_icon.swift:

swift tools/make_icon.swift && ./build.sh

Package for distribution

./package.sh          # → dist/dock-preview-.zip and .dmg (ad-hoc

Description

Just the Accessibility API to find the icon you're hovering + ScreenCaptureKit for live thumbnails. Two one-time permissions, then it runs quietly in the menu bar.

Related repositories

Similar projects matched by category, topics, and programming language.

Blaizzy
Featured
Blaizzy GitHub avatar

nativ

Nativ is a native macOS app that lets you run AI models locally on Apple silicon, offering chat, model management, performance analytics, and an OpenAI/Anthropic-compatible API server.

AI & Machine LearningAI Vision & Audio
985
uzairansaruzi
Featured
uzairansaruzi GitHub avatar

hermex

Hermex is a native SwiftUI iPhone app that lets you control a self-hosted Hermes AI agent directly from your phone, with no subscriptions, tracking, or third-party relay.

AI & Machine LearningLarge Language Models
941
simonw
Featured
simonw GitHub avatar

speech-analyzer-cli

A macOS command-line tool that uses Apple's on-device speech APIs to transcribe prerecorded audio into plain text, JSON, JSONL, SRT, or WebVTT.

Developer ToolsCLI & Terminal
20