Changelog
Every release of Superkeys. Installed copies update themselves; this is what changed.
0.2.13
Fixed
- ✦ chords work in password fields and in terminals with Secure Keyboard Entry on. macOS hides key presses from other apps there, so ✦ V typed a plain "v" instead of sending ⌃ V to open your clipboard history. While a password field has focus, Caps Lock stands in as Control, which macOS lets through; key groups and ✦ ⇧ arrows don't work there yet.
- What's New shows ✦, arrows and other symbols as they are, instead of garbled characters like "✦".
0.2.12
Fixed
- With a display above or below the laptop's, ✦ ← / → now walk the window onto it when there's no display to that side. Before, they only looked for displays to the side, so nothing happened.
- ✦ ← / → move terminals such as Ghostty on to the next display. Terminals size themselves in whole rows, so they never counted as snapped and each press just snapped them again.
Removed
- ✦ ⌥ ← / →. ✦ ← / → already take the window to the next display, so there's one less chord to learn.
0.2.11
Fixed
- An app's ✦ key now takes you to it when its windows are on a desktop you're not looking at, on any display: that display switches to the app's desktop and the app comes forward. Before, nothing happened.
0.2.10
Fixed
- On macOS 14 and 15, ☾ with a number opened Mission Control but never added the missing desktop. Superkeys now finds Mission Control wherever macOS draws it.
0.2.9
Fixed
- ☾ could stop working after a keyboard reconnected (waking from sleep, a Bluetooth keyboard coming back) while ✦ carried on. Superkeys now puts right ⌘ back to ☾ as soon as a keyboard appears.
0.2.8
Added
- Several windows of one app? Press its key again (✦ 2, 2, 2…) to bring each of its windows forward in turn, or ☾ ↩ for whichever app is in front. Covers the windows on the desktops you can see.
- Copy Diagnostics in Settings → Advanced: versions, whether the keys are on, how many app keys you have and which keyboards are connected, for a problem report. Report a Problem fills it in for you. Never which keys you use or anything typed.
Changed
- If the app in front stops responding, a window chord now gives up after a second instead of six, so your typing never stalls behind it.
- Snapping is smoother in apps that animate each resize step while an assistive app is on (Chrome and Electron apps with VoiceOver, for example).
- What's New ends with a short thank-you to Superkeys' sponsors.
0.2.7
Added
- Suggest a Feature and Report a Problem in Settings → General open a short form on GitHub. A problem report fills in your Superkeys and macOS versions and your Mac's model.
- Superkeys is open source under the GNU GPL v3. View Source in Settings → General, next to Sponsor.
Changed
- The welcome tour opens with "Your whole Mac, one key away."
0.2.6
Changed
- Single-letter keycaps use the system font, so ✦ O no longer looks like ✦ 0.
- The welcome tour opens with "Caps Lock and right ⌘, finally useful."
- Config files written before keystrokes existed gain a commented
[keys]section, so a keystroke added by hand lands in the right place. brew uninstall --zap superkeysalso removes~/.config/superkeys.
0.2.5
Added
- Key groups. Out of letters? ✦ O then P can open 1Password while ✦ O then S opens Slack, for apps and keystrokes alike. The first key keeps its own job: ✦ O on its own runs when you let go of ✦, so single keys stay instant and groups never need a timeout. Hold a moment after the first key and a panel shows what's in the group; Esc cancels. Record the second key with "+ then…" in Settings (a first key that's already taken, like ✦ G for your browser, can still start a group), or write
"O P"in the config file. Settings lists each group together, its second keys indented under the first. - The ✦ chord panel now lists your keystrokes too, not only your apps.
- The welcome tour's app step mentions groups.
Changed
- Tidier Shortcuts lists: apps line up on the left, keys on the right in one column, and keystrokes show what they send at the right edge. The Keys tab no longer links to Shortcuts.
0.2.4
Added
- Keystrokes. ✦ plus a key can now send another key combination to the app in front: ✦ C → ⌃ C to stop a command in the terminal, ✦ R → ⌃ R to search history, or anything like ⌘ ⇧ T. Holding the key repeats it. Add them in Settings → Shortcuts (the Apps tab is now Shortcuts again, with Apps and Keystrokes; Add All Three sets up ✦ C / D / R for the terminal in one click) or under
[keys]in the config file. The welcome tour gains a fifth step that offers the same three.
0.2.3
Added
- Config file. Your app keys and preferences now live in
~/.config/superkeys/config.tomlas well, kept in step both ways: change something in Settings and the file is updated; edit and save the file and Superkeys applies it right away. Keep it in your dotfiles to carry your setup to another Mac. Settings → Advanced opens it and points out any line it couldn't use; a file with a mistake in it is never half-applied or overwritten.
Changed
- A shorter menu. The menu bar menu is down to the on/off switch, Settings and Quit, plus a fix-it item when something needs attention. The version, What's New (with a dot after an update), Check for Updates and the welcome tour are in Settings → General; Reset Access is in Advanced.
- Tidier Settings. General is down to the essentials; the list of chords moved to a new Keys tab, Shortcuts is now Apps, and a new Advanced tab holds the config file and Reset Access.
Removed
- Import and Export in Settings, replaced by the config file.
0.2.2
Added
- Welcome tour for new users. A short, hands-on setup on first launch: grant Accessibility, hold Caps Lock and watch it light up, pick keys for the apps you use most (each suggested on its first letter, or a number when that letter is taken), and try ☾ for desktops. Move through it with the buttons or with ✦ ← / →, which is also how it teaches the chord; keyboard drawings show exactly where Caps Lock and the right ⌘ are, and light up when you press them. Take it again any time from the menu bar (Welcome Tour…) or Settings → General.
0.2.1
Changed
- Nothing runs while you're idle. The helper that restores Caps Lock after a crash used to check every two seconds; it now sleeps until Superkeys actually exits, and restores the keys within a fraction of a second instead of up to two.
- Desktop chords read the list of desktops once instead of several times.
- Less memory after closing Settings. The Settings window, the installed-apps list and its icons, and the chord panel are now released when closed instead of kept for the life of the app, and the app list no longer caches every scanned app's bundle.
- The app picker shows apps by the name Finder uses (for example "Visual Studio Code" rather than "Code").
- The chord panel's snap line is shorter, so it no longer gets cut off.
0.2.0
Added
- Multiple displays. ✦ ← / → snap to a half, and pressed again at the edge walk the window onto the neighbouring display's facing half. ✦ ⌥ ← / → move the window to the next display as it is. ✦ ↩'s restore works across displays.
- Desktops per display. ☾ 1–9 switch the display under the pointer, ☾ ⇧ 1–9 move a window within its own display, and ☾ right ⌥ remembers the previous desktop separately for each display. The chord panel shows one row of desktops per display. Settings → Permissions checks that "Displays have separate Spaces" is on when more than one display is connected.
- Caps Lock is never left dead. If Superkeys crashes or is force-quit, Caps Lock and right ⌘ go back to normal right away instead of staying remapped until the next launch.
- "Keys aren't working" is visible and fixable. The menu bar logo shows an orange dot when the keys should be on but aren't, and Settings and the menu offer Reset Access for the case where the Accessibility switch looks on but macOS is holding an old entry.
- What's New after an update, in the menu until you've read it once.
- Try it: right after setup, General asks you to hold Caps Lock and confirms it works.
- Superkeys and Superkeys Dev (a development build) no longer run at the same time; launching one offers to quit the other.
Fixed
- ☾ ⇧ 1–9 moves windows again. A recent macOS change made it ignore the drag Superkeys uses to carry a window to another desktop; 0.1.x switched desktops but left the window behind.
- Moving a wide window no longer grabs a toolbar button instead of the title bar.
- New desktops are always added to the right display, and never more than needed.
Changed
- New app icon: the moon-and-stars mark on a dark keycap, matching the menu bar and superkeys.space. Development builds get an indigo "DEV" version.
- The privacy note now mentions the once-a-day update check, which sends nothing but the app's version.
- Pressing ✦ ← or ✦ → again no longer restores the window's previous frame; ✦ ↩ still does.
0.1.2
Added
- The menu bar menu shows which version of Superkeys is running.
0.1.1
Added
- Updates install themselves. Superkeys checks superkeys.space once a day and installs new versions in the background, with no Gatekeeper prompt and without losing Accessibility access. Turn it off, or check now, in Settings → General; "Check for Updates…" is also in the menu bar menu. Every update is verified against a signing key before it's installed.
Changed
- Releases are signed as "Superkeys" instead of "Hypercaps Dev". Coming from 0.1.0, grant Accessibility once more after upgrading; later updates keep it.
0.1.0
The first build anyone can install. It isn't signed with an Apple Developer ID or notarised yet, so macOS asks you to approve it once on first launch (see the README).
Added
- ✦ Hyper Key on Caps Lock and ☾ Meh Key on right ⌘: private keys that never type, lock, or reach other apps. Everything pressed while one is held is caught.
- Open apps with ✦ plus any key you assign.
- Snap windows: ✦ ← / → for halves, ✦ ↩ to fill the screen and again to restore.
- Arrange windows with ✦ ↑: 2 side by side, 3 as one large and two stacked, 4 as quarters; again to undo. ✦ ⇧ arrow swaps a window with its neighbour. With five or more windows nothing moves and the menu bar icon shakes with the count.
- Desktops: ☾ 1–9 switches (creating desktops that don't exist yet), ☾ ⇧ 1–9 moves the window there and follows it, ☾ right ⌥ flips back to the previous desktop.
- Chord panel: hold ✦ or ☾ for a moment to see everything that key does, on Liquid Glass where available.
- Settings file: export and import app keys and preferences as readable JSON.
- Superkeys' own Settings window snaps and arranges like any other window.
- Menu bar logo that lights amber for ✦ and indigo for ☾ while held.