man1/lariza.1

   1 .TH lariza 1 "2020-04-24" "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_USER_AGENT\fP
  70 \fBlariza\fP will identify itself with this string. Uses WebKit's
  71 default value if unset.
  72 .TP
  73 \fBLARIZA_ZOOM
  74 Zoom level for WebKit viewports. Defaults to \fB1.0\fP.
  75 .\" --------------------------------------------------------------------
  76 .SH FILES
  77 XDG variables will be used to construct these paths.
  78 .TP
  79 \fI~/.config\:/lariza\:/adblock.black\fP
  80 Adblock patterns. See \fBlariza.usage\fP(1).
  81 .TP
  82 \fI~/.config\:/lariza\:/certs\fP
  83 Directory where trusted certificates are stored. See
  84 \fBlariza.usage\fP(1).
  85 .TP
  86 \fI~/.config\:/lariza\:/keywordsearch\fP
  87 Configuration file for keyword base searching. See
  88 \fBlariza.usage\fP(1).
  89 .TP
  90 \fI~/.config\:/lariza\:/scripts\fP
  91 Directory to store user-supplied JavaScript snippets. See
  92 \fBlariza.usage\fP(1).
  93 .TP
  94 \fI~/.local\:/share\:/lariza\:/web_extensions\fP
  95 Sets the directory where WebKit will look for web extensions. See
  96 \fBlariza.usage\fP(1).
  97 .P
  98 The executable \fIlariza-external-handler\fP must be located somewhere
  99 in your $\fBPATH\fP, if you want to make use of the external URI
 100 handler. See \fBlariza.usage\fP(1) for details.
 101 .\" --------------------------------------------------------------------
 102 .SH LICENSE
 103 \fBlariza\fP is released under the MIT license. See the accompanying
 104 \fILICENSE\fP file.
 105 .\" --------------------------------------------------------------------
 106 .SH HISTORY
 107 \fBlariza\fP was originally written by Peter Hofmann. The project
 108 was started in June 2014.
 109 .\" --------------------------------------------------------------------
 110 .SH "SEE ALSO"
 111 .BR lariza.usage (1).