man1/lariza.1

   1 .TH lariza 1 "2021-01-03" "lariza" "User Commands"
   2 .\" --------------------------------------------------------------------
   3 .SH NAME
   4 lariza \- simple web browser
   5 .\" --------------------------------------------------------------------
   6 .SH SYNOPSIS
   7 \fBlariza\fP
   8 [\fB\-C\fP]
   9 [\fIURI ...\fP]
  10 .\" --------------------------------------------------------------------
  11 .SH DESCRIPTION
  12 \fBlariza\fP is a simple web browser using GTK+ 3, GLib and WebKit2GTK+.
  13 .\" --------------------------------------------------------------------
  14 .SH OPTIONS
  15 In addition to the standard arguments of GTK+ 3, \fBlariza\fP knows
  16 about the following options:
  17 .TP
  18 \fB\-C\fP
  19 Disables cooperative instances.
  20 .P
  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 .\" --------------------------------------------------------------------
  24 .SH ENVIRONMENT
  25 In addition to the standard variables of GTK+ 3, \fBlariza\fP knows
  26 about the following environment variables:
  27 .P
  28 .TP
  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.
  32 .TP
  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:
  37
  38 \f(CW
  39 .nf
  40 \&LARIZA_DOWNLOAD_DIR=$(xdg-user-dir DOWNLOAD)
  41 .fi
  42 \fP
  43
  44 This variable defaults to \fB/var/tmp\fP.
  45 .TP
  46 \fBLARIZA_ENABLE_CONSOLE_TO_STDOUT\fP
  47 Enable writing WebKit console messages to stdout.
  48 .TP
  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.
  54
  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.
  58 .TP
  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.
  63 .TP
  64 \fBLARIZA_HOME_URI\fP
  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.
  68 .TP
  69 \fBLARIZA_TAB_POS\fP
  70 Can be one of \fBtop\fP (default), \fBright\fP, \fBbottom\fP,
  71 \fBleft\fP.
  72 .TP
  73 \fBLARIZA_TAB_WIDTH_CHARS\fP
  74 An integer, determines width of tabs. Defaults to 20.
  75 .TP
  76 \fBLARIZA_USER_AGENT\fP
  77 \fBlariza\fP will identify itself with this string. Uses WebKit's
  78 default value if unset.
  79 .TP
  80 \fBLARIZA_ZOOM
  81 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
  82 .\" --------------------------------------------------------------------
  83 .SH FILES
  84 XDG variables will be used to construct these paths.
  85 .TP
  86 \fI~/.config\:/lariza\:/adblock\fP
  87 Adblock patterns. See \fBlariza.usage\fP(1).
  88 .TP
  89 \fI~/.config\:/lariza\:/certs\fP
  90 Directory where trusted certificates are stored. See
  91 \fBlariza.usage\fP(1).
  92 .TP
  93 \fI~/.config\:/lariza\:/scripts\fP
  94 Directory to store user-supplied JavaScript snippets. See
  95 \fBlariza.usage\fP(1).
  96 .TP
  97 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
  98 Sets the directory where WebKit will look for web extensions. See
  99 \fBlariza.usage\fP(1).
 100 .TP
 101 \fI~/.cache\:/lariza\fP
 102 .TQ
 103 \fI~/.cache\:/webkitgtk\fP
 104 .TQ
 105 \fI~/.local\:/share\:/webkitgtk\fP
 106 WebKitGTK will dump its caches and local storage here. It is probably
 107 wise to clean those directories regularly or to mount them as
 108 \fBtmpfs\fP(5).
 109 .\" --------------------------------------------------------------------
 110 .SH LICENSE
 111 \fBlariza\fP is released under the MIT license. See the accompanying
 112 \fILICENSE\fP file.
 113 .\" --------------------------------------------------------------------
 114 .SH HISTORY
 115 \fBlariza\fP was originally written by Peter Hofmann. The project
 116 was started in June 2014.
 117 .\" --------------------------------------------------------------------
 118 .SH "SEE ALSO"
 119 .BR lariza.usage (1).