brainstate

ejbills/DockDoor · source

Snapshot 0 · 2026-11-04T12:47:27Z · Swift ·

Content fingerprint988775d919b195d825b601ed95092a94499217b367bb76067bf99ab9967b3ac0

GitHub description at capture

Window peeking, alt-tab and other enhancements for macOS

README at capture

<a id="readme-top"></a>

<div align="center">

<img src="Assets/Assets.xcassets/AppIcon.appiconset/AppIcon-iOS-Default-512x512@1x.png" alt="DockDoor Logo" width="128"/>

</div>

<h1 align="center">DockDoor</h1>

<div align="center">

<p>
  <a href="https://github.com/ejbills/DockDoor/releases/latest/download/DockDoor.dmg">
    <img src="https://img.shields.io/github/downloads/ejbills/DockDoor/latest/total?style=flat&label=Downloads%20%40latest&labelColor=444&logo=hack-the-box&logoColor=white&cacheSeconds=600" alt="Latest downloads">
  </a>
  <a href="https://github.com/ejbills/DockDoor/releases">
    <img src="https://img.shields.io/github/downloads/ejbills/DockDoor/total?label=Total%20Downloads" alt="Total downloads">
  </a>
</p>

![Swift](https://img.shields.io/badge/Swift-FA7343?style=for-the-badge&logo=swift&logoColor=white)
![XCode](https://img.shields.io/badge/Xcode-007ACC?style=for-the-badge&logo=Xcode&logoColor=white)
![Git](https://img.shields.io/badge/GIT-E44C30?style=for-the-badge&logo=git&logoColor=white)
![MacOS](https://img.shields.io/badge/mac%20os-000000?style=for-the-badge&logo=apple&logoColor=white)

**Every window, one hover away.**

Live window previews, Alt+Tab switching and keyboard controls for the Dock you already have.

</div>

![DockDoor showing four Chrome windows as live previews above the Dock](resources/web/previews-poster.webp)

## Table of Contents

  <ol>
    <li><a href="#about-the-project">About The Project</a></li>
    <li><a href="#install">Install</a></li>
    <li><a href="#features">Features</a></li>
    <li><a href="#privacy">Privacy</a></li>
    <li><a href="#dockdoor-pro">DockDoor Pro</a></li>
    <li><a href="#works-with-dockdoor">Works with DockDoor</a></li>
    <li><a href="#contributing">Contributing</a></li>
    <li><a href="#license">License</a></li>
  </ol>

## About The Project

**DockDoor** brings window previews to the macOS Dock, the way Windows and Linux have had them for years. Hover an app in the Dock to see all of its open windows as live thumbnails, then click one to switch to it, or close, minimize and quit it right from the preview.

It doesn't replace the Dock. DockDoor is a small native app that runs from the menu bar and adds to the Dock that ships with macOS, in Liquid Glass on macOS 26 and later.

See it in motion at **[dockdoor.net](https://dockdoor.net)**.

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## Install

- **[Download DockDoor.dmg](https://github.com/ejbills/DockDoor/releases/latest/download/DockDoor.dmg)**
- Or with Homebrew: `brew install --cask dockdoor`

Free for macOS 13 Ventura and later, on Apple silicon and Intel. Notarized by Apple, and it keeps itself up to date.

Only download DockDoor from [dockdoor.net](https://dockdoor.net) or this repository's [releases](https://github.com/ejbills/DockDoor/releases).

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## Features

### Dock previews

Hover any app in the Dock to see its windows, including ones on other desktops, other displays, and minimized or hidden ones. Each preview has close, minimize, full screen and quit buttons, and a middle-click closes a window without switching to it.

![A Dock preview with window controls above each thumbnail](resources/web/layout-default.webp)

### Alt+Tab for every window

Hold <kbd>⌥</kbd> and press <kbd>Tab</kbd> to see every open window, not just every app. Press <kbd>Tab</kbd> to move through them and release to switch. Type to search, or change the shortcut in Settings.

![The window switcher showing four windows](resources/web/switcher.webp)

### Command-Tab, with windows

While you hold <kbd>⌘</kbd> and <kbd>Tab</kbd>, DockDoor shows the highlighted app's windows above the built-in app switcher, so you can pick a specific window.

![Command-Tab with window previews above it](resources/web/cmd-tab.webp)

### Folders, widgets and more

<table>
  <tr>
    <td width="50%"><img src="resources/web/folder-pop.webp" alt="A Dock folder opened as a sortable list of files"><br><b>Folder Pop</b><br>Hover a folder in the Dock to see, sort and open what's inside.</td>
    <td width="50%"><img src="resources/web/music-widget-poster.webp" alt="A music player shown when hovering an app that's playing audio"><br><b>Music controls</b><br>Hover an app that's playing audio for a player instead of thumbnails, with synced lyrics for Spotify and Apple Music.</td>
  </tr>
  <tr>
    <td width="50%"><img src="resources/web/compact-list.webp" alt="Four windows shown as a compact list of titles"><br><b>Compact list</b><br>Show an app's windows as a list of titles, all the time or once it has a lot of them.</td>
    <td width="50%"><img src="resources/web/large-previews.webp" alt="Four large window previews in a two by two grid"><br><b>Large previews</b><br>Make thumbnails bigger to tell similar windows apart.</td>
  </tr>
</table>

Plus:

- **Gestures:** swipe two fingers on a preview to minimize or maximize a window, scroll on a Dock icon to show or hide an app, or shake a preview to minimize everything else.
- **Quick quit:** hold <kbd>⌘</kbd> and right-click a Dock icon to quit the app, or add <kbd>⌥</kbd> to force quit.
- **Calendar:** hover Calendar to see the rest of today's events.
- **AppleScript and CLI:** control previews, the switcher and windows from scripts. See the [docs](https://dockdoor.net/docs).

### Make it look like yours

Choose Liquid Glass (macOS 26 and later), frosted or clear, and set the preview size, spacing, corners and where the window controls sit.

<table>
  <tr>
    <td width="50%"><img src="resources/web/layout-embedded.webp" alt="Dock preview with controls floating on each window"></td>
    <td width="50%"><img src="resources/web/settings-appearance.webp" alt="DockDoor's Appearance settings"></td>
  </tr>
</table>

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## Privacy

Nothing leaves your Mac. DockDoor has no servers to send anything to: no analytics, no usage tracking and no crash reporters. Debug logs are written locally and go nowhere unless you export them yourself.

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## DockDoor Pro

<a href="https://pro.dockdoor.net"><img src="resources/pro/scene-previews.webp" alt="DockDoor Pro"/></a>

**DockDoor Free has no paywall and never will.** Every feature in this repo is free, forever.

**[DockDoor Pro](https://pro.dockdoor.net)** is a separate paid app from the same developer. It replaces the macOS Dock with its own, and buying it is the best way to support DockDoor Free:

- Spring magnification at your display's full refresh rate
- Folders that fan out, a drag-and-drop file tray with AirDrop, and right-click quick actions
- Liquid Glass, frosted or clear materials, profiles, and a different Dock on every display
- Its own window previews and a full Alt+Tab replacement
- A widget marketplace with clock, weather, battery, now playing and community widgets

$20 one-time for 3 Macs. No subscription, 14-day money-back guarantee. If you use Pro, you don't need DockDoor Free.

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## Works with DockDoor

<a href="https://parall.app"><img src="resources/web/parall-icon.webp" alt="Parall" width="64" align="left"/></a>

**[Parall](https://parall.app)** runs multiple independent instances of the same Mac app, each with its own name and Dock icon. DockDoor and DockDoor Pro recognize apps opened through Parall, so each instance gets its own previews. DockDoor is listed as developer-supported on [Parall's compatibility list](https://parall.app/compatibility/).

<br clear="left"/>

More at [dockdoor.net/works-with](https://dockdoor.net/works-with).

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## Contributing

DockDoor is written almost entirely by one developer, with fixes, features and translations from the open-source community.

- 📖 Read [CONTRIBUTING.md](CONTRIBUTING.md) before opening a pull request
- ⭐ [Star it on GitHub](https://github.com/ejbills/DockDoor) to help other people find it
- 🐛 [Report a bug or ask for a feature](https://github.com/ejbills/DockDoor/issues)
- 🌍 [Translate it on Crowdin](https://crowdin.com/project/dockdoor)
- 💬 [Join the Discord](https://discord.gg/TZeRs73hFb)
- ❤️ [Support development](https://dockdoor.net/donate)

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>

## License

This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

<p align="right"><a href="#readme-top">Back to top ⬆️</a></p>