docktor

Product Introduction

1. Definition: Docktor is a macOS utility application that enhances the native macOS Dock by adding live window previews, an improved application switcher, and a suite of floating, glass-morphic widgets. It operates as a system-level overlay, integrating directly into the user's existing workflow without creating a separate application window or menu bar icon.
2. Core Value Proposition: Docktor exists to reclaim wasted screen real estate and streamline multitasking on macOS. It transforms the static Dock into a dynamic control surface, providing at-a-glance information (music, calendar, weather, system stats) and faster window management (live previews, enhanced Cmd+Tab) precisely where the user's cursor already travels, eliminating context-switching and application hunting.

Main Features

1. Live Dock Previews: Hovering the cursor over an application icon in the Dock triggers real-time, high-fidelity thumbnails of every open window for that app, including minimized and off-screen windows. This is powered by Apple's private ScreenCaptureKit API, ensuring efficient, low-latency capture. Users can click any thumbnail to instantly focus that specific window, bypassing the need for Mission Control or cycling through windows.
2. Enhanced Command-Tab Switcher: Docktor replaces the native macOS application switcher (Cmd+Tab) with one that displays live window thumbnails for the selected application instead of just its icon. This allows users to visually identify the correct window before switching, a significant improvement over the standard icon-only interface that requires memorization or guesswork.
3. Modular Glass Widgets: A row of translucent, "glass" widgets sits adjacent to the Dock, displaying key information. These are locally-hosted widgets that pull data from system APIs and authorized services:
   • Music Widget: Controls playback for Spotify (via its Web API) and Apple Music (via Apple Events/Automation). It displays the current track, offers transport controls, and features expandable drawers for the playback queue and synced lyrics.
   • Calendar Widget: Integrates directly with the macOS Calendar app via the EventKit framework. It shows the next upcoming event with a live countdown timer and can optionally open meeting links automatically. The drawer reveals the full day's schedule.
   • Weather Widget: Fetches data from the privacy-focused Open-Meteo service. It displays current temperature, "feels-like" temperature, and conditions, with a drawer showing a 12-hour forecast, precipitation chance, humidity, wind, and UV index. It supports saved locations.
   • System Stats Widget: Monitors local system resources (CPU, RAM, disk) using macOS system counters. It shows a summary in the bar, with detailed drawer pages listing top processes and live sparkline graphs for historical trends, functioning as a lightweight, always-visible Activity Monitor.

Problems Solved

1. Pain Point: Inefficient window management and context-switching. Users waste time and cognitive load clicking through apps in the Dock or using Cmd+Tab only to land in the wrong window, then needing to use further shortcuts or Mission Control to find the correct one.
2. Target Audience: The primary user personas are power users, multitaskers, and productivity-focused professionals on macOS, such as software developers, writers, researchers, and project managers who frequently have dozens of windows and applications open simultaneously and need to navigate between them swiftly and accurately.
3. Use Cases:
   • A developer needing to quickly reference a specific terminal window, browser dev tools panel, or code editor file among many open instances.
   • A writer or researcher switching between a specific browser tab, a Word/Pages document, and a reference PDF without losing their train of thought.
   • A remote worker managing multiple communication apps (Slack, Zoom, Teams) and needing to see which specific conversation or meeting window is active before joining.
   • Any user who wants to monitor music playback, their next calendar event, or system resource usage without dedicating valuable menu bar space or opening separate applications.

Unique Advantages

1. Differentiation: Unlike standalone widget engines or menu bar utilities, Docktor is uniquely integrated into the Dock's spatial context. It doesn't occupy premium menu bar space or live in a separate overlay window; it utilizes the "dead space" flanking the Dock. Compared to other Dock enhancers, its use of ScreenCaptureKit for true live thumbnails (including hidden windows) and its native, privacy-respecting integration with system calendars and music services set it apart.
2. Key Innovation: The core innovation is its "local-first, integration-heavy" architecture. It leverages macOS's deepest native APIs (ScreenCaptureKit, EventKit, Apple Events, Accessibility) to build features that feel like a natural extension of the OS, not a bolted-on third-party app. This approach enables powerful functionality (like previewing minimized windows) while maintaining a strong privacy stance—no cloud accounts are required for core features, and data like calendar events and system stats never leaves the Mac.

Frequently Asked Questions (FAQ)

1. Is Docktor safe and private? Yes. Docktor operates on a local-first privacy model. Core features like Dock previews and system stats require only standard macOS permissions (Accessibility, Screen Recording) to function and do not send any data off your device. Optional features like Calendar (using Apple's EventKit) and Weather (using Open-Meteo) connect directly to their respective services without intermediary servers. No account or login is required to use the app.
2. Does Docktor work if I hide my macOS Dock? No. Docktor is specifically designed to augment the visible macOS Dock. Its widgets occupy the space beside the Dock, and its previews are triggered by hovering over Dock icons. If the Dock is set to auto-hide, the widgets and preview mechanics will not be accessible.
3. What versions of macOS are supported? Docktor requires macOS 26.0 (codenamed Tahoe) or later. This is a future version of macOS, indicating the app is built with and for the latest Apple frameworks and technologies. It is a Universal binary, meaning it runs natively on both Apple Silicon and Intel-based Macs.
4. How does Docktor affect system performance or battery life? By utilizing Apple's optimized ScreenCaptureKit API for thumbnails and efficient local APIs for widgets, Docktor is designed to be lightweight. Performance impact is typically minimal. However, as with any utility that performs live screen capture and updates widgets, it may have a marginal effect on battery life during active use compared to not running it.
5. Can I customize the widgets or add new ones? In its current public pre-release state (v0.11.2), Docktor offers a fixed set of four core widgets (Music, Calendar, Weather, System Stats). The developer has indicated more are "coming soon." Users can enable or disable individual widgets within the app's settings, but cannot yet create or install third-party widgets.