Shortcuts

Keyboard Shortcuts and Mouse Gestures

A quick reference for every shortcut OpenHPSDR Zeus understands. Most shortcuts work only when connected to a radio. The shortcut handlers are wired up in zeus-web/src/util/use-keyboard-shortcuts.ts.

Keyboard

Key	Action
← / →	Nudge VFO ±500 Hz. Coalesces to one POST per animation frame, so holding the key produces smooth tuning.
↑ / ↓	Zoom panadapter in / out one integer step (zoom range is 1×–8×).
Space (hold)	Engage MOX (transmit). Release to return to RX. Uses key-repeat detection so holding it doesn't spam the backend.
Enter	Commit a text field (frequency, custom bandwidth, callsign).
Escape	Cancel a text field edit.
Tab	Move to next focusable field.

There is no Mode-cycle, Band-cycle, Mute-toggle, or /-to-focus-QRZ shortcut at present. Those are click-only.

Mouse and trackpad on the panadapter / waterfall

Gesture	Action
Click	Tune VFO to the clicked frequency (snaps to the nearest 500 Hz).
Click + drag (no modifier)	Pan the spectrum view (3 px slop before drag is recognised, so a small jitter is treated as a click-to-tune).
Wheel (scroll)	Tune VFO in 500 Hz notches (40 px per notch).
Alt + drag	Pan the world map behind the panadapter. The spectrum canvas goes pointer-events: none while Alt is held, so click-to-tune is paused.
Alt + wheel	Zoom the world map.

The previous wiki said "hold M to enter map mode". That was wrong — the map modifier is Alt (e.altKey), not the M key. There is no M binding in the code.

Mouse on the VFO digits

Gesture	Action
Click	Flip to text-entry mode. Type a frequency in kHz (so 14200 for 14.200 MHz). Comma is also accepted as a decimal separator (14200,5). Range clamped to 0–60 MHz.
Wheel on a digit	Step that decade up / down. Scrolling on the 10-kHz digit changes the VFO by 10 kHz per notch. POST is debounced 80 ms after the last wheel event.

Mouse on the bandwidth visualiser

Gesture	Action
Drag a handle (LOW CUT or HIGH CUT)	Resize the passband from one edge.
Drag inside the passband	Slide the whole passband without changing its width.

Preset click-through paths

• Mode change updates the list of offered preset bandwidths and the filter bank, then snaps the passband to the most appropriate preset for the new mode.
• Band button jumps to that band's last-used (frequency, mode) pair (band memory, debounced 500 ms on save).
• SP / LP chips (visible in the panadapter header when QRZ is engaged) copy the short-path / long-path bearing into the BEAM input so you can press Go.

Shortcut etiquette

• Avoid holding Space while a text field has focus — the field will capture it and you'll type a literal space character instead of keying MOX. Click away from the field first.
• The radio reverts to RX as soon as Space is released, so don't worry about getting "stuck" in TX from a held key.