acroread (1) - Linux Manuals

acroread: Adobe PDF Viewer for viewing PDF files on X Window System.


acroread - Adobe PDF Viewer for viewing PDF files on X Window System.


acroread [OPTIONS] [file]


Adobe Reader is a free PDF reader, designed for standards compliance, performance and portability. It is a tool for opening and using Adobe PDFs that are created in Adobe Acrobat. Although you can't create PDFs in Reader, you can use Reader to view, print, and manage PDFs. After opening a PDF in Reader, you have a variety of tools to help you find information quickly. If you receive a PDF form, you can complete it online and submit it electronically. If you receive an invitation to review a PDF, use the commenting and markup tools to annotate it. Use the Reader multimedia tools to play video and music in a PDF. And if a PDF contains sensitive information, you can sign or certify a document with a digital ID.


A summary of the options supported by acroread is included below.

acroread options

X display to use
X screen to use. Use this options to override the screen part of the DISPLAY environment variable.
Make X calls synchronous
-h, -help
Prints the common command-line options.
-geometry widthxheight
Set height of startup window to value.
-v, -version
Print acroread version.
Launches in an iconic state on the desktop.
-setenv var=value
Tells the main application to perform the equivalent of C-shell setenv var value.
Indicates files listed on the command line are temporary files and should not be put in the recent file list. The document title will be the title in the pdf document, instead of the filename.
-tempFileTitle title
Same as -tempFile, except the title is specified.
It launches a new instance of acroread process. The application starts normally without checking if it is already running.
Same as OpenInNewInstance. But it is recommended to use OpenInNewInstance. openInNewWindow will be deprecated.
-installCertificate <server-ip> <server-port>
Fetches and installs client-side certificates for authentication to access the server while creating secured connections.
-installCertificate [-PEM|-DER] <PathName>
Installs the certificate in the specified format from the given path to the Adobe Reader Certificate repository.

Switch used to pass the file open parameters. To use more than one file open parameter, use & as the separator and the options should be within quotes. See the example below:
acroread /a "page=NUM & zoom=NUM" PDF_FILE.pdf
nameddest=name - Specifies a named destination in the PDF.
page=pagenum - Specifies a numbered page in the document, using an integer value.
zoom=scale - Sets the zoom and scroll factors, using float or integer values.
zoom=scale,left,top - Scroll values left and top are in a coordinate system where 0,0 is the top left of the visible page, regardless of document rotation.
view=<option> - Set the view of the displayed page, using keyword values defined in the PDF Language Specification. Scroll values left and top are floats or integers in a coordinate system where 0,0 is the top left of the visible page, regardless of document rotation. Use the page command before this command.
viewrect=left,top,wd,ht - Sets the view rectangle using float or integer values in a coordinate system where 0,0 is the top left of the visible page, regardless of document rotation. Use the page command before this command.
pagemode=<option> - Displays bookmarks or thumbnails.
pagemode=none (default)
scrollbar=1|0 - Turns scrollbars on or off.
search=wordList - Opens the Search UI and performs a search for the specified word list in the document. Found words are highlighted in the document. The words must be enclosed in quotes and separated by spaces; for example: #search=”word1 word2”
toolbar=1|0 - Turns the toolbar on or off.
highlight=lt,rt,top,btm - Highlights a specified rectangle on the displayed page. (Use the page command before this command.) The rectangle values are integers in a coordinate system where 0,0 is the top left of the visible page, regardless of document rotation.
help=indexcontentssearch - Used only when opening a file from the command line or an Apple Event. Opens the document in the Help window, with the specified navigation panel selected.

-toPostScript options pdf-file ... ps-dir
-toPostScript options -pairs pdf-file1 ps-file1 ...
-toPostScript options
Converts the given pdf_files to PostScript.

In the first form, if the last file specified is a directory, then all preceding files will be converted to PostScript and the generated PostScript files will be placed into ps-dir. If a directory is not specified, then the PostScript files will be placed in the same directory as the original file.

In the second form, the file list contains pairs, each consisting of a PDF filename and a corresponding PostScript filename.

The third form specifies a filter, reading a PDF file from standard input and writing the PostScript file to standardoutput.

Note: When using -toPostScript it must be the first argument passed in on the command line.

The following are valid options for the conversion of PDF to PostScript:

-printerName <name> - this is to print device-dependent PS.
-rotateAndCenter- auto-rotate and center the pages.
-choosePaperByPDFPageSize- use the pdf page size to determine the output tray.
-nUp- <hpage> <vpage> <pageorder> border rotate - print multiple pages on the same sheet of paper.
       hpage,vpage: can take numbers upto 99.

       pageorder: how the pages are ordered on paper. Possible page orders are:

       0 (Horizontal)

       1 (HorizontalReversed)

       2 (Vertical)

       3 (VerticalReversed)

       border: draws the crop-box of PDF pages

       rotate: automatically rotates each page

-booklet <subset> <binding> rotate <from> <to> - prints multiple pages on the same sheet of paper in the order required to read correctly when folded.
        subset: determines which side of the paper print. Possible options are :

       0 (PrintBothSides)

       1 (PrintFrontSideOnly)

       2 (PrintBackSideOnly)

       from,to: specifies the first and last sheet to print.

       rotate: automatically rotates each page.

       binding: determines the orientation for the binding. Possible options are:

       0 (BookletBinding_Left)

       1 (BookletBinding_Right)

       2 (BookletBinding_LeftTall)

       3 (BookletBinding_RightTall)

-binary - emit binary PostScript where possible
-start int - identify the first page in the document to be converted (default is the first page of the document)
-end int - identify the last page in the document to be converted (default is the last page of the document)
-optimizeForSpeed - emit PostScript such that all fonts are emitted once at the beginning of the document. This results in faster transmission times and smaller PostScript documents but requires more PostScript printer virtual memory.
-landscape - rotate the pages to print landscape
-reverse - reverse the page order of the output
-odd - emit only odd-numbered pages
-even - emit only even-numbered pages
-commentsOff - don't print comments
-annotsOff - don't print annots
-stampsOff - don't print stamps
-markupsOn - print document and markups
-level2 - emit Level 2 PostScript (level1 is not supported)
-level3 - emit Level 3 PostScript
-printerhalftones - use the printer default halftones.
-saveVM - download fonts as needed to preserve printer memory
-scale <int> - scale the pages according to the scale factor (default is 100 percent)
-shrink - shrink the pages to fit the page size
-expand - expand the pages to fit the page size
-size <pagesize> - set the page size. The following page sizes are recognized:
       letter - letter size paper

       tabloid - tabloid size paper

       ledger - ledger size paper

       legal - legal size paper

       executive - executive size paper

       a3 - ISO standard A3 size

       a4 - ISO standard A4 size

       a5 - ISO standard A5 size

       b4 - ISO standard B4 size

       b5 - ISO standard B5 size

       wxh - custom size paper where w is the integer width in points and h is the integer height in points

-transQuality level - set the transparency flattening level Value from 1-5, where 1 means rasterize everything, 5 means rasterize as little as possible, default is 3.
Mutually exclusive options
The following are the mutually exclusive print options, their usage together can lead to undesired results:
       1. expand, shrink, nUp and booklet

       2. annotsOff, commentsOff, markupsOn and stampsOff

       3. landscape and choosePaperByPDFPageSize


ACRO_DISABLE_FONT_CONFIG : Set this if you donot want Adobe Reader to cache Font-config fonts.




This program was written by Adobe Systems Incorporated