{{Article summary text|This article addresses the steps necessary to run and configure dwb.}}

+

{{Article summary end}}

[[tr:dwb]]

[[tr:dwb]]

+

{{DISPLAYTITLE:dwb}}

[http://portix.bitbucket.org/dwb/ dwb] is an extremely fast, lightweight and flexible web browser using the webkit engine.

[http://portix.bitbucket.org/dwb/ dwb] is an extremely fast, lightweight and flexible web browser using the webkit engine.

It is customizable through its web interface and fully usable with keyboard shortcuts.

It is customizable through its web interface and fully usable with keyboard shortcuts.

Line 7:

Line 10:

== Installation ==

== Installation ==

The {{Pkg|dwb}} package can be found in the [[Official Repositories|official repositories]] and can be installed with [[pacman]].

The {{Pkg|dwb}} package can be found in the [[Official Repositories|official repositories]] and can be installed with [[pacman]].

−

+

# pacman -S dwb

−

There is also various development versions available in the AUR:

+

There are also other versions in the [[AUR]]: {{AUR|dwb-hg}}, {{AUR|dwb-gtk3}}, and {{AUR|dwb-gtk3-hg}}.

−

the [https://aur.archlinux.org/packages.php?ID=36050 development version],

−

the [https://aur.archlinux.org/packages.php?ID=59201 GTK3 version],

−

and the [https://aur.archlinux.org/packages.php?ID=51874 development GTK3 version].

== Basic usage ==

== Basic usage ==

Line 27:

Line 27:

Almost everything can be configured from the ''Settings'' page. You can access it with {{keypress|S}}{{keypress|s}} by default.

Almost everything can be configured from the ''Settings'' page. You can access it with {{keypress|S}}{{keypress|s}} by default.

−

The configuration files are stored in {{ic|$XDG_CONFIG_HOME/dwb/}}.

+

The configuration files are stored in {{ic|$XDG_CONFIG_HOME/dwb/}} (usually {{ic| ~/.config/dwb/}}).

=== Search engines ===

=== Search engines ===

Line 37:

Line 37:

The first entry in {{ic|$XDG_CONFIG_HOME/dwb/searchengines}} will be the default search engine.

The first entry in {{ic|$XDG_CONFIG_HOME/dwb/searchengines}} will be the default search engine.

−

== Extensions ==

+

=== Custom keybinds ===

−

dwb features an extension manager as a separate executable, ''dwbem''.

+

You can create custom key bindings by editing file {{ic|custom_keys}} in the profile directory. This is

−

You can use it to install various extension. For example

+

{{ic|~/.config/dwb/default}} by default. All keysyms which don't emit (multi)byte characters, must be enclosed in {{ic|@}}. One keybind can execute multiple dwb commands. These commands execute in same order as they are defined in bind, and must be separated by {{ic|;;}} separator. If the keybind's chord is already bound by dwb, it might be ignored (behaviour is not consistent). In such case one can try to check, whether there is collison with binds defined in {{ic|~/.config/dwb/keys}} and try to unbind the chord there (eg set it to nothing). Any running dwb instance will owerwrite {{ic|keys}} file on exit, so remember to do your modifications while dwb is not runing or use default dwb interface (''S k'').

−

$ dwbem -i youtube_html5

+

{{hc|~/.config/dwb/default/custom_keys|<nowiki>

+

Control w :close_tab

+

Control @Page_Up@ :focus_prev

+

Control @Page_Down@ :focus_next

+

</nowiki>}}

−

will make dwb play all Youtube videos using an HTML5 player instead of the Flash player.

+

== Extensions ==

−

Use

+

dwb features an extension manager as a separate executable, ''dwbem''. To list all officially available extensions, use:

$ dwbem -a

$ dwbem -a

−

to list all officially available extensions.

+

Read the [[man page]] for more details.

−

−

Read the man page for more details.

−

−

$ man dwbem

=== Adblock ===

=== Adblock ===

Line 64:

Line 64:

Restart dwb, use the ''adblock_subscribe'' command and choose your favorite lists of filters.

Restart dwb, use the ''adblock_subscribe'' command and choose your favorite lists of filters.

−

== Usage Tips ==

+

== Userscripts ==

+

dwb can execute .js or .sh scripts put in {{ic|~/.config/dwb/userscripts/}}. Make sure they are executable:

+

chmod +x ~/.config/dwb/userscripts/myscript.js

+

+

Below are some example scripts:

+

===startup-noautoreload===

+

Prevents previously-opened tabs from reloading all at once after a restart.

+

{{hc|~/.config/dwb/userscripts/startup-noautoreload.js|<nowiki>

+

//!javascript

+

// prevents previously-opened tabs from reloading all at once after a restart.

You can create custom key bindings by editing file {{ic|custom_keys}} in the profile directory. This is

+

signals.connect("navigation", function (wv, frame, request) {

−

{{ic|~/.config/dwb/default}} by default. All keysyms which don't emit (multi)byte characters, must be enclosed in {{ic|@}}. One keybind can execute multiple dwb commands. These commands execute in same order as they are defined in bind, and must be separated by {{ic|;;}} separator. If the keybind's chord is already bound by dwb, it might be ignored (behaviour is not consistent). In such case one can try to check, whether there is collison with binds defined in {{ic|~/.config/dwb/keys}} and try to unbind the chord there (eg set it to nothing). Any running dwb instance will owerwrite {{ic|keys}} file on exit, so remember to do your modifications while dwb is not runing or use default dwb interface (''S k'').

If you are always searching for ''undefined'' even with the {{ic|searchengine-submit-pattern}} option set, then you should edit {{ic|$XDG_CONFIG_HOME/dwb/searchengines}} and adapt the URIs to match your {{ic|searchengine-submit-pattern}}.

If you are always searching for ''undefined'' even with the {{ic|searchengine-submit-pattern}} option set, then you should edit {{ic|$XDG_CONFIG_HOME/dwb/searchengines}} and adapt the URIs to match your {{ic|searchengine-submit-pattern}}.

+

+

=== Fuzzy font in Github ===

+

+

Add this in your ~/.config/fontconfig/fonts.conf inside the fontconfig-tags:

Search engines

Now you can use the keyword in the URI prompt to search directly on the corresponding website.

The first entry in $XDG_CONFIG_HOME/dwb/searchengines will be the default search engine.

Custom keybinds

You can create custom key bindings by editing file custom_keys in the profile directory. This is
~/.config/dwb/default by default. All keysyms which don't emit (multi)byte characters, must be enclosed in @. One keybind can execute multiple dwb commands. These commands execute in same order as they are defined in bind, and must be separated by ;; separator. If the keybind's chord is already bound by dwb, it might be ignored (behaviour is not consistent). In such case one can try to check, whether there is collison with binds defined in ~/.config/dwb/keys and try to unbind the chord there (eg set it to nothing). Any running dwb instance will owerwrite keys file on exit, so remember to do your modifications while dwb is not runing or use default dwb interface (S k).

~/.config/dwb/default/custom_keys

Control w :close_tab
Control @Page_Up@ :focus_prev
Control @Page_Down@ :focus_next

Extensions

dwb features an extension manager as a separate executable, dwbem. To list all officially available extensions, use:

Search engines always search for undefined

If you are always searching for undefined even with the searchengine-submit-pattern option set, then you should edit $XDG_CONFIG_HOME/dwb/searchengines and adapt the URIs to match your searchengine-submit-pattern.

Fuzzy font in Github

Add this in your ~/.config/fontconfig/fonts.conf inside the fontconfig-tags: