/
Customizing keyboard shortcuts
Available in version 3.4 or later.
You can add new keyboard shortcuts or re-assign existing shortcut to a different
command.
To customize keyboard shortcuts:
- use
Settings / Advanced Options... menu (or Ctrl + K Command Palette, type adv to narrow down and select Advanced Options... command)
- this opens a notepad with advanced settings file
- find
Shortcuts array and add new shortcut definitions
An example of customization:
Shortcuts [
[
Cmd = CmdOpen
Key = Alt + o
]
[
Cmd = CmdNone
Key = q
]
[
Name = Create green highlight
Cmd = CmdCreateAnnotHighlight #00ff00 openedit
Key = a
]
[
Cmd = CmdNextTab
ToolbarText = Next Tab
]
]
Explanation:
- by default SumatraPDF has
Ctrl + O shortcut for CmdOpen (open a file) command. This changes the shortcut to Alt + o
- by default
q closes the document. By binding it to CmdNone we can disable a built-in shortcut
- ver 3.6+::
CmdCreateAnnotHighlight takes a color argument (#00ff00 is green) and boolean openedit argument. We re-assign a to create a highlight annotation with green color (different from default yellow) and to open annotations edit window (openedit boolean argument)
- ver 3.6+::
Name is optional. If given, the command will show up in command palette (Ctrl + K)
- just a key (like
a, Z, 5) i.e. letters a to z, A to Z, and numbers 0 to 9
- modifiers + key. Modifiers are:
Shift, Alt, Ctrl e.g. Alt + F1, Ctrl + Shift + Y
- there are some special keys (e.g.
Alt + F3)
F1 - F24
numpad0 - numpad9 : 0 to 9 but on a numerical keyboard
Delete, Backspace, Insert, Home, End, Escape
Left, Right, Up, Down for arrow keys
- full list of special keys
- without modifiers, case do matter i.e.
a and A are different
- with modifiers, use
Shift to select upper-case i.e. Alt + a is the same as Alt + A , use Alt + Shift + A to select the upper-case A
Commands #
Notes #
The changes are applied right after you save settings file so that you can test changes without restarting SumatraPDF.
If a custom Shortcut doesn’t work it could be caused by invalid command name or invalid command arguments.
We log information about unsuccessful parsing of a shortcut so
check the logs if things don’t work as expected.