lariza(1)

NAME
lariza - simple web browser

SYNOPSIS
lariza [-C] [URI ...]

DESCRIPTION
lariza is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.

OPTIONS
In addition to the standard arguments of GTK+ 3, lariza knows about the following options:

-C  Disables cooperative instances.

After these options there can be any number of URIs. If no URIs are given, $LARIZA_HOME_URI will be opened.

ENVIRONMENT
In addition to the standard variables of GTK+ 3, lariza knows about the following environment variables:

LARIZA_ACCEPTED_LANGUAGE
    In HTTP requests, WebKit sets the “Accepted-Language” header to this value. Defaults to en-US.

LARIZA_DISABLE_SMOOTH_SCROLLING
    When set, smooth scrolling will be disabled.

LARIZA_DOWNLOAD_DIR
    All downloads are automatically stored in this directory. If you want to stick to XDG directories, then you should configure your “xdg-user-dirs” and use this:
    LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
    This variable defaults to /var/tmp.

LARIZA_ENABLE_CONSOLE_TO_STDOUT
    Enable writing WebKit console messages to stdout.

LARIZA_FIFO_SUFFIX
    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 “standards”): /var/run/user/$UID/lariza.fifo-$LARIZA_FIFO_SUFFIX. $UID is the id of your user. $LARIZA_FIFO_SUFFIX defaults to main. If you change this variable, you can launch several independent cooperative instances of lariza.

LARIZA_HISTORY_FILE
    If set, lariza 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.

LARIZA_HOME_URI
    This URI will be opened by pressing the appropriate hotkeys (“homepage” or “new window”) and if no URIs are specified on the command line. Defaults to about:blank.

LARIZA_TAB_POS
    Can be one of top (default), right, bottom, left.

LARIZA_TAB_WIDTH_CHARS
    An integer, determines width of tabs. Defaults to 20.

LARIZA_USER_AGENT
    lariza will identify itself with this string. Uses WebKit's default value if unset.

LARIZA_ZOOM
    Zoom level for WebKit viewports. Defaults to 1.0.

FILES
XDG variables will be used to construct these paths.

~/.config/lariza/adblock
    Adblock patterns. See lariza.usage(1).

~/.config/lariza/certs
    Directory where trusted certificates are stored. See lariza.usage(1).

~/.config/lariza/scripts
    Directory to store user-supplied JavaScript snippets. See lariza.usage(1).

~/.local/share/lariza/web_extensions
    Sets the directory where WebKit will look for web extensions. See lariza.usage(1).

~/.cache/lariza
~/.cache/webkitgtk
~/.local/share/webkitgtk
    WebKitGTK will dump its caches and local storage here. It is probably wise to clean those directories regularly or to mount them as tmpfs(5).

LICENSE
lariza is released under the MIT license. See the accompanying LICENSE file.

HISTORY
lariza was originally written by Peter Hofmann. The project was started in June 2014.

SEE ALSO
lariza.usage(1).