dwb - a webkit web browser

dwb is a lightweight web browser based on the webkit web browser engine and the gtk toolkit. dwb is highly customizable and can be easily configured through a web interface. It intends to be mostly keyboard driven, inspired by firefox's vimperator plugin.

vi-like shortcuts
Link following via keyboard hints
Bookmarks
Quickmarks
Cookie support, whitelisting of cookies
Proxy support
Userscript support
Tab completion for history, bookmarks, userscripts
Custom stylesheets
Javascript blocker with whitelisting support
Flash plugin blocker with whitelisting support
Adblocking with filterlists
Webinterface for keyboard and settings configuration
Custom commands, binding commandsequences to shortcuts
Extendable via extensions/scripts
Extension manager

This project is hosted at bitbucket. To get a copy of the git-repository run the following command:

git clone git@bitbucket.org:portix/dwb.git

The latest revision of the git-repository can also be downloaded as a zip, tar.gz or tar.bz2 file, a "stable" snapshot can be found here.

Requirements:

libsoup >= 2.32
webkitgtk >= 1.8.0
gtk+-2.0 or gtk+-3.0

Distributions:

dwb is available in the
Arch linux
community repositories. There are also three packages in the AUR, a development version, a gtk3-version and a development gtk3-version.
Debian
packages are available for wheezy and sid.
For
Gentoo
the stable and developer version is available.

dwb can be built and installed by running

make install

The default prefix is /usr, if you want to install dwb to a different location, e.g. /usr/local, run

make PREFIX=/usr/local install

To install dwb to a custom directory, e.g. /opt/usr, run

make DESTDIR=/opt install

To build dwb against GTK+ 3 run

make GTK=3 install

There are several extensions available for dwb, there are some prepackaged extensions that will be installed with the default installation. dwb also comes with an extension manager, extensions can be installed or enabled with

dwbem -i [name of extension]

and uninstalled with

dwbem -r [name of extension]

To get a list of available extensions run

dwbem -a

For further details see the manpage.

If you encounter a bug or have a feature request you can use the bitbucket bugtracker.

For documentation see the manual.

dwb can be extended with all kinds of scripts, scripts must be placed in

$XDG_CONFIG_HOME/dwb/userscripts

or

$HOME/.config/dwb/userscripts

if $XDG_CONFIG_HOME is not defined. Some environment variables will be set in all scripts and it is possible to send commands back to dwb, for details see the manual. However extending scripts with regular scripts is rather limited, for finer-grained control dwb provides a javascript api (stable, unstable).

How can i add a searchengine?

Go to the site you wish to add, type "gs" (the default shortcut for save_search_field), choose the input field with tab, type a keyword and press enter. The first searchengine will be the default. Search engines can be accessed in the url bar via

Is adblocking supported in dwb?

dwb supports most adblock+ filterrules. A adblock subscription script is also available, to install it run

dwbem -i adblock_subscriptions

Subscriptions can then be added with

:adblock_subscribe

and removed with

:adblock_unsubscribe

Can i use greasmonkey scripts with dwb?

Most greasemonkey scripts work when the

userscripts extension

is installed. To install it simply run

dwbem -i userscripts

greasemonkey scripts placed in

$XDG_CONFIG_HOME/dwb/greasemonkey/

will be loaded automatically.

Some browsers with a similar approach:

You can join

#dwb

on irc.freenode.net or write an email to

portix at gmx dot net

.