1<?xml version="1.0" encoding="utf-8"?>
2<page xmlns="http://projectmallard.org/1.0/" type="topic" style="task" id="commandline" xml:lang="wa">
3
4  <info>
5    <link type="guide" xref="index#advanced"/>
6    <title type="sort">Command line</title>
7    <desc>The <cmd>atril</cmd> command can open any number of files, at specific pages and in various modes.</desc>
8    <revision pkgversion="1.25" version="0.1" date="2021-03-13" status="final"/>
9    <credit type="author">
10      <name>Phil Bull</name>
11      <email>philbull@gmail.com</email>
12    </credit>
13    <credit type="editor">
14    <name>Tiffany Antopolski</name>
15    <email>tiffany@antopolski.com</email>
16    </credit>
17    <license>
18      <p>Creative Commons Share Alike 3.0</p>
19    </license>
20  </info>
21
22<title>The command line</title>
23<p>
24To start<app>Atril</app> from the command line, type <cmd>atril</cmd>. You
25can open a specific file by typing the filename after the atril command:
26</p>
27
28<screen>atril file.pdf</screen>
29<p>
30You can open multiple files by typing the filenames after the atril command, separating the filenames by a space:
31</p>
32<screen>atril file1.pdf file2.pdf</screen>
33<p>
34Atril also supports the handling of files on the web.  For example, after the atril command you can give the location of a file on the web:
35</p>
36<section id="open">
37    <title>Opening a document at a specific page</title>
38    <p>
39    You can use<cmd>--page-label</cmd> switch to open a document at a
40    specific page. For example, to open a document to page 3, you would type:
41    </p>
42    <screen>atril --page-label=3 file.pdf</screen>
43    <p>
44    The page label should be in the same format as the page number displayed in
45   <app>Atril</app> header bar.
46    </p>
47</section>
48<section id="fullsreen">
49    <title>Opening a document in fullscreen mode</title>
50    <screen>atril --fullscreen file.pdf</screen>
51</section>
52<section id="presentation">
53    <title>Opening a document in presentation mode</title>
54    <screen>atril --presentation file.pdf</screen>
55</section>
56<section id="preview">
57    <title>Opening a document in preview mode</title>
58    <screen>atril --preview file.pdf</screen>
59</section>
60</page>
61