You can control SumatraPDF with commands:
- use command palette (
Ctrl + K) to invoke a command by its description - customize a keyboard shortcut to invoke a command by its id
- ver 3.5+: send a command via DDE e.g.
[CmdClose]to invokeClose Documentcommand - ver 3.6+: some commands accept arguments
Find command:
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
File #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdClose
|
Ctrl + W, Ctrl + F4
|
Close Document |
CmdCloseCurrentDocument
|
q
|
Close Current Document |
CmdCommandPalette
|
Ctrl + K
|
Command Palette |
CmdCommandPaletteTOC
|
Shift + F12
|
Command Palette: Table Of Contents |
| Jump to a table of contents entry of the current document, ver 3.7+ | ||
CmdCommandPaletteFavorites
|
Command Palette: Favorites | |
| Jump to a favorite, ver 3.7+ | ||
CmdDuplicateInNewWindow
|
Shift + Ctrl + N
|
Open Current Document In New Window |
CmdDuplicateInNewTab
|
Open Current Document In New Tab | |
| ver 3.6+ | ||
CmdExit
|
Ctrl + Q
|
Exit Application |
CmdMoveFrameFocus
|
F6
|
Move Frame Focus |
CmdNewWindow
|
Ctrl + N
|
Open New SumatraPDF Window |
CmdOpenFile
|
Ctrl + O
|
Open File... |
| uses the Windows file picker or Navigate Files in Folder according to the `FilePicker` advanced setting (empty/os = Windows, sumatrapdf = in-app), ver 3.7+ | ||
CmdOpenFileNoHistory
|
Open File Without History... | |
| same picker as Open File, but the document is not added to File History or Windows Recent Documents (fixes #6121), ver 3.7+ | ||
CmdOpenFileWithOSFilePicker
|
Open File With Windows File Picker... | |
| always the standard Windows multi-select file open dialog, ver 3.7+ | ||
CmdToggleFilePicker
|
SumatraPDF File Picker | |
| checkbox under File and Settings; toggles `FilePicker` empty/os ↔ sumatrapdf, ver 3.7+ | ||
CmdToggleBoolSetting
|
Toggle Boolean Setting | |
| in the Command Palette, lists boolean advanced settings; Enter or a click toggles one and closes. Custom shortcuts: `CmdToggleBoolSetting |
||
CmdFixDefaultApp
|
Fix Default App For Extension | |
| `CmdFixDefaultApp .pdf` opens the OS dialog to set the default app for that extension; used by the home-page bottom bar when Sumatra is no longer the default, ver 3.7+ | ||
CmdOpenNextFileInFolder
|
Shift + Ctrl + Right
|
Open Next File In Folder |
CmdNavigateFilesInFolder
|
Shift + Ctrl + Up
|
Navigate Files in Folder |
| directory browser for openable files in the current file's folder (stays open; Enter/double-click replaces the current tab, Ctrl+Enter/Ctrl+double-click switches to the tab already showing the file or opens a new tab, Alt+Up goes to the parent directory, Del moves the selected file to the recycle bin, F5 re-reads the directory); also used when `FilePicker = sumatrapdf`, ver 3.7+ | ||
CmdOpenPrevFileInFolder
|
Shift + Ctrl + Left
|
Open Previous File In Folder |
CmdOpenSelectedDocument
|
Open Selected Document | |
CmdPinSelectedDocument
|
Pin Selected Document | |
CmdPrint
|
Ctrl + P
|
Print Document... |
CmdProperties
|
Ctrl + D
|
Document Properties... |
CmdReloadDocument
|
r
|
Reload Document |
CmdRenameFile
|
F2
|
Rename File... |
CmdReopenLastClosedFile
|
Shift + Ctrl + T
|
Reopen Last Closed |
CmdSaveAs
|
Ctrl + S
|
Save File As... |
CmdToggleCursorPosition
|
m
|
Toggle Cursor Position |
CmdShowInFolder
|
Show File In Folder... | |
| Explorer (selects the file), or Navigate Files in Folder when FilePicker = sumatrapdf, ver 3.7+ | ||
CmdToggleBookmarks
|
F12
|
Toggle Bookmarks |
CmdToggleTableOfContents
|
Toggle Table Of Contents | |
| ver 3.6+ | ||
CmdCollapseAll
|
Collapse All | |
| Bookmarks: collapse the outline; if there is only one top-level entry with children, expand it one level (Word-style TOC), ver 3.7+ | ||
CmdExpandAll
|
Expand All | |
CmdExpandToCurrentPage
|
Expand TOC to Current Page | |
| In the Bookmarks (table of contents) sidebar, expand the tree down to the entry for the current page and select it, ver 3.7+ | ||
CmdTocExpandToLevel1
|
Bookmarks: Expand to Level 1 | |
| Collapse the Bookmarks tree so only top-level entries are visible (context menu), ver 3.7+ | ||
CmdTocExpandToLevel2
|
Bookmarks: Expand to Level 2 | |
| Expand top-level Bookmarks once (context menu), ver 3.7+ | ||
CmdTocExpandToLevel3
|
Bookmarks: Expand to Level 3 | |
| Expand Bookmarks two levels deep (context menu), ver 3.7+ | ||
CmdTocCollapseSameLevel
|
Bookmarks: Collapse Same Level | |
| Collapse all Bookmarks siblings of the selected/clicked entry (same nesting level), ver 3.7+ | ||
CmdOpenEmbeddedPDF
|
Open Embedded PDF | |
CmdSaveEmbeddedFile
|
Save Embedded File... | |
CmdCreateShortcutToFile
|
Create .lnk Shortcut | |
CmdSelectAll
|
Ctrl + A
|
Select All |
CmdExtendSelectionCharLeft
|
Extend Selection One Character Left | |
| ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below) | ||
CmdExtendSelectionCharRight
|
Extend Selection One Character Right | |
| ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below) | ||
CmdExtendSelectionWordLeft
|
Extend Selection One Word Left | |
| ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below) | ||
CmdExtendSelectionWordRight
|
Extend Selection One Word Right | |
| ver 3.7+, no default shortcut; grows or shrinks the existing text selection (see below) | ||
CmdCopyComment
|
Copy Comment | |
CmdShowAnnotationText
|
Show Comment | |
| opens a read-only card with the annotation's whole text; also on a left click on the annotation, ver 3.7+ | ||
CmdCopyImage
|
Copy Image | |
CmdCopyLinkTarget
|
Copy Link Target | |
CmdCopySelection
|
Ctrl + C, Ctrl + Insert
|
Copy Selection |
| in Edit PDF mode with an annotation selected, copies that annotation instead of text | ||
CmdCopySelectionAsImage
|
Copy Selection As Image | |
| copy a rectangular selection as an image, ver 3.7+ | ||
CmdSaveSelectionAsImage
|
Save As Image... | |
| save a rectangular (Ctrl+drag) selection as PNG, JPEG or BMP at a chosen DPI, independent of the current zoom, ver 3.7+ (fixes #6127) | ||
CmdSearchGoogleLens
|
Search with Google Lens | |
| opens the selection, image under the cursor, or current page in Google Lens, ver 3.7+ | ||
CmdSearchGoogleLensPage
|
Search Page with Google Lens | |
| current page (or the page under the cursor from the context menu), ver 3.7+ | ||
CmdSearchGoogleLensImage
|
Search Image with Google Lens | |
| image under the cursor, ver 3.7+ | ||
CmdCopyFilePath
|
Copy File Path | |
| ver 3.5+ | ||
CmdDeleteFile
|
Delete Currently Opened File | |
| ver 3.6+ | ||
CmdDeleteFileAndOpenNext
|
Delete File And Open Next | |
| moves the current file to the Recycle Bin after the next file opens successfully, ver 3.7+ | ||
CmdShowGeneratedHTML
|
Show Generated HTML | |
| available for Markdown files; saves the generated HTML to a temporary .html file and opens it in Notepad, ver 3.7+ | ||
Search #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdFindFirst
|
Ctrl + F
|
Find |
CmdFindToggleMatchCase
|
Find: Toggle Match Case | |
CmdFindToggleMatchWholeWord
|
Find: Toggle Match Whole Word | |
CmdFindNext
|
F3
|
Find Next |
CmdFindNextSel
|
Ctrl + F3
|
Find Next Selection |
CmdFindPrev
|
Shift + F3
|
Find Previous |
CmdFindPrevSel
|
Shift + Ctrl + F3
|
Find Previous Selection |
Viewing #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdBookView
|
Ctrl + 8, Ctrl + Numpad 8
|
Book View |
CmdFacingView
|
Ctrl + 7, Ctrl + Numpad 7
|
Facing View |
CmdInvertColors
|
Shift + I
|
Invert Colors |
| was `i` before 3.6 | ||
CmdRotateLeft
|
[, Shift + Ctrl + Subtract
|
Rotate Left |
CmdRotateRight
|
], Shift + Ctrl + Add
|
Rotate Right |
CmdSinglePageView
|
Ctrl + 6, Ctrl + Numpad 6
|
Single Page View |
CmdToggleContinuousView
|
c
|
Toggle Continuous View |
CmdSelectTextViaKeyboard
|
F7
|
Select Text With Keyboard |
| ver 3.7+, caret browsing: puts a text caret in the page which the arrow keys move; Shift + arrows extend the selection, v toggles visual mode (arrows select without Shift), Home/End go to the line ends, Ctrl + Home/End to the document ends, Ctrl + arrows move by word, Ctrl + C or y copies, Esc or F7 leaves the mode. Not available for documents with no extractable text (fixes #4684, #4116) | ||
CmdToggleKeyboardLinkFollowing
|
Shift + F
|
Follow Link With Keyboard |
| ver 3.7+, labels visible links with Vimium-style letter hints; type a hint to follow its link, Esc or Shift + F again leaves the mode. Multi-letter hints are used when needed. Not available for comic books, image folders and images (fixes #2629) | ||
CmdToggleFullscreen
|
f, Shift + Ctrl + L, F11
|
Toggle Fullscreen |
CmdToggleMangaMode
|
Toggle Manga Mode | |
| Right-to-left facing/book layout for fixed-page documents; before 3.7 this was limited to comic books | ||
CmdToggleUniformPageWidth
|
Toggle Uniform Page Width | |
| At percentage zoom levels, scales every page to the width page 1 has at that zoom; remembered per document (fixes #5512) | ||
CmdToggleTrimEmptyMargins
|
Toggle Trim Empty Margins | |
| Trims empty margins around page content from display on demand, ver 3.7+ | ||
CmdToggleMenuBar
|
F9
|
Toggle Menu Bar |
CmdTogglePageInfo
|
i
|
Show / Hide Current Page Number |
| was Shift + i before 3.6 | ||
CmdTogglePageBoxes
|
Toggle Page Boxes | |
| ver 3.7+, outlines the PDF MediaBox, CropBox, BleedBox, TrimBox and ArtBox on each page (only boxes that page actually has) and labels them. Palette and Debug menu. No default shortcut (fixes #814) | ||
CmdChangeScrollbar
|
Change Scrollbar | |
| Opens dialog to choose scrollbar mode (windows/smart/overlay/hidden) | ||
CmdChangeBackgroundColor
|
Change Background Color | |
| Opens color picker to change document background color | ||
CmdChangeEbookSettings
|
Change eBook Settings | |
| ver 3.7+, opens a dialog for the font, size, line spacing and CSS of a reflowable document (EPUB, MOBI, FB2, ...), for that document only or for all ebooks. Not shown for fixed-page documents. See Customize-eBook-UI.md | ||
CmdToggleToolbar
|
F8
|
Toggle Toolbar |
CmdAIChatWithClaudeCode
|
AI Chat with document using Claude Code | |
| Toggle Claude Code chat sidebar, ver 3.7+. See AI-Chat-with-document.md | ||
CmdAIChatWithGrokBuild
|
AI Chat with document using Grok Build | |
| Toggle Grok Build chat sidebar, ver 3.7+. See AI-Chat-with-document.md#grok-build | ||
CmdAIChatWithOpenAICodex
|
AI Chat with document using OpenAI Codex | |
| Toggle OpenAI Codex chat sidebar, ver 3.7+. See AI-Chat-with-document.md#openai-codex | ||
CmdAIChatWithAntiGravity
|
AI Chat with document using Antigravity | |
| Toggle Antigravity chat sidebar, ver 3.7+. See AI-Chat-with-document.md#antigravity | ||
CmdTranslateSelectionWithAntiGravity
|
Translate Selection with Antigravity | |
| Translate selected text with Antigravity CLI, ver 3.7+ | ||
CmdChangeTheme
|
Change Theme... | |
| ver 3.7+, opens a dialog to pick a UI theme (including **Follow Windows**, which automatically tracks Windows light/dark app mode) and optionally how document colors follow the theme (`DocumentColorsFollowTheme`) | ||
CmdNavigateThumbnail
|
Navigate Thumbnails | |
| opens a thumbnail grid for the current document; arrow keys and the mouse select a page, Enter or double-click opens it, and Esc closes the grid | ||
CmdToggleLightDarkTheme
|
Toggle Light/Dark Theme | |
| ver 3.7+, switches between the last used light and dark themes (see `LastLightTheme` / `LastDarkTheme` advanced settings) | ||
CmdToggleEngineeringDrawingEnhance
|
Toggle Engineering Drawing Enhancement | |
| ver 3.7+, toggles CAD/engineering-drawing line enhancement for the current PDF (see [CAD / Engineering Drawings](CAD-Engineering-Drawings.md)) | ||
CmdSetDocumentColorsFollowTheme
|
Set Document Colors Follow Theme | |
| ver 3.7+, opens a dialog to pick how MuPDF-rendered documents follow the UI theme (`DocumentColorsFollowTheme`: off, smart, legacy) | ||
CmdTogglePreservePdfImages
|
Toggle Preserve PDF Image Colors in Dark Mode | |
| ver 3.7+, session-only toggle of image preservation on inverted pages | ||
CmdToggleLinks
|
Toggle Show Links | |
| Toggle drawing blue rectangle around links, ver 3.6+ | ||
CmdToggleHighlightFormFields
|
Toggle Highlight Form Fields | |
| ver 3.7+, toggles pale-blue highlight of empty fillable PDF form fields (`HighlightFormFields`; default on) (fixes #5966) | ||
CmdToggleTransparencyGrid
|
Toggle Transparency Grid | |
| ver 3.7+, checkerboard under the page so transparent PDFs (white art on a hole) are visible, like Acrobat's Transparency Grid. Session-only, not saved (fixes #1809) | ||
CmdTogglePageGrid
|
Toggle Page Grid | |
| ver 3.7+, dotted major/minor graph paper on PDF, EPUB, and other paginated document pages; not comics. Session-only visibility; spacing, origin, color and style are `FixedPageUI.PageGrid` (fixes #4398) | ||
CmdConfigurePageGrid
|
Configure Page Grid... | |
| ver 3.7+, dialog to set page-grid units, spacing, subdivisions, origin, color and line style (dots / dotted / solid), like PDF-XChange Measurement. Reset to defaults restores the shipped appearance settings; Show Grid is the session toggle | ||
CmdToggleDisableLinks
|
Toggle Disable Links | |
| ver 3.7+, palette-only; toggles `DisableLinks` so clicks, hover and keyboard following ignore document links (fixes #5939) | ||
CmdToggleHoverPreview
|
Toggle Citation Hover Preview | |
| ver 3.7+, palette-only; toggles the citation/reference hover popup (`CitationHoverDelay`: 300 ms when on, -1 when off) | ||
Tabs #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdCloseAllTabs
|
Close All Tabs | |
| ver 3.6+ | ||
CmdCloseTabsToTheLeft
|
Close Tabs To The Left | |
| ver 3.6+ | ||
CmdCloseTabsToTheRight
|
Close Tabs To The Right | |
| ver 3.6+ | ||
CmdCloseOtherTabs
|
Close Other Tabs | |
| ver 3.6+ | ||
CmdNextTab
|
Ctrl + PageUp
|
Next Tab |
CmdPrevTab
|
Ctrl + PageDown
|
Previous Tab |
CmdMoveTabRight
|
Ctrl + Shift + PageUp
|
Move Tab Right |
| ver 3.6+ | ||
CmdMoveTabLeft
|
Ctrl + Shift + PageDown
|
Move Tab Left |
| ver 3.6+ | ||
CmdNextTabSmart
|
Ctrl + Tab
|
Smart tab Switch |
| ver 3.6+ | ||
CmdPrevTabSmart
|
Ctrl + Shift + Tab
|
Smart tab Switch |
| ver 3.6+ | ||
CmdTabGroupSave
|
Save Tab Group | |
| ver 3.7+ | ||
CmdTabGroupRestore
|
Restore Tab Group | |
| ver 3.7+ | ||
Navigation #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdScrollUp
|
k, Up
|
Scroll Up |
CmdScrollDown
|
j, Down
|
Scroll Down |
CmdScrollLeft
|
h, Left
|
Scroll Left |
CmdScrollRight
|
l, Right
|
Scroll Right |
CmdScrollUpHalfPage
|
Shift + Up
|
Scroll Up By Half Page |
CmdScrollDownHalfPage
|
Shift + Down
|
Scroll Down By Half Page |
CmdStartAutoScroll
|
Start Auto-Scroll | |
| Start (or stop) middle-click-style auto-scroll anchored at the cursor, without needing a middle mouse button; move the cursor away from the anchor to scroll. Invoke again (or middle-click) to stop, ver 3.7+ | ||
CmdScrollUpPage
|
Ctrl + Up, PageUp, Shift + Return, Shift + Space
|
Scroll Up By Page |
CmdScrollDownPage
|
Ctrl + Down, PageDown, Return, Space
|
Scroll Down By Page |
CmdScrollLeftPage
|
Shift + Left
|
Scroll Left By Page |
CmdScrollRightPage
|
Shift + Right
|
Scroll Right By Page |
CmdGoToFirstPage
|
Ctrl + Home, Home
|
First Page |
CmdGoToLastPage
|
Ctrl + End, End
|
Last Page |
CmdGoToPrevPage
|
p
|
Previous Page |
CmdGoToNextPage
|
n
|
Next Page |
CmdGoToPage
|
g, Ctrl + G
|
Go to Page... |
CmdNavigateBack
|
Alt + Left, Backspace
|
Navigate Back |
CmdNavigateForward
|
Alt + Right, Shift + Backspace
|
Navigate Forward |
Favorites #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdFavoriteAdd
|
Ctrl + B
|
Add Favorite |
CmdFavoriteDel
|
Delete Favorite | |
CmdFavoriteToggle
|
Toggle Favorites | |
CmdFavoriteShowInTab
|
Show Favorites in Tab | |
| Full-window Favorites tab (independent of sidebar), ver 3.7+ | ||
CmdToggleFavoritesSort
|
Sort Favorites By Name | |
| Toggle alphabetical order within each file (also Favorites tree context menu checkbox); maps to `SortFavoritesByName`, ver 3.7+ | ||
CmdGoToNextFavorite
|
Go to Next Favorite | |
CmdGoToPrevFavorite
|
Go to Previous Favorite | |
Presentation #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdTogglePresentationMode
|
Ctrl + L, Shift + F11, F5
|
View: Presentation Mode |
CmdPresentationBlackBackground
|
.
|
Presentation Black Background |
CmdPresentationWhiteBackground
|
w
|
Presentation White Background |
CmdToggleLaserPointer
|
Toggle Laser Pointer | |
| ver 3.7+, replaces the mouse cursor over the document with a glowing red laser dot for pointing things out. No default shortcut, assign your own. Stays visible in presentation mode (the cursor doesn't auto-hide while it's on) | ||
Annotations #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdInsertImage
|
Insert Image... | |
| Pick an image and stamp it onto the current page as a stamp annotation - a signature, say (fixes #1744), ver 3.7+ | ||
CmdCreateAnnotCaret
|
Create Caret Annotation | |
CmdCreateAnnotCircle
|
Create Circle Annotation | |
CmdFindAnnotation
|
Find Annotation | |
| opens the floating annotation list, where you can filter the document's annotations and jump to one, ver 3.7+ | ||
CmdCreateAnnotFileAttachment
|
Create File Attachment Annotation | |
| click to place, like Stamp/Caret; Esc cancels, ver 3.7+ | ||
CmdCreateAnnotFreeText
|
Create Free Text Annotation | |
CmdCreateAnnotHighlight
|
a, A
|
Create Highlight Annotation |
CmdAnnotationHighlightBrush
|
Highlight with Brush | |
| a freehand highlighter: drag to paint a marker stroke anywhere on the page, no text selection needed. Release finishes, Esc cancels. Saved as an ink annotation in HighlightColor, ver 3.7+ | ||
CmdCreateAnnotInk
|
Create Ink Annotation | |
| drag to paint; release commits the stroke and leaves the tool on. Esc or closing the hint leaves the tool, ver 3.7+ | ||
CmdCreateAnnotLine
|
Create Line Annotation | |
CmdCreateAnnotLink
|
Create Link Annotation | |
CmdCreateAnnotPolygon
|
Create Polygon Annotation | |
CmdCreateAnnotPolyLine
|
Create Poly Line Annotation | |
CmdCreateAnnotPopup
|
Create Popup Annotation | |
CmdCreateAnnotRedact
|
Create Redact Annotation | |
| marks selected text, or a dragged rectangle, for removal; content is not deleted until Apply Redactions, ver 3.7+ | ||
CmdApplyRedactions
|
Apply Redactions | |
| permanently deletes content marked with the Redact tool, after a confirmation; save a copy afterwards, ver 3.7+ | ||
CmdCreateAnnotSquare
|
Create Square Annotation | |
CmdCreateAnnotSquiggly
|
Create Squiggly Annotation | |
CmdCreateAnnotStamp
|
Create Stamp Annotation | |
CmdCreateAnnotImageFromClipboard
|
Create Image Annotation From Clipboard | |
CmdCreateAnnotStrikeOut
|
Create Strike Out Annotation | |
CmdCreateAnnotText
|
Create Text Annotation | |
CmdCreateAnnotUnderline
|
u, U
|
Create Underline Annotation |
CmdUndo
|
Ctrl + Z
|
Undo |
| ver 3.7+, takes back the last change to the PDF (annotations, form fields, applied redactions). One gesture is one step: creating, pasting or resizing an annotation comes back in a single Undo. Disabled when there is nothing to undo; in a text box Ctrl + Z is the text box's undo | ||
CmdRedo
|
Shift + Ctrl + Z
|
Redo |
| ver 3.7+, re-applies the change Undo took back. Disabled when there is nothing to redo | ||
CmdCutAnnotation
|
Ctrl + X
|
Cut Annotation |
| ver 3.7+, copies the annotation under the cursor (or the selected one) and deletes it when the copy is pasted; in a text box Ctrl + X is the text box's cut | ||
CmdCopyAnnotation
|
Ctrl + C
|
Copy Annotation |
| ver 3.7+, copies the selected annotation in Edit PDF mode; Ctrl + C is CmdCopySelection and copies the annotation when one is selected. Only annotations that can be moved can be copied, so text markup (highlight, underline, squiggly, strike-out) and file attachments are excluded | ||
CmdPasteAnnotation
|
Ctrl + V
|
Paste Annotation |
| ver 3.7+, pastes the copied annotation with its top-left at the mouse and deletes the original if it was cut; Ctrl + V is CmdPasteClipboardImage and pastes the annotation when Edit PDF is on and one has been copied | ||
CmdDeleteAnnotation
|
Delete
|
Delete Annotation |
CmdSaveAnnotations
|
Shift + Ctrl + S
|
Save Annotations to existing PDF |
CmdSaveAnnotationsNewFile
|
Save Annotations to new PDF | |
| ver 3.6+ | ||
CmdSignDocument
|
Sign Document... | |
| digitally sign a PDF with a certificate from the Windows store or a .pfx / .p12 file; choose which name/date/labels to draw and optionally a PNG/JPEG; a new signature is placed by clicking or dragging on the page, ver 3.7+ | ||
CmdDiscardChanges
|
Discard Changes | |
| reloads the document from disk, discarding unsaved annotations and form changes; also on the tab context menu when there are unsaved changes, ver 3.7+ (renamed from `CmdDiscardAnnotations`) | ||
CmdShowAnnotations
|
Show Annotations | |
| ver 3.6+, for current document | ||
CmdHideAnnotations
|
Hide Annotations | |
| ver 3.6+, for current document | ||
CmdToggleShowAnnotations
|
Toggle Showing Annotations | |
| ver 3.6+, for current document | ||
CmdToggleEditPDF
|
Toggle Edit PDF | |
| shows or hides Edit PDF mode (the annotation-tools row), ver 3.7+ (renamed from `CmdTogglePdfAnnotationsToolbar`) | ||
Zoom #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdToggleZoom
|
z
|
Toggle Zoom |
CmdZoomActualSize
|
Ctrl + 1, Ctrl + Numpad 1
|
Zoom: Actual Size |
CmdZoomCustom
|
Ctrl + Y
|
Zoom: Custom... |
CmdZoomFitContent
|
Ctrl + 3, Ctrl + Numpad 3
|
Zoom: Fit Content |
CmdZoomToSelection
|
Ctrl + 4, Ctrl + Numpad 4
|
Zoom: To Selection |
| ver 3.7+, zooms so the current selection (Ctrl + drag rectangle or selected text) fills the window and centers it; the selection is kept so it can still be copied, and Navigate Back (Alt + Left) returns to the view it was zoomed from. Also in the Zoom menu and the right-click menu (fixes #1699) | ||
CmdZoomShrinkToFit
|
Zoom: Shrink To Fit | |
| Shows at 100% if page is smaller than view area, otherwise fits page | ||
CmdZoomFitPage
|
Ctrl + 0, Ctrl + Numpad 0
|
Zoom: Fit Page |
CmdZoomFitPageAndSinglePage
|
Zoom: Fit Page and Single Page | |
CmdZoomFitWidth
|
Ctrl + 2, Ctrl + Numpad 2
|
Zoom: Fit Width |
CmdZoomFitHeight
|
Zoom: Fit Height | |
| Scale so the page fills the window height (may scroll horizontally); useful for landscape pages on portrait screens (fixes #1714), ver 3.7+ | ||
CmdZoomFitByOrientation
|
Zoom: Fit Page or Width by Orientation | |
| Fit width when the view is wider than tall (landscape), fit page otherwise (portrait); re-evaluated as the window/screen is resized or rotated | ||
CmdZoomFitWidthAndContinuous
|
Zoom: Fit Width And Continuous | |
CmdZoomIn
|
Ctrl + Add
|
Zoom In |
CmdZoomOut
|
Ctrl + Subtract
|
Zoom Out |
CmdZoom100
|
Zoom: 100% | |
CmdZoom12_5
|
Zoom: 12.5% | |
CmdZoom125
|
Zoom: 125% | |
CmdZoom150
|
Zoom: 150% | |
CmdZoom1600
|
Zoom: 1600% | |
CmdZoom200
|
Zoom: 200% | |
CmdZoom25
|
Zoom: 25% | |
CmdZoom3200
|
Zoom: 3200% | |
CmdZoom400
|
Zoom: 400% | |
CmdZoom50
|
Zoom: 50% | |
CmdZoom6400
|
Zoom: 6400% | |
CmdZoom8_33
|
Zoom: 8.33% | |
CmdZoom800
|
Zoom: 800% | |
File information / conversion #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdPdShowInfo
|
Show PDF Info | |
| shows information about currently opened PDF file | ||
CmdDocumentShowOutline
|
Show Document Outline | |
| shows the outline (table of contents) of currently opened document | ||
CmdPdfBake
|
Bake PDF File | |
| bakes interactive form and annotation content into static graphics; saves to a new PDF file and opens it | ||
CmdDocumentExtractText
|
Extract Text From Document | |
| extract text from document pages to a .txt file, with configurable page ranges, ver 3.7+ | ||
External app #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdOpenWithExplorer
|
Open Directory In Explorer | |
| ver 3.5+ | ||
CmdOpenWithDirectoryOpus
|
Open Directory In Directory Opus | |
| ver 3.5+ | ||
CmdOpenWithTotalCommander
|
Open Directory In Total Commander | |
| ver 3.5+ | ||
CmdOpenWithDoubleCommander
|
Open Directory In Double Commander | |
| ver 3.5+ | ||
CmdOpenWithAcrobat
|
Open in Adobe Acrobat | |
CmdOpenWithFoxIt
|
Open in Foxit Reader | |
CmdOpenWithFoxItPhantom
|
Open in Foxit Phantom | |
CmdOpenWithHtmlHelp
|
Open in Microsoft HTML Help | |
CmdOpenWithPdfDjvuBookmarker
|
Open in Pdf&Djvu Bookmarker | |
CmdOpenWithPdfXchange
|
Open in PDF-XChange | |
CmdOpenWithXpsViewer
|
Open in Microsoft Xps Viewer | |
CmdTranslateSelection
|
Translate Selection... | |
| ver 3.7+, opens a dialog to translate the selected text (edit text, pick languages and engine); used from the selection context menu and command palette | ||
CmdTranslateSelectionWithDeepL
|
Translate Selection With DeepL | |
CmdTranslateSelectionWithGoogle
|
Translate Selection with Google | |
CmdTranslateSelectionWithGrokBuild
|
Translate Selection with Grok Build | |
| ver 3.7+, requires the Grok Build CLI | ||
CmdTranslateSelectionWithClaudeCode
|
Translate Selection with Claude Code | |
| ver 3.7+, requires the Claude Code CLI | ||
CmdTranslateSelectionWithOpenAICodex
|
Translate Selection with OpenAI Codex | |
| ver 3.7+, requires the OpenAI Codex CLI | ||
CmdSearchSelectionWithBing
|
Search Selection with Bing | |
CmdSearchSelectionWithGoogle
|
Search Selection with Google | |
CmdSearchSelectionWithWikipedia
|
Search Selection with Wikipedia | |
| ver 3.6+ | ||
CmdSearchSelectionWithGoogleScholar
|
Search Selection with Google Scholar | |
| ver 3.6+ | ||
CmdSendByEmail
|
Send Document By Email... | |
CmdInvokeInverseSearch
|
Invoke Inverse Search | |
| ver 3.6+ | ||
System #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdAdvancedOptions
|
Advanced Options... | |
| Opens the settings file in a text editor | ||
CmdAdvancedSettings
|
Advanced Settings... | |
| ver 3.7+, opens a dialog for viewing and editing the advanced settings: filter by name, click a setting to toggle / pick / edit its value, then Save | ||
CmdChangeLanguage
|
Change Language... | |
CmdCheckUpdate
|
Check For Updates | |
CmdClearHistory
|
Clear History | |
| Clears history of opened files (for recently opened list in home page) | ||
CmdRemoveDeletedFilesFromHistory
|
Remove Deleted Files From History | |
| ver 3.7+, removes from history entries for files that no longer exist on disk | ||
CmdDeleteCachedFiles
|
Delete Cached Files | |
| ver 3.7+, deletes local copies of comic book archives cached under cbx-cache when opened from a network drive | ||
CmdContributeTranslation
|
Contribute Translation | |
CmdForgetSelectedDocument
|
Remove Selected Document From History | |
CmdListPrinters
|
List Printers | |
| ver 3.7+ | ||
CmdOptions
|
Options... | |
CmdSetInverseSearch
|
Set Inverse Search Command Line | |
| ver 3.7+, opens a dialog to set the SyncTeX inverse-search command and enables TeX enhancements | ||
CmdScreenshot
|
Take Screenshot | |
| ver 3.7+, can be registered as a global hotkey via Shortcuts entry (e.g. Key = Global PrtSc) or through the Settings menu | ||
CmdCropImage
|
Crop Image | |
| ver 3.7+ | ||
CmdResizeImage
|
Resize Image | |
| ver 3.7+ | ||
CmdSaveImage
|
Save Image | |
| Save image from context menu, ver 3.7+ | ||
CmdConvertImageToPdf
|
Convert Page To PDF | |
| Save the image under the cursor (or the current image document page) as a new PDF via the image editor, ver 3.7+ | ||
CmdConvertToPDF
|
Convert To PDF | |
| Convert a comic book, image folder, or single image to a multi-page PDF (dialog picks a unique .pdf path), ver 3.7+ (fixes #4118, #5532). Docs: Convert-to-PDF.md | ||
CmdConvertPdfToImages
|
Convert PDF to Images... | |
| Render PDF pages to PNG, JPEG or BMP (format drop-down updates the extension). Destination path is a template: |
||
CmdPasteClipboardImage
|
Ctrl + V
|
Paste Image From Clipboard |
| Paste image from clipboard and open it, ver 3.7+. In Edit PDF mode, pastes a copied annotation at the mouse instead | ||
CmdShowErrors
|
Show Errors | |
| Show mupdf warnings/errors in right-click context menu, ver 3.7+ | ||
CmdShowLog
|
Show Logs | |
Help #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdHelpOpenManual
|
F1
|
Help: Manual |
CmdHelpOpenKeyboardShortcuts
|
Help: Keyboard Shortcuts | |
CmdToggleKeyboardHelp
|
?
|
Show Keyboard Shortcuts |
| Overlay listing the most useful commands by section, each row showing the key it is currently bound to. Press again (or Esc) to close it, ver 3.7+ | ||
CmdHelpAbout
|
Help: About SumatraPDF | |
CmdHelpOpenManualOnWebsite
|
Help: Manual On Website | |
CmdHelpVisitWebsite
|
Help: SumatraPDF Website | |
Misc #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdToggleInverseSearch
|
Toggle Inverse Search | |
| temporarily disable TeX inverse search on left mouse click, ver 3.6+ | ||
CmdToggleWindowsPreviewer
|
Register / Un-register Windows Previewer | |
| Only available when SumatraPDF is installed. Registers or un-registers the PDF preview handler for Windows Explorer preview pane, ver 3.7+ | ||
CmdToggleWindowsSearchFilter
|
Register / Un-register Windows Search Filter | |
| Only available when SumatraPDF is installed. Registers or un-registers the PDF search filter for Windows Search indexing, ver 3.7+ | ||
CmdSetTabColor
|
Set Tab Color | |
| Set a custom color for the tab of the current document, available from tab context menu, ver 3.7+ | ||
CmdPdfCompress
|
Compress PDF | |
| Compress a PDF file using aggressive garbage collection and optimization, ver 3.7+ | ||
CmdPdfDecompress
|
Decompress PDF | |
| Decompress a PDF file for easier inspection, ver 3.7+ | ||
CmdPdfDeletePages
|
Delete Pages From PDF | |
| Delete pages from a PDF file using page ranges like 1,3-8,13-N where N is the last page, ver 3.7+ | ||
CmdPdfExtractPages
|
Extract Pages From PDF | |
| Extract pages from a PDF file using page ranges like 1,3-8,13-N where N is the last page, ver 3.7+ | ||
CmdPdfEncrypt
|
Encrypt PDF | |
| Encrypt a PDF file with a password using AES-256 encryption, ver 3.7+ | ||
CmdPdfDecrypt
|
Decrypt PDF | |
| Decrypt an encrypted PDF file, removing password protection, ver 3.7+ | ||
CmdSetScreenshotHotkey
|
Set Screenshot Hotkey | |
| Open dialog to set or remove a global hotkey for taking screenshots, ver 3.7+ | ||
CmdReadAloud
|
Read Aloud | |
| Read selected text (or from the viewport if no selection) through the end of the document using Windows text-to-speech. Invoking again pauses reading. Voice is chosen in the Read Aloud Voice submenu and remembered in ReadAloudVoiceId, ver 3.7+ | ||
CmdPauseReadAloud
|
Pause Reading | |
| Pause reading text aloud; resume with CmdContinueReadAloud, ver 3.7+ | ||
CmdContinueReadAloud
|
Continue Reading | |
| Continue reading text aloud from where it was paused, ver 3.7+ | ||
CmdStopReadAloud
|
Stop Reading | |
| Stop reading text aloud and clear the resume position. Always in the Read Aloud menu (disabled when nothing is being read) and in the command palette while a session is active, even when the playback bar is not visible, ver 3.7+ | ||
CmdReadAloudFromTopPage
|
Start Reading From Top | |
| Read from the first visible text in the viewport through the end of the document, ver 3.7+ | ||
CmdReadAloudSelection
|
Start Reading Selection | |
| Read the current text selection aloud, ver 3.7+ | ||
CmdToggleToolbarShowReadAloud
|
Read Aloud: Show In Toolbar | |
| Show or hide the Read Aloud buttons in the toolbar; remembered in the `ToolbarShowReadAloud` setting, ver 3.7+ | ||
Debug #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdDebugCrashMe
|
Debug: Crash Me | |
CmdDebugDownloadSymbols
|
Debug: Download Symbols | |
CmdDebugShowNotif
|
Debug: Show Notification | |
CmdDebugStartStressTest
|
Debug: Start Stress Test | |
CmdDebugTestApp
|
Debug: Test App | |
CmdDebugTogglePredictiveRender
|
Debug: Toggle Predictive Rendering | |
CmdDebugToggleRenderInfo
|
Debug: Toggle Render Queue Info | |
CmdDebugToggleCacheInfo
|
Debug: Toggle Cache Info | |
CmdDebugToggleRtl
|
Debug: Toggle Rtl | |
CmdToggleImages
|
Toggle Show Images | |
| Outline the images on the page, like the link outlines. A debug aid: it lasts for the session and is not saved in the settings, ver 3.7+ | ||
CmdDebugShowFitContentArea
|
Debug: Show Fit Content Area | |
| outlines in red the area Fit Content zoom would fit to (whole page if no content box was detected), without changing the zoom, ver 3.7+ | ||
CmdNone
|
Do nothing | |
Deprecated or internal #
| Command IDs | Keyboard shortcuts | Command Palette |
|---|---|---|
CmdInstallPrereleaseUpdate
|
internal | |
| used by the pre-release update notification link (Update); not for user shortcuts or DDE | ||
CmdTogglePdfPreviewLogging
|
internal | |
| toggles PDF shell-preview logging for debugging the Windows preview handler; not for normal use | ||
CmdDebugCorruptMemory
|
don't use | |
CmdOpenWithKnownExternalViewerFirst
|
don't use | |
CmdOpenWithKnownExternalViewerLast
|
don't use | |
CmdSelectionHandler
|
use SelectionHandlers advanced setting instead | |
CmdSetTheme
|
don't use | |
CmdViewWithExternalViewer
|
don't use | |
CmdSaveAttachment
|
don't use | |
CmdOpenAttachment
|
don't use | |
CmdExec
|
internal | |
| runs an external program with optional filter; used internally (e.g. selection handlers), not for normal shortcuts or DDE | ||
CmdDebugToggleDpiOverride
|
internal | |
| debug builds only: cycles a pretend DPI (125, 150, 75, off) to check how the UI reacts to a DPI change; does nothing in a release build | ||
CmdFindMatch is an old name for CmdFindToggleMatchCase. It is not a generated command ID, but SumatraPDF still accepts it in old shortcut settings for compatibility.CmdTogglePdfAnnotationsToolbar is an old name for CmdToggleEditPDF. SumatraPDF still accepts it in old shortcut and ToolbarCustomLayout settings.Commands with arguments #
Ver 3.6+: some commands accept arguments that provide more options when creating custom keyboard shortcuts.
For example:
Shortcuts [
[
Cmd = CmdCreateAnnotHighlight #00ff00
Key = a
]
]
By default,
a invokes CmdCreateAnnotHighlight with the default yellow color.You can override the
a shortcut to create a green (#00ff00) highlight annotation.You can create multiple keyboard shortcuts for multiple colors.
Arguments can be strings, numbers, Booleans, or colors (
#rrggbb or #aarrggbb format).Arguments have names. For example,
CmdCreateAnnotHighlight has a color argument of type color and an optional copytoclipboard Boolean argument.The format for providing arguments is
CmdCreateAnnotHighlight color: #fafafa copytoclipboard: true.For Boolean arguments, using the name alone is the same as setting the value to
true, i.e. copytoclipboard is the same as copytoclipboard: true.For default arguments, you can skip the name. For example,
color is the default CmdCreateAnnotHighlight argument, so CmdCreateAnnotHighlight #fafafa is the same as CmdCreateAnnotHighlight color: #fafafa.You can combine those rules:
CmdCreateAnnotHighlight #fafafa copytoclipboard is the same as CmdCreateAnnotHighlight color: #fafafa copytoclipboard: true.CmdExtendSelectionCharLeft and other CmdExtendSelection* #
Ver 3.7+
CmdExtendSelectionCharLeft, CmdExtendSelectionCharRight, CmdExtendSelectionWordLeft, and CmdExtendSelectionWordRight move the free end of the current text selection by one character or one word, the way Shift + Left/Right and Ctrl + Shift + Left/Right do in a text editor. Moving toward the selection’s anchor shrinks it, moving away grows it, and the selection continues across page boundaries.They have no default shortcut because the obvious keys are already taken (
Ctrl + Shift + Left/Right navigate between files), so assign your own:Shortcuts [
[
Cmd = CmdExtendSelectionWordRight
Key = Ctrl + Shift + Right
]
[
Cmd = CmdExtendSelectionWordLeft
Key = Ctrl + Shift + Left
]
]
The selection can come from anywhere: dragging with the mouse, double-clicking a word, pressing
Ctrl + A, or using keyboard selection (F7). While F7 keyboard selection is active, these commands move the caret, so it stays at the end of the selection. Without a selection, they do nothing, and they’re not available for documents with no extractable text.CmdScrollUp, CmdScrollDown #
Ver 3.6+
Arguments:
n: default, integer, how many lines to scroll up or down (default: 1)
Use case: if you want to speed up scrolling with the
j and k keys, you can reassign them:Shortcuts [
[
Cmd = CmdScrollDown 5
Key = j
]
[
Cmd = CmdScrollUp n: 5
Key = k
]
]
CmdGoToNextPage, CmdGoToPrevPage #
Ver 3.6+
Arguments:
n: default, integer, how many pages to advance by (default: 1)
Use case: if you want to go forward or back by more than one page.
CmdCreateAnnotHighlight and other CmdCreateAnnot* #
Arguments:
color: default, coloropenedit: Boolean,falseif not given. Opens the Contents editor on the property row after creating the annotation (the old annotations window is gone). Creating an annotation always turns on Edit PDF mode.copytoclipboard: Boolean,falseif not given. For highlight/underline/squiggly/strikeout annotations, copies the selection (the annotation’s text) to the clipboard. This used to be the default behavior for built-in keyboard shortcuts such asa, but now it has to be chosen explicitly.setcontent: Boolean,falseif not given. For highlight/underline/squiggly/strikeout annotations, sets the annotation’s content to the selection (the annotation’s text)
Use cases:
- change default color for annotations
- create multiple shortcuts for different colors
Example: change
a to create a green highlight annotation:Shortcuts [
[
Cmd = CmdCreateAnnotHighlight #00ff00
Key = a
]
]
Other CmdCreateAnnot* arguments #
Ver 3.6+
Arguments for
CmdCreateAnnotHighlight plus:color: default, color of text and border, black if not givenbgcolor: background color of annotation, fully transparent if not giventextsize: size of annotation text, 12 if not givenborderwidth: border width, 1 if not givenalignment: ver 3.7+, how free text is aligned in its box:left,center, orright. Left if not givenopacity: opacity of annotation, 0 = fully transparent (i.e. invisible), 100 = fully opaque (default if not given)interiorcolor: interior color for circle, square, etc. annotations, fully transparent if not given
CmdToggleBoolSetting #
Ver 3.7+
Arguments:
name: default, string — name of a boolean advanced setting (case-insensitive leaf name or dotted path, e.g.Fullscreen.ShowMenubar)
Toggles that setting between
true and false. Useful for custom shortcuts or toolbar buttons. Unknown setting names show a warning when the shortcut is defined and when the command runs.Without a
name argument, the Command Palette lists every non-internal boolean setting (= prefix). Enter or a click toggles the selected setting and closes the palette.Example: toggle fullscreen menubar with
t:Shortcuts [
[
Cmd = CmdToggleBoolSetting Fullscreen.ShowMenubar
Key = t
Name = Toggle Fullscreen Menubar
]
]
Add
ToolbarText to the same entry to also get a toolbar button for it. Example: turn the reading mode of MouseWheelTurnsPage on and off with w or from the toolbar:Shortcuts [
[
Cmd = CmdToggleBoolSetting MouseWheelTurnsPage
Key = w
Name = Wheel Turns Page
ToolbarText = Wheel Turns Page
]
]
The same works for any other boolean advanced setting, e.g.
CmdToggleBoolSetting RememberViewOffsetOnPageTurn or CmdToggleBoolSetting ClickEdgeToTurnPage.CmdZoomCustom #
Ver 3.6+
Arguments:
level: default, string or integer, zoom level
level can be:- a number describing the zoom level as a percentage, e.g.:
50or50%means 50% zoom125means 125% zoom
- a virtual zoom level:
actual size(100% zoom level)fit pagefit widthfit content
Example:
Shortcuts [
[
Cmd = CmdZoomCustom 50%
Key = z
]
]
CmdCommandPalette #
Ver 3.6+
Argument:
mode: default, optional string. Values:@for open files (tabs)#for history of files>for commands&for page thumbnails%for table of contents (CmdCommandPaletteTOC,Shift + F12)$for favorites (CmdCommandPaletteFavorites)*for annotations in the current PDF=for boolean advanced settings (CmdToggleBoolSetting)
Without an argument it defaults to
>.To bind a keyboard shortcut to a palette mode, prefer the dedicated commands
(
CmdCommandPaletteTOC, CmdCommandPaletteFavorites) over CmdCommandPalette
with a mode argument. A literal $ in settings must be written as $$ (see
customize keyboard shortcuts).Example:
Shortcuts [
[
Cmd = CmdCommandPalette #
Key = Ctrl + h
]
[
Cmd = CmdCommandPaletteFavorites
Key = b
]
]
Toggle commands (force an on/off state) #
Ver 3.7+
These toggle commands accept an optional
state boolean argument that forces an explicit state instead of flipping the current one. This is useful for automation (e.g. via DDE) where you want to set a known state rather than toggle blindly:CmdToggleFullscreenCmdTogglePresentationModeCmdToggleToolbarCmdToggleMenuBarCmdToggleContinuousViewCmdToggleTableOfContents,CmdToggleBookmarksCmdToggleDisableLinks
Arguments:
state: default, boolean.on/true/1/yesforces the feature on,off/false/0/noforces it off. If the document is already in the requested state, nothing happens. If omitted, the command toggles (the original behavior).
Examples (DDE):
[CmdToggleFullscreen on]
[CmdToggleToolbar off]
[CmdToggleContinuousView state: on]
Debugging #
If a custom shortcut defined in
Shortcuts doesn’t work, it could be caused by an invalid command name or invalid command arguments.We log information about unsuccessful shortcut parsing, so check the logs if things don’t work as expected.