==========
-A simple web browser using GTK+ 2, GLib and WebKitGTK+.
+A simple web browser using GTK+ 3, GLib and WebKit2GTK+.
Features:
- - A WebKit viewport
+ - A WebKit2 viewport
- An input box to change the URI or to search the current page
- Built-in launching of suckless' tabbed
- - Built-in adblock
- Built-in download manager
- Optimized hotkeys: Left hand on keyboard, right hand on mouse
- Keyword based searching: Opening "wi foo" will search wikipedia
- Global content zoom
- - View source mode
- Cooperative instances using FIFOs
- Support for Flash and Java
+==============================================
+IMPORTANT: Current state of the WebKit2 branch
+==============================================
+
+WebKit1 is essentially dead. Sooner or later, we have to jump to
+WebKit2. See also:
+
+http://blogs.igalia.com/carlosgc/2014/08/01/webkitgtk-2-5-1-good-bye-webkit1/
+
+There's a number of issues on this branch:
+
+ - No adblock support. As stated in commit f1174ff, this has to be
+ implemented as a "WebKit2 web extension". Maybe do this in a
+ project of its own?
+ - "View source" mode is not yet ported. This feature has been
+ removed from WebKit2, so we have to invent some way to re-create
+ this...
+ - There's an annoying border around the WebView widget.
+ - There may be a hell lot of other issues that I have not yet
+ encountered.
+
+However, important issues of the original WebKit1 lariza have been
+fixed:
+
+ - Those pages that crash all WebKit1 browsers do work now.
+ - The "back" button works reliably.
+
+
==============
About the name
==============
lariza tries not to exceed 1000 lines of code.
+That being said, this kind of minimalism is not for everyone. If you're
+looking for more features (and a more open feature policy), then you
+might want to check out okraits' fork:
+
+ https://github.com/okraits/lariza/
+
========================
Using lariza with tabbed
Close the current window.
Mod1 + w
- Go to your "homepage" which is the first URI specified on
- the command line.
+ Go to your "homepage". See the environment variable
+ $LARIZA_HOME_URI.
Mod1 + e
Open a new window.
- Mod1 + s
- Toggles "view source mode". This will display the web pages
- source code. Note that the page will be reloaded (which is
- annoying but WebKit enforces this).
-
Mod1 + r
Reload the current page.
Backward / forward (mouse keys 8 and 9)
Does the obvious.
- Mod1 + Wheel up or Ctrl + Wheel up
+ Mod1 + Scroll up or Ctrl + Scroll up
Increase zoom level of the current page.
- Mod1 + Wheel down or Ctrl + Wheel down
+ Mod1 + Scroll down or Ctrl + Scroll down
Decrase zoom level of the current page.
+ Mod1 + Scroll horizontally or Ctrl + Scroll horizontally
+ Reset zoom to $LARIZA_ZOOM.
+
When the location bar is focused:
Download manager
- Mod1 + q
+ Mod1 + d
Close the download manager (downloads are not aborted).
lariza [OPTION]... [URI]...
-In addition to the standard arguments of GTK+ 2, lariza knows about the
+In addition to the standard arguments of GTK+ 3, lariza knows about the
following options:
-e <wid>
window specified by <wid>. The download manager is always a
"popup".
- -r
- Print all navigation requests on STDERR.
-
-C
Disables cooperative instances.
Disables automatic launching of suckless' tabbed.
After these options there can be any number of URIs. If no URIs are
-given, about:blank will be opened.
+given, $LARIZA_HOME_URI will be opened.
=====================
Environment variables
=====================
-In addition to the standard variables of GTK+ 2, lariza knows about the
+In addition to the standard variables of GTK+ 3, lariza knows about the
following environment variables:
LARIZA_ACCEPTED_LANGUAGE
"main". If you change this variable, you can launch several
independent cooperative instances of lariza.
- LARIZA_ZOOM
- Zoom level for WebKit viewports. Defaults to 1.0.
-
-
-=======
-Adblock
-=======
-
-lariza has built-in adblock functionality. In each line of
+ 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".
- ~/.config/lariza/adblock.black
+ LARIZA_USER_AGENT
+ Lariza will identify itself with this string. Uses WebKit's
+ default value if unset.
-you can store a regular expression. These expressions match
-case-insensitive and partially, i.e. ".*foo.*" is the same as ".*FOO.*"
-and you can use anchors like "^https?://...".
-
-Lines starting with "#" are ignored.
+ LARIZA_ZOOM
+ Zoom level for WebKit viewports. Defaults to 1.0.
=======================
lariza needs the following Arch Linux packages:
- - gtk2
- - webkitgtk2
+ - gtk3
+ - webkit2gtk (WebKit2 API for GTK+ 3)
==========
API references:
- - http://webkitgtk.org/reference/webkitgtk/stable/index.html
- - https://developer.gnome.org/gtk2/stable/index.html
+ - http://webkitgtk.org/reference/webkit2gtk/stable/index.html
+ - https://developer.gnome.org/gtk3/stable/index.html
- https://developer.gnome.org/glib/stable/index.html
-
-Regular expressions supported by GRegex, you can use these in your
-adblock patterns:
-
- - https://developer.gnome.org/glib/stable/glib-regex-syntax.html