shortcuts.md

ImageTagger Keyboard Shortcuts

Navigation: Project README | Docs Index

This page lists all keyboard shortcuts currently wired in the application code.

Platform Legend

• Win/Linux: Windows and Linux default mapping.
• macOS: Native macOS mapping.
• Option on macOS is the same physical modifier as Alt.

Main Window

Action	Win/Linux	macOS	Where
Select all visible images	Ctrl+A	Command+A	Image list
Select previous image	Alt+Up	Option+Up	Anywhere in main window
Select next image	Alt+Down	Option+Down	Anywhere in main window
Jump to first fixup	Alt+F	Option+F	Image list
Jump to last fixup	Alt+L	Option+L	Image list
Remove selected tag	Delete or Backspace	Delete or Backspace (Fn+Delete on some keyboards)	Tag list
Purge tag(s) from entire dataset	Delete or Backspace	Delete or Backspace (Fn+Delete on some keyboards)	Global Tags list (Controls panel) — supports multi-selection via Shift-click / Ctrl-click; shows confirmation dialog before writing
Open folder	Ctrl+L	Command+O	File menu
Refresh folder	Ctrl+R	Command+R	File menu
Exit app	Ctrl+Q	Command+Q	File menu
Increase font	Ctrl++ / Ctrl+=	Command++ / Command+=	Edit menu
Decrease font	Ctrl+-	Command+-	Edit menu
Generate	Alt+G	Option+G	AutoTag tab active
Stop batch (generation or validation)	Alt+S	Option+S	AutoTag tab active, while generation or validation is in progress
Validate	Alt+V	Option+V	AutoTag tab active
Open Fixup dialog	Alt+X	Option+X	AutoTag tab active
Focus tag input	Alt+T	Option+T	AutoTag tab active

Merge Dialog

Action	Win/Linux	macOS	Where
Remove selected existing tags	Delete or Backspace	Delete or Backspace (Fn+Delete on some keyboards)	Left/current list
Merge and next	Alt+Enter (also Alt+Return)	Option+Enter (also Option+Return)	Dialog action + Merge and Next button (suppressed when edit boxes have focus or a comparison-table cell editor is active, except when quick-add tag input is focused and empty)
Focus quick-add tag input	Alt+T	Option+T	Dialog action
Undo merge/local changes	Ctrl+Z	Command+Z	Dialog action + Undo button
Previous actionable row	Alt+Up	Option+Up	Dialog action
Next actionable row	Alt+Down	Option+Down	Dialog action
Accept all proposed rows and merge	Alt+A	Option+A	Accept button
Regenerate proposed annotations	Alt+R	Option+R	Regenerate button
Previous image	Alt+Left	Command+[	Prev button
Next image	Alt+Right	Command+]	Next button

Merge Dialog Keyboard Behaviors (No Dedicated Shortcut Registration)

Behavior	Win/Linux	macOS
Move row selection	Up/Down arrows	Up/Down arrows
Jump to first comparison row	Home	Home, Fn+Left, or Command+Up
Jump to last comparison row	End	End, Fn+Right, or Command+Down
Apply proposed value for selected row	Left arrow (default dialog intent; suppressed while a dialog text input has focus)	Left arrow (default dialog intent; suppressed while a dialog text input has focus)
Trigger current row action	Enter/Return	Enter/Return
Delete selected current rows	Delete or Backspace	Delete or Backspace (Fn+Delete on some keyboards)

Windows vs Linux Differences

No application-defined shortcut differences between Windows and Linux.

Notes:

• Some Linux desktop/window-manager configurations reserve certain Alt+... combinations globally.
• If that happens, the shortcut may be intercepted before ImageTagger receives it.