1 .TH lariza 1 "2020-04-25" "lariza" "User Commands"
2 .\" --------------------------------------------------------------------
4 lariza \- simple web browser
5 .\" --------------------------------------------------------------------
10 .\" --------------------------------------------------------------------
12 \fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
13 .\" --------------------------------------------------------------------
15 In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
16 about the following options:
19 Disables cooperative instances.
21 After these options there can be any number of URIs. If no URIs are
22 given, $\fBLARIZA_HOME_URI\fP will be opened.
23 .\" --------------------------------------------------------------------
25 In addition to the standard variables of GTK+ 3, \fBlariza\fP knows
26 about the following environment variables:
29 \fBLARIZA_ACCEPTED_LANGUAGE\fP
30 In HTTP requests, WebKit sets the \(lqAccepted-Language\(rq header to
31 this value. Defaults to \fBen-US\fP.
33 \fBLARIZA_DOWNLOAD_DIR\fP
34 All downloads are automatically stored in this directory. If you want to
35 stick to XDG directories, then you should configure your
36 \(lqxdg-user-dirs\(rq and use this:
40 \&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
44 This variable defaults to \fB/var/tmp\fP.
46 \fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP
47 Enable writing WebKit console messages to stdout.
49 \fBLARIZA_FIFO_SUFFIX\fP
50 Cooperative instances are implemented using a named pipe in the file
51 system. The name of this pipe usually is (at least on modern systems
52 following XDG \(lqstandards\(rq):
53 \fI/var\:/run\:/user\:/$UID\:/lariza.fifo\:-$LARIZA_FIFO_SUFFIX\fP.
55 $\fBUID\fP is the id of your user. $\fBLARIZA_FIFO_SUFFIX\fP defaults to
56 \fBmain\fP. If you change this variable, you can launch several
57 independent cooperative instances of \fBlariza\fP.
59 \fBLARIZA_HISTORY_FILE\fP
60 If set, \fBlariza\fP will write each visited URI to that file. This path
61 can point to a named pipe, but be aware that the browser will block
62 until a reader at the other end of the pipe has read all pending data.
65 This URI will be opened by pressing the appropriate hotkeys
66 (\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
67 the command line. Defaults to \fBabout:blank\fP.
70 Can be one of \fBtop\fP (default), \fBright\fP, \fBbottom\fP,
73 \fBLARIZA_USER_AGENT\fP
74 \fBlariza\fP will identify itself with this string. Uses WebKit's
75 default value if unset.
78 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
79 .\" --------------------------------------------------------------------
81 XDG variables will be used to construct these paths.
83 \fI~/.config\:/lariza\:/adblock.black\fP
84 Adblock patterns. See \fBlariza.usage\fP(1).
86 \fI~/.config\:/lariza\:/certs\fP
87 Directory where trusted certificates are stored. See
88 \fBlariza.usage\fP(1).
90 \fI~/.config\:/lariza\:/keywordsearch\fP
91 Configuration file for keyword base searching. See
92 \fBlariza.usage\fP(1).
94 \fI~/.config\:/lariza\:/scripts\fP
95 Directory to store user-supplied JavaScript snippets. See
96 \fBlariza.usage\fP(1).
98 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
99 Sets the directory where WebKit will look for web extensions. See
100 \fBlariza.usage\fP(1).
102 The executable \fIlariza-external-handler\fP must be located somewhere
103 in your $\fBPATH\fP, if you want to make use of the external URI
104 handler. See \fBlariza.usage\fP(1) for details.
105 .\" --------------------------------------------------------------------
107 \fBlariza\fP is released under the MIT license. See the accompanying
109 .\" --------------------------------------------------------------------
111 \fBlariza\fP was originally written by Peter Hofmann. The project
112 was started in June 2014.
113 .\" --------------------------------------------------------------------
115 .BR lariza.usage (1).