For command-line arguments for the installer see
this page.
You can launch Sumatra with additional command-line options:
SumatraPDF.exe [argument ...] [filepath ...]
.
All arguments start with dash (-). Some arguments are followed by
additional parameter.
Anything that is not recognized as a known option is interpreted as a
file path so it's possible to mix file paths and command-line
arguments.
List of command line options
-presentation
: start in presentation view
-fullscreen
: start in full screen view
-new-window
: when opening a file, always open it in a
new window, as opposed to in a tab (since 3.2)
-appdata <directory>
: set custom directory where
we'll store SumatraPDF-settings.txt
file and
thumbnail cache
-restrict
: runs in restricted mode where you can
disable features that require access to file system, registry and the
internet. Useful for kiosk-like usage. Read more detailed
documentation.
Navigation options
Printing options
-print-to-default
: prints all files indicated on this
command line to the system default printer. After printing, SumatraPDF
exits immediately (check the error code for failure).
-print-to <printer-name>
: prints all files
indicated on this command line to the named printer. After printing,
SumatraPDF exits immediately (check the error code for failure). E.g.
-print-to "Microsoft XPS Document Writer"
prints all indicated files to the XPS virtual printer.
-print-settings <settings-list>
- used in combination with
-print-to
and
-print-to-default
. Allows to tweak some of the
printing related settings without using the Print dialog. The
settings-list is a comma separated list of page ranges and
advanced options such as
even
or odd
.
portrait
or landscape
: can provide
90 degree rotation of contents (NOT the rotation of paper
which must be pre-set by the choice of printer defaults)
noscale
, shrink
and
fit
color
or monochrome
duplex
, duplexshort
,
duplexlong
and simplex
bin=<num or name>
: select tray to print
to
paper=<page size>
: page size is
A2
, A3
, A4
,
A5
, A6
, letter
,
legal
, tabloid
,
statement
- e.g.
-print-settings "1-3,5,10-8,odd,fit,bin=2"
prints pages 1, 3, 5, 9 (i.e. the odd pages from the ranges 1-3,
5-5 and 10-8) and scales them so that they fit into the printable
area of the paper.
-print-settings "3x"
: prints the document
3 times
-silent
: used in combination with
-print-to
and -print-to-default
. Silences any error messages
related to command line printing.
-print-dialog
: displays the Print dialog for all the
files indicated on this command line.
-exit-when-done
: used in combination with
-print-dialog
(and -stress-test
). Exits SumatraPDF after the Print
dialog has been dismissed and the document printed.
Options related to forward/inverse search (for LaTeX editors)
-forward-search <sourcepath> <line>
:
performs a forward search from a LaTeX source file to a loaded PDF
document (using PdfSync or SyncTeX). This is an alternative to the
ForwardSearch DDE command. E.g. -forward-search main.tex 123
highlights all text related to line 123 in main.tex.
-reuse-instance
: tells an already open SumatraPDF to
load the indicated files. If there are several running instances,
behavior is undefined. Only needed when communicating with SumatraPDF
through DDE (use the ReuseInstance setting instead otherwise).
-inverse-search <command-line>
: sets the command
line to be used for performing an inverse search from a PDF document
(usually back to a LaTeX source file). The inverse search command line
can also be set from the Setting dialog. Use the variable %f for the
current filename and %l for the current line. [Deprecated]: This
setting is exposed in the Options dialog after the first PDF document
with corresponding .synctex or .pdfsync file has been loaded.
Alternatively, use the corresponding advanced setting instead.
-fwdsearch-offset <offset> -fwdsearch-width <width>
-fwdsearch-color <hexcolor> -fwdsearch-permanent
<flag>
: allows to customize the forward search highlight. Set the offset to
a positive number to change the highlight style to a rectangle at the
left of the page (instead of rectangles over the whole text). The flag
for -fwdsearch-permanent
can be 0 (make the highlight
fade away, default) or 1. [Deprecated]: Use the corresponding advanced
settings instead.
Developer options
-console
: Opens a console window alongside SumatraPDF
for accessing (MuPDF) debug output.
-stress-test <path> [file-filter] [range] [cycle-count]
- Renders all pages of the indicated file/directory for stability
and performance testing. E.g.:
-stress-test file1.pdf 25x
-stress-test file2.pdf 1-3
-stress-test dir *.pdf;*.xps 15- 3x
renders file1.pdf 25 times, renders pages 1 to 3 of file2.pdf and
renders all but the first 14 PDF and XPS files from dir 3 times.
-bench <filepath> [page-range]
: Renders all pages
(or just the indicated ones) for the given file and then outputs the
required rendering times for performance testing and comparisons.
Often used together with -console
.
Deprecated options
The following options just set values in the settings file and may be
removed in any future version:
-bg-color <hexcolor>
: changes the yellow
background color to a different color. See e.g.
html-color-codes.info for
a way to generate the hexcode for a color. E.g.
-bg-color #999999
changes the color to gray.
[Deprecated]: Use
MainWindowBackground
setting instead.
-esc-to-exit
: enables the Escape key to quit
SumatraPDF. Deprecated: Use the
EscToExit
setting instead.
-set-color-range <text-hexcolor>
<background-hexcolor>
: Uses the given two colors for foreground and background and maps all
other colors used in a document in between these two. E.g.
-set-color-range #dddddd #333333
displays soft white text
on a dark gray background. [Deprecated]: Use the TextColor and
BackgroundColor settings for FixedPageUI instead.
-lang <language-code>
: sets the UI language. See
[/scripts/trans_langs.py]
(https://github.com/sumatrapdfreader/sumatrapdf/blob/master/scripts/trans_langs.py)
for the list of available language codes. E.g. -lang de. [Deprecated]:
Use the UiLanguage
setting instead.
-manga-mode <mode>
: enables or disables
"Manga mode" for reading (mainly Japanese) comic books from
right to left. Mode must be "true" or 1 for enabling and
"false" or 0 for disabling this feature.
-invert-colors
Deprecated: Use the
CbxMangaMode
setting for ComicBookUI instead.