PrajjwalDatir/dock-preview-mac

AI 仓库情报摘要

FR-AI / ANALYSIS

为什么值得关注

它无需注入 Dock 或禁用系统完整性保护，仅依赖 Accessibility 和 ScreenCaptureKit API，且已通过 Apple 公证，安装简便。

适合谁使用

怀念 Windows 任务栏预览的 macOS 用户
需要管理多个打开窗口的高级用户
对 macOS API（Accessibility、ScreenCaptureKit）感兴趣的开发者
依赖 VoiceOver 等辅助功能的用户

典型使用场景

无需切换应用即可快速预览窗口内容
辨别哪个应用窗口包含所需信息
在拥挤的桌面上高效管理窗口
通过 VoiceOver 进行无障碍交互

项目优势

无需注入 Dock 或修改 SIP
已通过 Apple 公证和签名，安装无 Gatekeeper 警告
可配置悬停延迟、缩略图大小以及按应用禁用预览
尊重系统辅助功能设置（减弱动态效果、减少透明度）

使用前须知

需要 macOS 14 或更高版本（Apple Silicon 或 Intel）
需一次性授予 Accessibility 和 Screen Recording 权限
仅通过 ScreenCaptureKit 捕获窗口图像（预览中不支持视频或交互）

README 快速开始

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

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

Prefer to build it yourself? See Build & run.

How it works

Piece	API
Detect which Dock icon the cursor is over	Accessibility (`AXUIElementCopyElementAtPosition`, `AXDockItem`)
Resolve the icon to a running app	Dock item `AXURL` → bundle id → `NSRunningApplication`
Capture window thumbnails	ScreenCaptureKit (`SCScreenshotManager.captureImage`)
Show the preview	Borderless 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)

Accessibility — to read which Dock icon the cursor is over and its frame.
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

项目描述

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.

dock-preview-mac