Keyboard and the palette

Everything Mirada does can be done without the mouse. Every command has one name and at most one key, declared once in the app, so the palette, the right-click menu, the Mac’s menu bar and the Keyboard Shortcuts window (Ctrl+?) always agree. The Keybindings page lists them all.

How the keys are chosen

  • Bare keys for looking. An image viewer has no text to type into, so stepping, zooming, turning and the panels are single keys: arrows, +, R, I, T. Several are GNOME Image Viewer’s.
  • Ctrl for files and windows: Open, Copy, Close, Settings. ⌘ on a Mac.
  • A Mac has its own for a few, because its keyboard has no forward Delete and its function keys are brightness and volume: ⌘⌫ moves to the Trash, Return renames, ⌘I shows the properties, ⌘R and ⌘L rotate and ⌃⌘F is full screen, as in Preview and Finder. Mirada’s own keys work there too, and Backspace alone always steps back: it never deletes anything.

The command palette

Ctrl+Shift+P, Alt+X (Emacs’s M-x) or F1 opens it; ⇧⌘P, ⌥X or F1 on a Mac. It lists every command by name, with its key, and the highlighted one’s description underneath. Type to narrow the list: letters match in order, not necessarily together, so kz finds Keep Zoom When Stepping. A command that cannot run right now, such as Next Image on the last image, is greyed, with the reason.

Inside the palette:

KeyDoes
↑ ↓, or Ctrl+P Ctrl+NMove the selection a row
Page Up Page Down, or Alt+V Ctrl+VMove by a page
Ctrl+Home Ctrl+End, or Alt+< Alt+>The first and the last row
EnterRun the selected command
Esc or Ctrl+GClose

The text field takes Emacs’s editing keys as well: Ctrl+A and Ctrl+E to the ends, Ctrl+F and Ctrl+B a character, Alt+F and Alt+B a word, Ctrl+K to cut to the end, and Ctrl+Y to paste. It is the same palette as Editora’s and Termina’s, with the same matching.

Go to Image and Open Recent

The palette also lists images and folders. Go to Image… (Ctrl+P) opens it over the folder’s file names, and Open Recent… (Ctrl+Shift+O) over the last ten folders. See The folder.

Changing the palette’s keys

The keys that open the palette are yours to choose: Settings → Keys → Command palette. Add a key…, then press it; pressing one that is already there takes it off; Default puts the three back. A key you choose there wins over whatever it did before, so you can give the palette Space or P if you would rather.

They are kept in settings.properties as palette.keys, in Emacs-style tokens, which you can edit by hand:

palette.keys=C-S-p M-x f1

C- is Ctrl, S- Shift, M- Alt (Option on a Mac) and Cmd- ⌘. A key the palette uses to move its selection, such as Ctrl+P, stays the palette’s while it is open. A setting with no key Mirada can read is the default again, so a bad edit never leaves the palette without a way in.