<style> h1:first-of-type { display: none; } .my-5 { margin: unset !important; } .markdown-body img { max-width: 50%; } @media (prefers-color-scheme: dark) { body { color-scheme: dark; color: white; background: transparent; } a, :link { color: #419cff; } a:active, link:active { color: #ff1919; } } .donation-link { display: inline-block; margin-top: 10px; padding: 5px 10px; background-color: #FFDD00; color: #000000 !important; text-decoration: none; font-size: 0.9em; font-weight: bold; border-radius: 3px; } .donation-link:hover { background-color: #E5C700; } </style>

☕ Support kepler.cafe at https://buymeacoffee.com/keplercafe

v1.6.1 - 2025-01-09

Fixes dock preview rendering too high when primary monitor was oriented vertically (#447)
Adds missing localization strings
Syncs translations with Crowdin

v1.6 - 2025-01-09

Changelog v1.6 🎉

New Features

Aero Shake
- Shake window to minimize other/all windows
- Configurable in General settings
Traffic Light Button Customizations
- New customization options for window controls in appearance settings, disable any of the buttons!

Bug Fixes

Fixed window switcher ordering. Windows will no longer be erratically shuffled.
Fixed window flow breaking when extending off screen
Fixed flow container being artificially capped at 3 rows
Resolved lateral movement issues with non-running applications in dock
Corrected window registration timing on application launch

Enhancements

Window sizing controls visualization
Reworded and moved some settings options
Windows now registered in DockDoor upon creation
Quicker tabbing animation in window switcher
Updated localizations via Crowdin integration

v1.5.1 - 2025-01-03

Fixes preview intermittently failing to present when hovering over app icon
Reworked "See full preview" hover action to display window previews at their exact size and position on the correct monitor, matching the real window's dimensions and location for a more accurate preview experience.
- This provides better context when switching between windows and eliminates scaling issues on large displays.
Reduces memory usage

v1.5 - 2024-12-30

This is a big update, folks. 这是一个重大更新。C'est une mise à jour majeure. Questo è un importante aggiornamento. Esta es una actualización importante.

If you find DockDoor helpful in your daily workflow, please consider supporting its development at https://buymeacoffee.com/keplercafe. Your contribution helps keep the project alive and growing! ❤️

Changelog v1.5 🎉

New Features

Window Switcher Enhancements
- Completely redesigned interface with app titles and customizable window controls
- Screen placement options (mouse position, specific screen, or last active window)
- Dimmed inactive windows option
Flow Container
- Multi-row window preview layout for better organization of many windows
- Customizable row count for preview display
Adjustable selection highlight color and opacity
Added "Close All" and "Minimize All" window management options, on hover of app title.
This update has many customization options, take a look!
- To see it in motion, view the video here: https://youtu.be/ReEPCWaomlY

Enhancements

Myriad of UI/UX changes
Optimized memory usage through removal of outdated cache code
Support for custom application directories in filters
Improved window capture system for better stability
Enhanced dark mode support for capsule rendering
Updated localizations via Crowdin integration
Minimized and hidden window previews will now have refreshed screenshots

Bug Fixes

Resolved minimum window sizing for edge cases
Fixed application filtering for apps outside /Applications folder
Addressed preview display issues with minimized windows
Corrected window positioning when closing windows
Fixed popover window title rendering
Many other bug fixes

v1.4 - 2024-12-22

Changelog v1.4 🎄

New Features

Window Dragging:
- Drag and reposition windows directly from DockDoor previews onto your macOS desktop.
Window Title Filters and Application Filters:
- Exclude windows or applications from being captured based on title or app name.
- Example: Filtering "google" prevents windows containing "google" in their title from being managed.
Window Switcher option:
- Holding Command and pressing Tab twice now switches to the second last used window, addressing usability feedback.

Enhancements

Less lingering windows!
- Auto-dismissal of inactive window previews after 10 seconds to avoid clutter.
- Improved preview dismissal logic when clicking outside the window area.
Centered window previews relative to the current Dock icon for more reliable window placements.
Improved user experience in keybind recording view.
Refined settings placements for better navigation and discoverability.
Enhanced permission messaging for clearer instructions.
Synchronized localizations for both the macOS app and website with Crowdin.

Bug Fixes

Resolved window preview sizing issues across multiple displays.
Fixed scaling for windows intersecting multiple screens.
Dismissal of hover containers now properly occurs when interacting outside the window.
Fixed gradient alerts to ensure proper localization.
Addressed issues with window switcher behavior during initial app launch and desktop space switches.

v1.3.3 - 2024-12-07

Changelog

Fixes

Fixed window presentation delay issues
- Users with long hover delay times will no longer experience hanging windows
Default "prevent dock hide" functionality is now disabled by default due to windows resizing
Fixed missing window close animations when using traffic light buttons
Fixed delayed window presentation timing
Corrected issue where dockdoor settings window didn't close before new window presentation

Chores

Added clarifying comments for lingering window detection
Updated macOS app localizations via Crowdin sync (#389)

v1.3.2 - 2024-11-30

Fixes issue where dock stays visible when not invoking previews when 'Ignore Apps with One Window' option is checked
Moved 'Include Hidden and Minimized Windows in the Window Switcher' option to Window Switcher category

v1.3.1 - 2024-11-29

🦃 Changelog

Features

Dock with auto-hide enabled will now remain open when interacting with window previews (changable in settings)
Window switcher now has option to exclude hidden and minimized windows
Window selection is now more visually prominent

Fixes

Window previews now work properly with custom dock animation speeds (#297)
Window previews no longer disappear when moving between windows/apps (#364)
- This fixes the frustrating behavior where previews would vanish during normal window navigation.
Windows can now be activated correctly when dock is set to auto-hide (#371)
Window previews now properly dismiss when moving cursor away (#374)
Slider fields now show decimal values for more precise control

Chores

Added Portuguese (Brazil) translation to https://dockdoor.net (#383)
Updated all system translations via Crowdin (#377, #386)

v1.3 - 2024-11-22

Changelog

🚀 New Features

Window Preview Preservation: Preview will no longer hide when traffic light buttons are used to manage window state (#376)
Natural Mouse Movement: Allow natural lateral mouse movements between active app icons
Added app icon and app title information to window switcher

🛠️ Fixes

Window Cache Management: Regularly purge invalid cached windows
Window Closing: Fixed handling of invalid dock notifications for window closure
Window Sizing: Improved UX for window sizing options (is now a slider based on screen dimensions)

🧹 Chores

macOS Localization: Synced macOS app localizations with Crowdin (#369)
Website Localization: Synced website localizations with Crowdin (#370)

↩️ Reverts

Reverted fix for invalid dock notification window closure handling

v1.2.9 - 2024-09-17

Fixes a bug where windows in the cache were not being properly updated

v1.2.8 - 2024-09-13

We now have a website, it was created by the wonderful @illavoluntas! https://dockdoor.net

Changelog

🚀 New Features

Ignore Single-Window Apps: Added an option to ignore apps that only have one window, improving focus on multi-window applications.

🎨 Redesigns

Update Page: Redesigned the update page for a more modern and intuitive user experience.

🛠️ Fixes

Date Window Sorting: Fixed an issue with sorting windows by date, ensuring correct chronological order.
Window Info Fetching: Refactored the fetchWindowInfo method for improved performance and reliability.
Resizable Settings Pane: Enabled the settings pane to be resized and adjusted the layout for slider settings to improve usability.
Localized Strings: Fixed an issue where localized strings sometimes did not fit properly within UI elements.

🛠️ Chores

Localization Sync: Synced macOS app localizations with Crowdin, keeping translations up to date (#318).
Website Localization Sync: Updated website localizations using Crowdin (#316).

v1.2.7 - 2024-09-13

Changelog

No more dock alignment issues. It will now be placed accurately 100% of the time.

🛠️ Fixes

Dock Item Hover Preview: The hover preview is now placed using the Dock item’s Accessibility (AX) element, ensuring accurate positioning even on multi-monitor setups (#277).

v1.2.6 - 2024-09-10

Changelog

🚀 New Features

Help Settings: Introduced a new section in the settings to provide help and support to users.

🛠️ Fixes

Window Validation: Fixed an issue where windows were not properly validated when a window UI element was changed (#310).
Fluid Gradient Package Removal: Removed the fluid gradient package in favor of a custom implementation to fix a small memory leak.

v1.2.5 - 2024-09-08

⚠️ Note: Fixes critical v1.2.4 crash.
⚠️ This update sets the default app name label style to "embedded" and changes the window switcher keybind to Option + Tab. You can customize these settings if preferred.

Changelog

🚀 New Features

Custom Menu Bar Icon: Introduced a custom menu bar icon for DockDoor, offering a fresh, distinct look for users.
Embedded App Title Style: The embedded app title style is now set as the default, providing a more cohesive visual experience.

🎨 Redesigns

First-Time Launch Experience: Completely redesigned the first-time launch flow of DockDoor for a more intuitive and modern onboarding experience.
Permissions View: Redesigned the permissions view for clarity and ease of use, enhancing the overall user experience.

🛠️ Changes

Window Switcher Keybind Change: The window switcher now defaults to Option + Tab instead of Command + Tab.

🎨 Visual Updates

New App Icon: Introduced another new icon, giving DockDoor a fresh, updated look.

v1.2.3 - 2024-09-05

Adds option to disable window sorting - #292

v1.2.2 - 2024-09-04

Fixes far windows being impossible to reach #291

v1.2.1 - 2024-09-04

Fixes windows having wrong size while they are not in the main screen #288

v1.2.0 - 2024-09-04

Changelog

🚀 New Features

Efficient Dock Item Detection and Improved Window Management: @ShlomoCode, @ejbills
- Dock Item Detection: The current Dock item is now detected using macOS Dock's native detection (kAXSelectedChildrenChangedNotification and kAXSelectedChildrenAttribute) instead of relying on mouse position calculations.
- Performance Improvement: Removed the global listener for mouse events, which significantly reduces CPU usage to 0% when not interacting or hovering with the Dock.
- Window Cache Management: Windows are now cached by PID instead of BundleID, improving compatibility with apps like scrcpy that do not have a BundleID.
- Window State Management: Enhanced logic for managing window states, including addressing window switcher update inconsistencies.
- Window Fade Out Animations: Introduced window fade-out animations and added configuration options for customization.

🛠️ Fixes

Fix Window Close Update: Resolved an issue where the window was not updating its state upon closing. - @ejbills
Window Placement and Configuration: Fixed inaccurate window placement and configuration when using SCWindow. - @ejbills
Invisible Window Switcher: Corrected an issue where the window switcher would become invisible under certain conditions. - @ejbills
Window Raise and Matching Logic: Addressed problems with the logic that raises windows and matches them correctly. - @ejbills
Window Switcher Update Inconsistency: Fixed inconsistencies when updating the window switcher. - @ejbills

🧹 Chores

Localization Sync: Regular synchronization of localizations with Crowdin. [#286, #287] - @ejbills, @crowdin-bot
Remove Unused Methods and Code: Cleaned up the codebase by removing unused methods and outdated logic. - @ejbills
Update Appcast for 1.1.6: Updated the appcast to point to the patched version 1.1.6. - @ejbills
Improve Button Reliability: Enhancements were made to improve the reliability of buttons within the application. - @ejbills

🎨 Refactor

Window Dismissal Improvements: Applied debounce cancellation logic and refined mouse position checks to improve window dismissal. - @ejbills
Smart Distance Threshold: Implemented a smart distance threshold for hiding lingering windows. - @ejbills

Shoutout to @ShlomoCode for his amazing contributions!

v1.1.6 - 2024-08-30

🛠️ Fixes

Window Switcher Lag: Resolved lag issues when switching windows, enhancing overall responsiveness. [#280] - @ejbills
Previous Traffic Light Buttons Position: Updated the logic to correctly position traffic light buttons on the “OK” dialog. [#271] - @ShlomoCode
Gradient Twitching: Fixed an issue where gradients would twitch when using DockDoor within a fullscreen application. [#267] - @ejbills
RTL Layout Rendering: Corrected the right-to-left layout rendering for user-defined element positions. [#262] - @ShlomoCode
Bring Window to Front Logic: Restored the original logic for bringing windows to the front, improving window management. [#246] - @ShlomoCode

🚀 New Features

macOS 13 Ventura Support: Added full support for macOS 13 Ventura. [#267] - @ShlomoCode, @ejbills
Customizable Highlight Gradient Colors: Introduced customizable highlight gradient colors for enhanced user interface personalization. [#265] - @ejbills
Escape to Close Preview: Added the ability to press the Escape key to close the preview window, streamlining user interactions. [#255] - @ShlomoCode

🔧 Maintenance

Localization Sync: Regular synchronization of localizations with Crowdin to keep translations up-to-date. [#270], [#266], [#263], [#249] - @ejbills, @crowdin-bot
Format Preservation: Preserved unused arguments in code formatting to maintain consistency. [#252] - @ShlomoCode
Localizable.xcstrings Update: Updated the Localizable.xcstrings file with new keys to support additional translations. [#255] - @ShlomoCode
SwiftFormat Lint: Integrated SwiftFormat linting to ensure consistent code style. [#250] - @ShlomoCode
Autogenerated Xcode File Headers: Removed unnecessary autogenerated file headers in Xcode for cleaner codebase. [#251] - @ShlomoCode
CNAME Management: Created and deleted CNAME records as part of domain management efforts. - @ejbills

🛠️ Refactoring

AXUIElement Extension: Refactored code to use an AXUIElement extension for improved accessibility and cleaner code. [#242] - @ShlomoCode

v1.1.5 - 2024-08-02

Changelog

Features

Introducing ability to track & navigate to windows from all applications across all spaces, along with support for window previews on minimized and hidden windows. @hasansultan92 & @ejbills
- Note: This is the initial rollout of this feature and things may be buggy. Please report any bugs you encounter. It works as follows: as you navigate, window states are tracked and stored across spaces, allowing support for windows in other spaces, along with tracking minimized and hidden windows (which are displayed in a faded-greyed out look in the window preview).
Restart the app when needed instead of just quitting @ShlomoCode
Open app settings by relaunch @ShlomoCode
Add ability to choose traffic light buttons position @ShlomoCode
Add quit button @ShlomoCode

Fixes

Disable fullscreen button in settings window @ShlomoCode
Use decimalFormatter in 'preview hover delay' setting @ShlomoCode

Chore

Sync localizations with Crowdin @ejbills
Clearer wording in settings @ShlomoCode
GitHub issue template enforcement @ejbills
Add manual run ability to stale issues action @ejbills
Create pull request template @ejbills
Add Homebrew installation instructions @ejbills
Show copy button for brew command @ShlomoCode

v1.1.4 - 2024-07-16

Changelog

Fixes

No longer filter out windows with empty titles
Blurry window preview images
Traffic light buttons visibility picker width (#193) @ShlomoCode

Chore

Clearer wording in settings (#194) @ShlomoCode
Typo in settings (#197) @ShlomoCode

v1.1.3 - 2024-07-16

Changelog

Features

Add option to select window title visibility (whenOveringPreview/alwaysVisible) (#188) @ShlomoCode
[SharedPreviewWindowCoordinator] add fall back (#186) @chrisharper22
Center Dock Tile Preview horizontally/vertically to icon (#182) @chrisharper22
Clearer wording (#181) @ShlomoCode
Suggest users contribute translations (#178) @ShlomoCode
Improve settings layout (#175) @ShlomoCode
Add app icon to readme (#176) @ShlomoCode

Fixes

Lingering full screen preview in certain scenarios
Minimized and hidden windows showing empty squircle

Refactor

HoverTimerActions -> PreviewHoverAction (#173)

Chore

License change from MIT to GPL-3.0 (#191)
Add release publish to crowdin sync action
Sync localizations with Crowdin @ejbills @crowdin-bot

v1.1.2 - 2024-07-12

Changelog

Features

Preview window hover actions, with time and action customizations (#171)
More localizations! You can now contribute to the translation here: https://crowdin.com/project/dockdoor/invite?h=895e3c085646d3c07fa36a97044668e02149115
Make more strings localizable (#168) @ShlomoCode
Settings: scale pickers and add number fields next to sliders (#170) @ShlomoCode
Add top right window title position option (#150) @ShlomoCode
Crowdin localization and automation (#155)
Add Crowdin localization support and actions (#151)

Fixes

Local labels are cutting (#169) @ShlomoCode @ejbills
Better setting names for preview hover action items
Release notes loading (#148) @ShlomoCode
Invalid formatting in changelog (#147) @ShlomoCode

Chore

Sync localizations with Crowdin (#165) @ejbills @crowdin-bot
Set commit_message in crowdin-sync.yml (#158) @ShlomoCode
Initialize workflow file on main branch
Revert "fix: invalid formatting in changelog (#147)" (#149)
Patch: Update crowdin-sync.yml to not run based on push to main (was creating loop) (#167)
New Crowdin translations by GitHub Action (#156) @ejbills @crowdin-bot

v1.1.1 - 2024-07-11

Changelog

Features

Update app icon to new design (Thanks to the awesome artwork by @VisualisationExpo)
Traffic light button display customization options
Make traffic lights symbols dark in light theme (#135) @ShlomoCode
Added customization options for Window Titles (#128) @chrisharper22
Improve release notes style (#125) @ShlomoCode
Show changelog in in-app update (#120) @ShlomoCode
Localize to FR (#115) @illavoluntas
Focus when unminimized (#118) @UnknownCrafts

Fixes

Incorrect placement of traffic light setting
Window should not be draggable
Accidentally deleted download link from readme
Chrome PWA's (#126) @ShlomoCode
Sparkle release notes in dark mode (#124) @ShlomoCode

Refactor

Replace numeric enums with named enums; reword keys and variables (#141) @ShlomoCode

Chore

Update he localization (#143) @ShlomoCode
Add readme badges
Remove useless maxwidth
Create xcscheme file (#127) @ShlomoCode
Create pr-lint.yml (#122) @ShlomoCode

v1.1.0 - 2024-07-09

Features

Add Hover App Title Styling options (#101) (@chrisharper22)
Window title alignment option
Use "hidden" word for window title hidden style (#112) (@ShlomoCode)
Subtle traffic light buttons
Add an "Appearance" tab in app settings (#106) (@ShlomoCode)
Make more strings localizable (#105, #102) (@ShlomoCode)
Localize Hebrew (#100) (@ShlomoCode)
Close preview when dock icon is clicked (#62) (@ShlomoCode)

Fixes

Show menu bar icon only on app reopen, not on interact (#98) (@ShlomoCode)
OpenDelay display format (#99) (@ShlomoCode)

Other

Remove xcuserdata files (#113) (@ShlomoCode)
Scale effect

v1.0.17 - 2024-07-08

Fixes bug: Impossible to use Tab with default MacOS keybind activated (#92) @hasansultan92
Adds option to not use uniform window radius, so that you can see an entire window preview without it getting cropped. (#93) @ShlomoCode

v1.0.16 - 2024-07-08

Adds window switcher key bind customization (thanks to @hasansultan92)
Show menu bar icon when app icon is clicked (thanks to @ShlomoCode)
Fixes the title label UI flashing on hover

v1.0.15 - 2024-07-06

Quick patch for:

Windows that are on separate monitors not showing up
Some users were experiencing blurry windows (not sure if this is fully fixed)

v1.0.14 - 2024-07-05

Initial support for hidden apps (CMD+H). If an app is hidden, its windows will show up as ‘hidden’ and will be displayed similarly to minimized windows. If you click a hidden window from the window preview, the owning application will be marked as unhidden, and that window will be brought to the front.
More changes to update page @ShlomoCode

v1.0.13 - 2024-07-04

Changelog

New features:

Feat: add quit app button to preview window (#51) @ShlomoCode
Feat: change sizingMultiplier setting without restarting the app (#50) @ShlomoCode

Misc.

Update page overhaul
Fixes title UI inconsistencies for small window sizing
Moves window title to bottom
Update README.md documentation for new traffic light button
Fixes jagged gradient animation
Fully finish transition to ScreenCaptureKit in preparation for macOS Sequoia (remove CoreGraphics usage)
Removes unnecessary ".00" in Window Cache Lifespan
Enhances window filtering for certain applications (issue 1 issue 2)

v1.0.12 - 2024-07-02

Only shows window's title when you hover over the window
Reduces animations to make it feel more polished
Customizable screenshot caching timer (you can set it to 0 so window previews are always fresh)
Adds support for maximizing a window from the window preview (thanks to @ShlomoCode)
Migrates screenshot manager to new ScreenCaptureKit API to prevent deprecated warning in macOS sequoia

What's upcoming?

Full size window previews on hover
Window switcher keybind customization
Homebrew releases

v1.0.11 - 2024-06-30

Adds window title to window previews
Adds ability to minimize window via window previews
Hides window when dock icon is clicked
Hides window when dock item is right clicked
UI tweaks
Sets minimum width for settings pane to fix jagged resizing (thanks @ShlomoCode)
Fixes button to open recording preferences (thanks @ShlomoCode)

v1.0.10 - 2024-06-30

Adds option to disable menu bar icon

Note: When DockDoor initially opens, the menu icon will be visible for 10 seconds, until it disappears. This way, you can access the settings even with the icon disabled. Just relaunch the app and click it before it disappears if you need to change some settings.

v1.0.9 - 2024-06-30

Adds option to disable window switcher entirely (so you can use more mature apps, like AltTab, alongside DockDoor) - thanks @hasansultan92

v1.0.8 patch (v1.0.7patch2) - 2024-06-27

Patches the tab menu incorrectly showing desktop widgets

v1.0.7 patch - 2024-06-26

Fixes window buffer being on the wrong axis while the dock is on the bottom
Better memory management code

v1.0.6 - 2024-06-26

Fixes localized apps not showing their windows
Adds option "window buffer" which can be used to tweak the hover window location (if it's too far away, for example)
Adds donation link in settings

v1.0.5 - 2024-06-25

Quick patch to fix window previews for chromium browsers

v1.0.4 - 2024-06-25

Introduces minimized window support. Minimized windows will show up in a little box which will show you all of the hidden windows for that given application. It is scrollable (horizontally if the dock is on the left or right, vertically if on bottom.)
Hopefully remedies the selected window not being brought to front in browsers
UI Tweaks

v1.0.3 - 2024-06-24

Adjustments to app text label UI (you can now read it)
Added option to delay hover window opening, up to 2 seconds
Added option to disable the hover window sliding animation

v1.0.1 - 2024-06-23

This release is a quick patch to (hopefully) fix DMG notarization.

v1.0 (releases) - 2024-06-23

v1.0