.Dd Jul 17, 2021
.Dt lariza 1
.Sh NAME
.Nm lariza
.Nd simple web browser
.Sh SYNOPSIS
.Nm
.Op Fl C
.Op Ar URI...
.Sh DESCRIPTION
.Nm
is a simple web browser using GTK+3, GLib and Webkit2GTK+
.Sh OPTIONS
In addition to the standard arguments of GTK+3,
.Nm
knows about the following options:
.Bl -tag
.It Fl C
Disables cooperative instances.
.El
.Pp
After these options there can be any number of
.Ar URIs .
If no
.Ar URIs
are given, $\fBLARIZA_HOME_URI\fP will be opened.
.Sh ENVIRONMENT
In addition to the standard variables of GTK+3,
.Nm
knows about the following environment variables:
.Bl -tag
.It Sy LARIZA_ACCEPTED_LANGUAGE
In HTTP requests, WebKit sets the
.Dq Accepted-Language
header to this value. Defaults to
.Sy en-US .
.It Sy LARIZA_DOWNLOAD_DIR
All downloads are automatically stored in this directory. If this variable,
doesn't exist,
.Nm
will try to form a directory using the
.Ev XDG_DOWNLOAD_DIR
specification, and fallback to
.Pa /var/tmp
if it fails.
.It Sy LARIZA_ENABLE_CONSOLE_TO_STDOUT
Enable writing WebKit console messages to stdout.
.It Sy LARIZA_FIFO_SUFFIX
Cooperative instances are implemented using a named pipe in the file system. The
name of this pipe usually is
.Pq at least on modern systems following XDG Dq standards :
.Pa /var/run/user/$UID/lariza.fifo-$LARIZA_FIFO_SUFFIX .
.Pp
.Sy $UID
is the id of your user.
.Sy $LARIZA_FIFO_SUFFIX
defaults to
.Sy main .
If you change this variable, you can launch several independent cooperative
instances of
.Nm .
.It Sy LARIZA_HISTORY_FILE
If set,
.Nm
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.
.It Sy LARIZA_HOME_URI
This URI will be opened by pressing the appropriate hokeys
.Pq Do homepage Dc or Do new window Dc
and if no URIs are specified on the command line. Defaults to
.Sy about:blank .
.It Sy LARIZA_SEARCH_ENGINE
This URI will be used to format the given search. The URI must contain a
.Sq %s
so that the search can be formatted. This option can also be changed from the
.Pa config.h
file during compilation time. Defaults to
.Lk https://duckduckgo.com/?q=%s
.It Sy LARIZA_TAB_POS
Can be one of
.Sy top
.Pq default ,
.Sy right , bottom, left .
.It Sy LARIZA_TAB_WIDTH_CHARS
An integer, determines width of tabs. Defaults to 20.
.It Sy LARIZA_USER_AGENT
.Nm
will identify itself with this string. Uses WebKit's default value if unset.
.It Sy LARIZA_ZOOM
Zoom level for WebKit viewports. Defaults to 1.0.
.El
.Sh FILES
XDG variables will be used to construct these paths.
.Bl -tag
.It Pa ~/.config/lariza/adblock
Adblock patterns. See
.Xr lariza.usage 1 .
.It Pa ~/.config/lariza/certs
Directory where trusted certificates are stored. See
.Xr lariza.usage 1 .
.It Pa ~/.config/lariza/scripts
Directory to store user-supplied JavaScript snippets. See
.Xr lariza.usage 1 .
.It Pa ~/.cache/lariza , ~/.cache/webkitgtk , ~/.local/share/webkitgtk
WebKitGTK will dump its caches and local storage here.
.It Pa ~/.cache/lariza/cookies.txt
.Nm
will save its cookies in this text file.
.El
.Sh LICENSE
.Nm
is released under the MIT license. See the accompanying
.Pa LICENSE
file.
.Sh NOTES
This is a fork of
.Nm ,
and not the original source. If you want the original source, visit
.Lk https://uninformativ.de/git/lariza .
.Pp
The source of this fork is available on
.Lk https://git.carbslinux.org/users/merakor/lariza .
Send bug reports to
.An Cem Keylan Aq Mt cem@ckyln.com .
.Sh HISTORY
.Nm
was originally written by Peter Hofmann. The project was started in June 2014.
.Sh SEE ALSO
.Xr lariza.usage 1