.TH lariza 1 "2020-05-02" "lariza" "User Commands"
.\" --------------------------------------------------------------------
.SH NAME
lariza \- simple web browser
.\" --------------------------------------------------------------------
.SH SYNOPSIS
\fBlariza\fP
[\fB\-C\fP]
[\fIURI ...\fP]
.\" --------------------------------------------------------------------
.SH DESCRIPTION
\fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
.\" --------------------------------------------------------------------
.SH OPTIONS
In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
about the following options:
.TP
\fB\-C\fP
Disables cooperative instances.
.P
After these options there can be any number of URIs. If no URIs are
given, $\fBLARIZA_HOME_URI\fP will be opened.
.\" --------------------------------------------------------------------
.SH ENVIRONMENT
In addition to the standard variables of GTK+ 3, \fBlariza\fP knows
about the following environment variables:
.P
.TP
\fBLARIZA_ACCEPTED_LANGUAGE\fP
In HTTP requests, WebKit sets the \(lqAccepted-Language\(rq header to
this value. Defaults to \fBen-US\fP.
.TP
\fBLARIZA_DOWNLOAD_DIR\fP
All downloads are automatically stored in this directory. If you want to
stick to XDG directories, then you should configure your
\(lqxdg-user-dirs\(rq and use this:

\f(CW
.nf
\&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
.fi
\fP

This variable defaults to \fB/var/tmp\fP.
.TP
\fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP
Enable writing WebKit console messages to stdout.
.TP
\fBLARIZA_FIFO_SUFFIX\fP
Cooperative instances are implemented using a named pipe in the file
system. The name of this pipe usually is (at least on modern systems
following XDG \(lqstandards\(rq):
\fI/var\:/run\:/user\:/$UID\:/lariza.fifo\:-$LARIZA_FIFO_SUFFIX\fP.

$\fBUID\fP is the id of your user. $\fBLARIZA_FIFO_SUFFIX\fP defaults to
\fBmain\fP. If you change this variable, you can launch several
independent cooperative instances of \fBlariza\fP.
.TP
\fBLARIZA_HISTORY_FILE\fP
If set, \fBlariza\fP will write each visited URI to that file. This path
can point to a named pipe, but be aware that the browser will block
until a reader at the other end of the pipe has read all pending data.
.TP
\fBLARIZA_HOME_URI\fP
This URI will be opened by pressing the appropriate hotkeys
(\(lqhomepage\(rq or \(lqnew window\(rq) and if no URIs are specified on
the command line. Defaults to \fBabout:blank\fP.
.TP
\fBLARIZA_TAB_POS\fP
Can be one of \fBtop\fP (default), \fBright\fP, \fBbottom\fP,
\fBleft\fP.
.TP
\fBLARIZA_TAB_WIDTH_CHARS\fP
An integer, determines width of tabs. Defaults to 20.
.TP
\fBLARIZA_USER_AGENT\fP
\fBlariza\fP will identify itself with this string. Uses WebKit's
default value if unset.
.TP
\fBLARIZA_ZOOM
Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
.\" --------------------------------------------------------------------
.SH FILES
XDG variables will be used to construct these paths.
.TP
\fI~/.config\:/lariza\:/adblock.black\fP
Adblock patterns. See \fBlariza.usage\fP(1).
.TP
\fI~/.config\:/lariza\:/certs\fP
Directory where trusted certificates are stored. See
\fBlariza.usage\fP(1).
.TP
\fI~/.config\:/lariza\:/scripts\fP
Directory to store user-supplied JavaScript snippets. See
\fBlariza.usage\fP(1).
.TP
\fI~/.local\:/share\:/lariza\:/web_extensions\fP
Sets the directory where WebKit will look for web extensions. See
\fBlariza.usage\fP(1).
.TP
\fI~/.cache\:/lariza\fP
.TQ
\fI~/.cache\:/webkitgtk\fP
.TQ
\fI~/.local\:/share\:/webkitgtk\fP
WebKitGTK will dump its caches and local storage here. It is probably
wise to clean those directories regularly or to mount them as
\fBtmpfs\fP(5).
.\" --------------------------------------------------------------------
.SH LICENSE
\fBlariza\fP is released under the MIT license. See the accompanying
\fILICENSE\fP file.
.\" --------------------------------------------------------------------
.SH HISTORY
\fBlariza\fP was originally written by Peter Hofmann. The project
was started in June 2014.
.\" --------------------------------------------------------------------
.SH "SEE ALSO"
.BR lariza.usage (1).