Keyboard Shortcuts¶

HistorySync provides 25 configurable shortcuts — one global hotkey and 24 in-app bindings. All of them can be changed in Settings → Keyboard Shortcuts.

Global Hotkey¶

This shortcut works system-wide — it fires even when HistorySync is in the background or minimised to the tray.

Action	Default	Notes
Open Quick-Access Overlay	`Ctrl`+`Shift`+`H`	Summons / hides the Spotlight-style search overlay

Linux / Wayland

Global hotkeys via pynput are not supported on Wayland. Use --quick with a system-level key binding as a workaround:

# Bind this command to a system shortcut in your DE settings
python -m src.main --quick

macOS

The first time the global hotkey fires, macOS will ask for Accessibility permission. Grant it in System Settings → Privacy & Security → Accessibility.

In-App Shortcuts¶

These shortcuts are active when the HistorySync window is focused.

Current Defaults¶

Category	Defaults
Page navigation	Dashboard `Ctrl`+`1`, History `Ctrl`+`2`, Bookmarks `Ctrl`+`3`, Settings `Ctrl`+`4`, Logs `Ctrl`+`5`, Statistics `Ctrl`+`6`
Global actions	Sync now `Ctrl`+`R`, Focus search `Ctrl`+`F`
History page	Open selected `Enter`, Delete selected `Delete`, Copy URL `Ctrl`+`C`, Copy title + URL `Ctrl`+`Shift`+`C`, Toggle bookmark `Ctrl`+`B`, Add note `Ctrl`+`N`, Open export `Ctrl`+`E`, Hide selected unassigned by default
Bookmarks page	Open `Enter`, Copy URL `Ctrl`+`C`, Delete `Delete`, Add note `Ctrl`+`N`, Locate in history `Ctrl`+`L`
Statistics page	Previous period `Alt`+`Left`, Next period `Alt`+`Right`
Settings page	Save `Ctrl`+`S`

The settings dialog is the source of truth. Blank shortcuts are intentionally left unassigned until you bind them.

Customising Shortcuts¶

Go to Settings → Keyboard Shortcuts.
Click the shortcut you want to change.
Press the new key combination.
Click Save.

To disable a shortcut, click it and press Backspace or Delete to clear it.

Conflicts

If two actions share the same key combination, the most recently set one wins. The Settings dialog will show a warning icon for conflicts.

Quick-Access Overlay Shortcuts¶

These shortcuts work inside the overlay (the Ctrl+Shift+H panel):

Action	Key
Navigate results	`↑` / `↓`
Open selected URL	`Enter`
Open in new tab (if browser supports it)	`Ctrl`+`Enter`
Dismiss overlay	`Esc`
Clear search	`Ctrl`+`A` then `Delete`