Dropdown windows for any Mac app, on a hotkey.
Press a shortcut and Terminal (or Finder, Safari, Notes, anything you like) appears in its spot, say the left half of the screen, already focused. Press it again and it's gone. If the app isn't running, quartz-drop starts it first. Think of a Quake-style dropdown terminal, but for every app you use.
Two apps on two hotkeys, left and right half (watch as video)
Setting up with an AI assistant? Point it at
README.ai.md. It contains step-by-step instructions written for agents.
Contents: Install · First run · Configure · Alternatives · Contributing · Support Ukraine
- One hotkey per app. It shows the app, focuses it, and hides it again.
- Your layout, every time. Each app goes to the same place: a half, a corner, a fixed size, a particular display.
- One at a time. Showing one app hides the others, so they never pile up.
- Starts what's missing. Press the hotkey for an app that isn't open and it opens.
- Leaves no mess. On quit, every window goes back where it was.
- Quiet. No Dock icon. There's a small menu bar icon, and you can hide that too.
- A plain text config. One TOML file that reloads as soon as you save it.
quartz-drop is the macOS version of plasma-drop for KDE Plasma, and reads the same config.
Note
quartz-drop was converted from plasma-drop (Rust, KDE Plasma) to Swift and macOS with AI assistance.
You need macOS 13 (Ventura) or newer. Builds are universal, so they run on both Apple silicon and Intel Macs.
-
Download the
.zipfrom the latest release. -
Unzip it and move
QuartzDrop.appto your Applications folder. -
If macOS says the app can't be opened, run this once in Terminal:
xattr -dr com.apple.quarantine /Applications/QuartzDrop.app
You need this because the releases aren't notarized by Apple. They are signed with quartz-drop's own certificate, so macOS keeps the Accessibility permission across updates (details).
Other ways to install
These put the quartz-drop command on your PATH. Running it starts the app.
With mise (2026.9.2 or newer):
mise use -g packslip:github.com/SkeLLLa/quartz-dropWith packslip (1.5.1 or newer), which checks the release signature before installing:
packslip install github.com/SkeLLLa/quartz-drop --pin ps1_3lbhdizx3fdmmm5ki37kzixcwyFrom source, with mise and the Xcode Command Line Tools:
mise run bundle-universal
rm -rf /Applications/QuartzDrop.app # quit quartz-drop first when upgrading
cp -R dist/QuartzDrop.app /Applications/Homebrew isn't available yet. If you'd like to help, see the roadmap.
Quit quartz-drop and turn off Launch at login in Settings → General first, then:
| Installed with | Remove with |
|---|---|
| Release download | Delete /Applications/QuartzDrop.app |
| mise | mise unuse -g packslip:github.com/SkeLLLa/quartz-drop |
| packslip | rm ~/.local/bin/quartz-drop, then delete the tree it linked to under ~/.local/share/packslip/ |
Your config in ~/.config/quartz-drop stays until you delete it. To clear the permission too,
remove QuartzDrop from System Settings → Privacy & Security → Accessibility.
-
Open QuartzDrop. It creates a starter config and opens its Settings window.
-
When asked, allow quartz-drop in System Settings → Privacy & Security → Accessibility. It needs this permission to move and resize other apps' windows.
-
Try a hotkey from the starter config:
Hotkey App ⌃⌥F Finder, left half ⌃⌥S Safari, right half ⌃` Terminal, top of screen ⌃⌥N Notes -
To change them, choose Open Config from the menu bar icon. Changes apply when you save.
Want it running all the time? Turn on Launch at login in Settings → General.
Tip
If hotkeys stop moving windows after an update (for example the first update from an older ad-hoc signed release, or a build of your own), remove QuartzDrop from the Accessibility list and add it again.
More on settings, the menu bar menu, the command line and hotkey conflicts is in Getting started.
The config is ~/.config/quartz-drop/config.toml. Each [[app]] block is one app:
[[app]]
name = "finder"
hotkey = "ctrl+alt+f"
bundle_id = "com.apple.finder"
[app.placement]
width = "50%"
height = "100%"
position = "left"To find an app's bundle_id, run osascript -e 'id of app "Safari"'.
The starter config has more examples, and Configuration lists every option.
Copy your config.toml to ~/.config/quartz-drop/ and it loads unchanged. Linux-only options
are skipped, and Settings lists them. Then point filename or bundle_id at the Mac versions of
your apps. See Using a plasma-drop config.
- Hammerspoon: scriptable in Lua, can do all of this with code
- Rectangle: window layout only, no app toggling
- Thor and rcmd: hotkeys to switch apps, no placement
- iTerm2 hotkey window: dropdown behavior for a single app
Ideas, bug reports and pull requests are welcome. The roadmap lists what's missing, such as window animations and a Homebrew tap, and Development explains how to build and test:
mise run check # everything CI runs: lint, build, testsAll documentation: Getting started · Configuration · Distribution · Development · Roadmap
If quartz-drop is useful to you and you want to say thanks, please consider supporting Ukrainian
defenders instead of sending money to the author.
The same links are in the menu bar menu and in Settings → General.
GPL-3.0-or-later. See COPYING.



