Skip to content
Lanterna

Usage

Basic operation, filtering, window actions, links, and troubleshooting

  1. 01 Hold⌘Keep holding Cmd
  2. 02 StepTab× nPress Tab for the next window
  3. 03 Release⌘Release Cmd to switch
⌘Tab Shows the switcher. Keep holding Cmd and press Tab to move, then release Cmd to switch.
⇧⌘Tab Moves in the reverse direction.
  1. 01 Open⌘SpaceOpen in filter mode
  2. 02 TypeA–ZType to narrow the list
  3. 03 Switch↩Switch to the chosen window
⌘Space Shows the switcher in filter mode. In this mode, releasing Cmd does not close it. Pressing it in a switcher opened with Cmd+Tab switches that switcher to filter mode.
A–Z Keeps only the rows whose app name or window title contains what you typed. Case is ignored.
↑↓ Moves the selection.
↩ Switches to the chosen window.
⌫ Deletes one character.
esc Clears what you typed. With nothing typed, closes the switcher.

While the switcher is up, hold Cmd and press one of these keys to act on the chosen row. The switcher stays up and the list updates in place.

⌘W Closes the window.
⌘Q Quits the app.
⌘H Hides the app.
⌘M Minimizes the window.

Hidden apps and minimized windows move below a separator in the list. If an action fails, the list goes back to how it was and a short note appears. You cannot act on Lanterna’s own row.

Cmd+Tab shortcuts are not restored after a crash

Section titled “Cmd+Tab shortcuts are not restored after a crash”

Lanterna takes Cmd+Tab and Shift+Cmd+Tab away from the system while it runs and gives them back when it exits. After kill -9 or a crash it cannot give them back, so both shortcuts stay off until something else restores them.

Check that no Lanterna is running before doing anything else. Restoring turns the shortcuts back on without reading their current state, so running this while another Lanterna is up takes the shortcuts away from that process. Running more than one at a time is not supported.

Terminal window
pgrep -x Lanterna # expect no output; run `pkill Lanterna` first if there is any

Then start Lanterna again and stop it cleanly, so its shutdown restores the shortcuts.

Terminal window
/Applications/Lanterna.app/Contents/MacOS/Lanterna &
sleep 1
pkill Lanterna

If the shortcuts are still off after that, log out and back in. The system’s assignment is per login session.

Check that Accessibility and Input Monitoring are granted (see the Guide), then relaunch Lanterna.

If these steps do not fix the problem, please open a bug report using the Bug report template.