DockFlip sits next to every window you open, so it should earn that spot. Here's exactly what it can see, what it does with it, and how to check all of it yourself.
- One permission: Accessibility. That's the whole list.
- No Screen Recording. Most Dock preview apps and window switchers ask for it on first launch, because they're built around screenshots of your windows. DockFlip is built around what macOS already tells it: titles, positions, app icons and tabs. Window cards and mini-maps drawn from those look good on their own, so DockFlip never needs to see your screen. Real thumbnails exist, but they're opt-in and off until you choose them.
- No networking code. No analytics, no crash reporter, no update check, no licence server. DockFlip can't phone home, and nothing can phone it.
- No third-party code. Apple frameworks only, so there's no dependency that could slip something in.
- Titles never reach the log. The debug log records timings and counts, never window or tab titles.
| DockFlip reads or does | So that |
|---|---|
| The list of windows, their titles, positions and states | The Dock lists and ⌘Tab can show them |
| Focus, move, resize, minimize and close windows, when you ask | Switching, snapping and Clean Up work |
| Browser tab titles, from the tab bar only, never page content | Tabs show under their window |
| The Dock's hovered icon | The window list opens above the right app |
| Left mouse clicks and drags, anywhere on the Mac (the pointer's position only) | A click on a Dock icon brings its window forward or minimizes it, and dragging a window to a screen edge snaps it |
| Pointer movement, only while it's over the Dock or a window list | The list closes when you move away |
| Modifier keys (⌘, ⌃, ⌥, ⇧) | It notices when you press or let go of ⌘ |
| Other keys, only while the ⌘Tab switcher is open | Type-to-filter works |
Clicks and drags outside the Dock pass through untouched. DockFlip uses only where the pointer went down and moved, to tell a Dock icon click from a window drag, never what you clicked inside an app, and it never sees right clicks or scrolling. The only clicks it takes over are plain clicks on an app icon in the Dock; ⌘, ⌥, ⌃ and ⇧ clicks, dragging an icon and press-and-hold still go to the Dock. Where you click is never recorded or logged.
The rest of the time DockFlip doesn't see what you type. Its shortcuts are registered as system hot keys, so macOS only tells DockFlip when one of them is pressed.
Only its own preferences (defaults read io.github.dockflip.DockFlip), and never
a window or tab title:
- Its settings, and the apps you told Clean Up to keep (their bundle ids).
- When each window and app was last used, for Clean Up's suggestions: window numbers and app bundle ids, each with a date.
- Where each window was for each set of displays, so windows go back after a display change or a DockFlip restart: window numbers and frames.
macOS reuses window numbers after the Mac restarts, so DockFlip drops both window
lists then. make uninstall deletes all of it. The debug log is written only
where you save it.
Thumbnails are the only feature that uses Screen Recording, and they come with rules:
- Pictures are taken on demand, when you hover a Dock icon or press ⌘Tab, one window at a time and at thumbnail size, and only of windows that may look different since their last picture: ones you worked in, or whose title or size changed. Usually that is one or two windows.
- They're kept in memory only, packed as HEIC: the last picture of each open window, at most 64. The last 16 shown are also kept unpacked, ready to draw, so a list opens with its pictures already in place. They're never written to disk and are dropped when the window closes, the screen locks or the Mac sleeps.
- They're never taken while a password field is active.
- Password managers (1Password, Bitwarden, Proton Pass, Enpass, Strongbox, NordPass, KeePassXC and others), Authy, Keychain Access and System Settings are never pictured.
- Private windows of Firefox, Chrome, Edge, Brave and Vivaldi are never pictured: they're told apart by the word their title ends in. Safari puts no such word in the title, so its private windows can still be pictured; turn thumbnails off if that matters to you.
Every rule is in one file:
Sources/DockFlipKit/Previews/PreviewProvider.swift,
and the list of skipped apps and windows in
NeverPictured.swift beside it.
No networking. Search the source; nothing turns up:
grep -rnE "URLSession|NWConnection|CFNetwork|URLRequest|socket\(" SourcesOr watch it with a firewall such as Little Snitch, or nettop -p DockFlip.
The download is the code. Every release is built by GitHub Actions from the
tagged source, and the disk image, the IT .pkg and the Accessibility profile
each come with a build-provenance attestation and a SHA-256 checksum:
gh attestation verify DockFlip-<version>.dmg --repo geezery/DockFlip
shasum -a 256 -c DockFlip-<version>.dmg.sha256The same two commands work for DockFlip-<version>.pkg and
DockFlip-Accessibility.mobileconfig; see docs/IT.md.
The signature. Every release is signed with the same identity, which is why your Accessibility permission survives updates:
codesign -dv --verbose=2 /Applications/DockFlip.app # Authority=DockFlip ReleasemacOS shows a warning the first time you open DockFlip: "Apple could not verify 'DockFlip' is free of malware". That isn't a finding, it's paperwork. Apple only skips the warning for apps from developers who pay 99 € a year for notarization, and DockFlip is free.
☕ That's what the coffee is for. Once a handful of $2 coffees (or a few bigger cups) cover the fee, DockFlip gets notarized: download, drag to Applications, open, done. No warning, no trip to System Settings, and updates that simply open. Buy DockFlip a coffee.
Only the latest release gets fixes. DockFlip updates are free, so there's no reason to stay behind.
If you find a way DockFlip could leak window contents, titles or keystrokes, or be abused by another app, please report it privately through GitHub's private vulnerability reporting and not in a public issue. You'll get an answer within a few days, and credit in the release notes if you'd like it.