man/chorizo-usage.1.scd

   1 chorizo-usage(1)
   2
   3 # NAME
   4 chorizo-usage - extended usage hints
   5
   6 # DESCRIPTION
   7 *chorizo* is a simple web browser using GTK+ 3, GLib and WebKit2GTK+. This
   8 manpage contains additional hints and pointers regarding its usage.
   9
  10 # KEYBINDINGS AND CONFIGURATION
  11 For this information, please refer to *chorizo-config*(5).
  12
  13 # DOWNLOAD MANAGER
  14 Open the download manager using the appropriate hotkey. A new window listing
  15 your downloads will appear. Clicking on an item will remove it from the list and
  16 **if needed** cancel the download.
  17
  18 There's no file manager integration, nor does *chorizo* delete, overwrite or
  19 resume downloads. If a file already exists, it won't be touched. Instead, the
  20 new file name will have a suffix such as *.1*, *.2*, *.3*, and so on.
  21
  22 # USER-SUPPLIED JAVASCRIPT FILES
  23 When a page is being loaded, the directory _~/.local/share/chorizo/user-scripts_
  24 will be scanned and each file in it ending with *.js* will be run as a
  25 JavaScript file in the context of said page.
  26
  27 *chorizo* comes with the following scripts:
  28
  29 *hints.js*
  30         Press *f* (open link in current window) or *F* (open in new window) to
  31         activate link hints. After typing the characters for one of them, press
  32         *Enter* to confirm. Press *Escape* to abort.
  33
  34 *privacy-redirect.js*
  35         Redirects YouTube, Reddit, etc to privacy respecting alternatives.
  36
  37 *darkreader.js*
  38         See https://darkreader.org.
  39
  40 Those bundled scripts are automatically installed on *make install*. To use
  41 them, though, make sure to link them to the directory mentioned above.
  42
  43 # USER-SUPPLIED CSS FILES
  44 User supplied CSS files will be scanned for from
  45 _~/.local/share/chorizo/user-styles_, and be applied every time a page
  46 loads. The rules in these files override any rules provided by the website.
  47
  48 # WEB EXTENSIONS
  49 On startup, WebKit checks _~/.local/share/chorizo/web_extensions_ for any *.so*
  50 files. See
  51 <http://blogs.igalia.com/carlosgc/2013/09/10/webkit2gtk-web-process-extensions/>
  52 this blog post for further information on these extensions.
  53
  54 *chorizo* comes with the following extensions:
  55
  56 *we_adblock.so*
  57         Generic adblock. Reads patterns from the file _~/.config/chorizo/adblock_. Each
  58         line can contain a regular expression. These expressions match
  59         case-insensitive and partially, i.e.*\*foo.\** is the same as *.\*FOO.\** and
  60         you can use anchors like *^https?://...*. Please refer to
  61         https://developer.gnome.org/glib/stable/glib-regex-syntax.html the GLib
  62         reference for more details. Lines starting with "#" are ignored.
  63
  64         Those bundled web extensions are automatically compiled when you run *make*
  65         and installed on *make install*. To use them, though, make sure to link them
  66         to the directory mentioned above.
  67
  68 # TRUSTED CERTIFICATES
  69 By default, *chorizo* trusts whatever CAs are trusted by WebKit. If you wish to
  70 trust additional certificates, such as self-signed certificates, the first thing
  71 you should do is try to add the appropriate CAs to your system-wide store.
  72
  73 If you wish to add simple exceptions, you can grab the certificate and store it
  74 in the directory _~/.local/share/chorizo/certs_. The filename must be equal to
  75 the hostname:
  76
  77         $ echo | openssl s_client -connect foo.de:443 | openssl x509 >foo.de
  78
  79 This tells *chorizo* to trust the given certificate when connecting to host
  80 *foo.de*.
  81
  82 Note: This is NOT equal to certificate pinning. WebKit ignores user-specified
  83 certificates if the server's certificate can be validated by any system-wide CA.
  84
  85 # SEE ALSO
  86 *chorizo*(1), *chorizo-config*(5)