1 .TH lariza 1 "2020-03-11" "lariza" "User Commands"
2 .\" --------------------------------------------------------------------
4 lariza \- simple web browser
5 .\" --------------------------------------------------------------------
12 .\" --------------------------------------------------------------------
14 \fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
15 .\" --------------------------------------------------------------------
17 In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
18 about the following options:
21 Embeds the main window and all newly created windows in the window
22 specified by \fIwid\fP. The download manager is always a \(lqpopup\(rq.
25 Disables cooperative instances.
28 Disables automatic launching of suckless' \fBtabbed\fP(1).
30 After these options there can be any number of URIs. If no URIs are
31 given, $\fBLARIZA_HOME_URI\fP will be opened.
32 .\" --------------------------------------------------------------------
34 In addition to the standard variables of GTK+ 3, \fBlariza\fP knows
35 about the following environment variables:
38 \fBLARIZA_ACCEPTED_LANGUAGE\fP
39 In HTTP requests, WebKit sets the \(lqAccepted-Language\(rq header to
40 this value. Defaults to \fBen-US\fP.
42 \fBLARIZA_DOWNLOAD_DIR\fP
43 All downloads are automatically stored in this directory. If you want to
44 stick to XDG directories, then you should configure your
45 \(lqxdg-user-dirs\(rq and use this:
49 \&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
53 This variable defaults to \fB/var/tmp\fP.
55 \fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP
56 Enable writing WebKit console messages to stdout.
58 \fBLARIZA_FIFO_SUFFIX\fP
59 Cooperative instances are implemented using a named pipe in the file
60 system. The name of this pipe usually is (at least on modern systems
61 following XDG \(lqstandards\(rq):
62 \fI/var\:/run\:/user\:/$UID\:/lariza.fifo\:-$LARIZA_FIFO_SUFFIX\fP.
64 $\fBUID\fP is the id of your user. $\fBLARIZA_FIFO_SUFFIX\fP defaults to
65 \fBmain\fP. If you change this variable, you can launch several
66 independent cooperative instances of \fBlariza\fP.
68 \fBLARIZA_HISTORY_FILE\fP
69 If set, \fBlariza\fP will write each visited URI to that file. This path
70 can point to a named pipe, but be aware that the browser will block
71 until a reader at the other end of the pipe has read all pending data.
74 This URI will be opened by pressing the appropriate hotkeys
75 (\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
76 the command line. Defaults to \fBabout:blank\fP.
78 \fBLARIZA_USER_AGENT\fP
79 \fBlariza\fP will identify itself with this string. Uses WebKit's
80 default value if unset.
83 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
84 .\" --------------------------------------------------------------------
86 XDG variables will be used to construct these paths.
88 \fI~/.config\:/lariza\:/adblock.black\fP
89 Adblock patterns. See \fBlariza.usage\fP(1).
91 \fI~/.config\:/lariza\:/certs\fP
92 Directory where trusted certificates are stored. See
93 \fBlariza.usage\fP(1).
95 \fI~/.config\:/lariza\:/keywordsearch\fP
96 Configuration file for keyword base searching. See
97 \fBlariza.usage\fP(1).
99 \fI~/.config\:/lariza\:/scripts\fP
100 Directory to store user-supplied JavaScript snippets. See
101 \fBlariza.usage\fP(1).
103 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
104 Sets the directory where WebKit will look for web extensions. See
105 \fBlariza.usage\fP(1).
107 The executable \fIlariza-external-handler\fP must be located somewhere
108 in your $\fBPATH\fP, if you want to make use of the external URI
109 handler. See \fBlariza.usage\fP(1) for details.
110 .\" --------------------------------------------------------------------
112 \fBlariza\fP is released under the MIT license. See the accompanying
114 .\" --------------------------------------------------------------------
116 \fBlariza\fP was originally written by Peter Hofmann. The project
117 was started in June 2014.
118 .\" --------------------------------------------------------------------
120 .BR lariza.usage (1),