Skip to content

About

Dropdown windows for any Mac app on a global hotkey. Quake-style toggle for Terminal, Finder, Safari, or anything else. The macOS sibling of plasma-drop, and it reads the same TOML config.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Repository files navigation

quartz-drop

quartz-drop icon

CI Release License: GPL-3.0-or-later KDE Plasma: plasma-drop

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.

Demo: Ctrl-Option-1 drops Dictionary into the left half, Ctrl-Option-2 drops Font Book into the right half and hides Dictionary
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

What you get

  • 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.
Screenshots

Settings, General tab: config file, launch at login, menu bar icon Settings, Apps tab: configured apps with their hotkeys, matchers and placement Settings, Permissions tab: Accessibility access granted About window with version, commit and license

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.

Install

You need macOS 13 (Ventura) or newer. Builds are universal, so they run on both Apple silicon and Intel Macs.

  1. Download the .zip from the latest release.

  2. Unzip it and move QuartzDrop.app to your Applications folder.

  3. 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-drop

With packslip (1.5.1 or newer), which checks the release signature before installing:

packslip install github.com/SkeLLLa/quartz-drop --pin ps1_3lbhdizx3fdmmm5ki37kzixcwy

From 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.

Uninstall

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.

First run

  1. Open QuartzDrop. It creates a starter config and opens its Settings window.

  2. When asked, allow quartz-drop in System Settings → Privacy & Security → Accessibility. It needs this permission to move and resize other apps' windows.

  3. Try a hotkey from the starter config:

    Hotkey App
    ⌃⌥F Finder, left half
    ⌃⌥S Safari, right half
    ⌃` Terminal, top of screen
    ⌃⌥N Notes
  4. 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.

Configure

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.

Coming from plasma-drop?

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.

Alternatives

  • 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

Contributing

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, tests

All documentation: Getting started · Configuration · Distribution · Development · Roadmap

Support Ukraine

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.

Come Back Alive Sternenko Fund Prytula Foundation

The same links are in the menu bar menu and in Settings → General.

License

GPL-3.0-or-later. See COPYING.

About

Dropdown windows for any Mac app on a global hotkey. Quake-style toggle for Terminal, Finder, Safari, or anything else. The macOS sibling of plasma-drop, and it reads the same TOML config.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages