Provided by: dwb_20150419git-2build1_i386 
NAME
dwb - dynamic web browser
SYNOPSIS
dwb [OPTIONS] [ URLS ]
DESCRIPTION
dwb(1) is a small webbrowser based on WebKit and GTK which aims to be
mostly keyboard-driven.
OPTIONS
-c, --check-script-syntax=script
Checks if a the syntax of a script that uses the javascript api is
correct.
-d, --delete-profile=profile
Deletes a profile.
-e, --embed=wid
Embed dwb into <wid>.
-f, --force
Force restoring a previously saved session, even if it seems that
another process has opened a session with the same name.
--fifo
Use a fifo for single instance instead of dbus, all instances must
pass this option to use the fifo.
-l, --list-sessions
List previously saved sessions. A * indicates that another instance
has currently opened the session.
-n, --new-instance
New instance, overrides setting single-instance.
-p, --profile=profilename
Load configuration for profile profilename.
-r, --restore=sessionname
Restore session with name sessionname or the default session, if
sessionname is omitted.
-R, --override-restore
Open a new session, even if save-session is enabled.
-S, --enable-scripts
Enables the javascript interface, if there are scripts in
$XDG_CONFIG_HOME/dwb/userscripts that use the javascript api this
option is not needed.
--set-as-default
Sets dwb as default browser, if called with no arguments it will be
set for all mimetypes listed in dwb.desktop, if the first argument
is mimetype it will be set for all succeding mimetypes, e.g. dwb
--set-as-default "mimetype text/html" if the first argument is
extension it will be set for all succeeding filename extensions,
e.g. dwb --set-as-default "extension html htm".
-t, --temp-profile
Create a temporary profile, will be deleted when dwb is closed
-x, --execute=commands
Execute a list of dwb commands separated by ;;, see CUSTOM COMMANDS
and COMMAND OVERVIEW for details. If single instance is enabled all
commands will be executed in the primary instance.
-v, --version
Show version information and exit.
-V, --version-full
Show full version information, including library versions, and
exit.
MODES
dwb has different modes:
Normal mode
The default mode. Pressing Escape always enter normal mode, all
keyboard inputs will be interpreted as shortcuts, keypresses are
not sent to the webview.
Insert mode
Used for editing text elements in a webpage.
Hint mode
Follow links via hints.
Command mode
Execute dwb commands from the builtin commandline.
SHORTCUTS
Normal mode shortcuts
[n]j
Scroll [n times] down (command: scroll_down, aliases: down).
[n]k
Scroll [n times] up (command: scroll_up, aliases: up).
[n]h
Scroll [n times] left (command: scroll_left, aliases: left).
[n]l
Scroll [n times] right (command: scroll_right, aliases: right).
[n]gg
Scroll to the top or to n% of the page (command: scroll_top,
aliases: top).
[n]G
Scroll to the bottom or to n% of the page (command: scroll_bottom,
aliases: bottom).
[n]C-f
Scroll [n] pages down (command: scroll_page_down, aliases:
pagedown).
[n]C-b
Scroll [n] pages up (command: scroll_page_up, aliases: pageup).
[n]C-d
Scroll [n] half pages down (command: scroll_halfpage_down, aliases:
halfdown).
[n]C-u
Scroll [n] half pages up (command: scroll_halfpage_up, aliases:
halfup).
:
Enter Command mode.
.
Repeat last command line command.
o
Open new url in the focused tab, the argument $URI will be replaced
by the current uri (command: open, aliases: o).
go
Open url in the focused tab, set current url in the navigation bar
(command: open_url).
O
Open url in a new tab, the argument $URI will be replaced by the
current uri (command: tabopen, aliases: topen, t).
gO
Open url in a new tab, set current url in the navigation bar
(command tabopen_url).
xo
Open url in a new tab in background, the argument $URI will be
repaced with the current uri (command: backopen, aliases: bopen ).
xO
Open url in a new tab in background, set current url in the
navigation bar (command: backopen_url).
wo
Open url in a new instance (command: winopen, aliases: wopen, w).
i
Enter insert mode (command: insert_mode, aliases: i, insert).
C-n
Enter normal mode.
ga
Add a new blank tab (command: tab_new).
d
Close current tab (command: close_tab, aliases: close).
[n]gc
Clear tab n or of current tab, clears the history of the tab and
loads about:blank. (command clear_tab, aliases: clear).
co
Close all tabs except for the current one (command only).
C-q
Quit (command quit, aliases: q).
u
Undo closing last tab (command undo, aliases: u).
C-h
Open the default startpage (command start_page, aliases: home).
H
Go back (command history_back, aliases: back, ba).
L
Go forward (command history_forward, aliases: forward, fo).
th
Go back in a new tab (command tab_hist_back, aliases: tabback,
tba).
tl
Go forward in a new tab (command tab_hist_forward, aliases:
tabforward, tfo).
wh
Go back in a new window (command win_hist_back, aliases: winback,
wba).
wl
Go forward in a new window (command win_hist_forward, aliases:
winforward, wfo).
/
Find forward (command find_forward, alias: ffind).
?
Find backward (command find_backward, alias bfind).
c/
Find forward, case sensitive (command find_forward_ic, alias:
iffind).
c?
Find backward, case sensitive (command find_backward_ic, alias
ibfind).
M
Add a bookmark (command bookmark, aliases: bmark, bma).
gb
Show Bookmarks (command bookmarks, aliases: bmarks, bmas).
gB
Show Bookmarks, open bookmark in a new tab (command tab_bookmarks,
aliases: tabmarks).
wB
Show Bookmarks, open bookmark in a new window (command
win_bookmarks, aliases: winmarks).
m
Add a quickmark (command save_quickmark, aliases: quickmark,
qmark).
b
Open quickmark (command quickmark, aliases: qmarks).
B
Open quickmark in a new tab (command tab_quickmark, aliases:
tabqmarks).
wb[:graph:]
Open quickmark in a new window (command win_quickmark, aliases:
winqmarks).
[n]r
Reload tab n or current tab if n is omitted (command reload,
aliases: re).
[n]R
Reload tab n or current tab if n is omitted without using any
cached data (command reload_bypass_cache, aliases: refull).
[n]C-s
Stop loading of tab n or of current tab is [n] is omitted (command
stop_loading, aliases: stop, st).
[n]+
Zoom in [n times] (command zoom_in, aliases: zi).
[n]-
Zoom out [n times] (command zoom_out, aliases: zo).
[n]=
Zoom to n percent or to 100% if n is omitted(command zoom, aliases:
z).
sf
Save all configuration files (command save).
ZZ
Save current session and exit (command save_session, aliases: wq).
gZZ
Save current session with name and exit (command
save_named_session, aliases: wqn).
[n]J
Cycle focus [n tab] forwards. (command focus_next, aliases:
tabnext).
[n]K
Cycle focus [n tab] backwards. (command focus_prev, aliases:
tabprev).
[n]T
Focus nth tab, first tab if n is omitted or last tab if n is 0.
(command focus_tab, aliases: tab).
C-Tab
Toggle between current and last focused tab (command toggle_tab,
aliases: ttab)
[n]gm
Move current tab to position [n] or to first position if n is
omitted. (command tab_move, aliases: tabm).
[n]gl
Move current tab [n] positions left. (command tab_move_left,
aliases: tabl).
[n]gr
Move current tab [n] positions right. (command tab_move_right,
aliases: tabr).
gt
Show all open tabs. (command buffers, aliases: bu, ls).
[n]C-P
Protect tab [n]. Closing this tab must be confirmed (command
protect, aliases: prot).
[n]xd
Lock tab [n]. Locking a tab will lock this tab to the current
domain, it’s not possible to navigate to another domain until
unlocked. lock_domain, aliases: dlock).
[n]xu
Lock tab [n]. Locking a tab will lock this tab to the current uri,
it’s not possible to navigate to another uri until unlocked.
lock_uri, aliases: ulock).
f
Show hints (command hints, aliases: hints, hi).
F
Show hints, open link in a new foreground tab. (command hints_tab,
aliases: tabhints, thi).
;b
Show hints, open link in a new background tab. (command
hints_background, aliases: backhints, bhi).
wf
Show hints, open link in a new window. (command hints_win, aliases:
winhints, whi).
;i
Follow image (command hints_images, aliases: ihints, ihi).
;It
Follow image in a new tab (command hints_images_tab, aliases:
itabhints, ithi).
.Ib
Follow image in a background tab (command hints_images_background,
aliases: ibackhints).
;e
Focus editable elements via hints (command hints_editable, aliases:
ehints, ehi).
;o
Set hint’s url in commandline (command hints_url, aliases: uhints,
uhi).
;Ot
Set hint’s url in commandline, open in a new tab (command
hints_url_tab, aliases: utabhints, uthi).
.Ob
Set hint’s url in commandline, open in a background tab (command
hints_url_background, aliases: ubackhints).
;d
Download via hints (command hints_download, aliases: dhints).
;y
Save link location to clipboard (command hints_clipboard, aliases:
chints, chi).
;Y
Save link location to primary selection (command hints_primary,
aliases: phints, phi).
;r
Rapid hint mode, each matching hint opens a new tab in background.
(command hints_rapid, aliases: rhints, rhi).
;R
Rapid hint mode, each matching hint opens a new window. (command
hints_rapid_win, aliases: wrhints, wrhi).
gf
Toggle "view source" (command view_source, aliases: source, so).
`[mark]
Mark current position in document, valid marks are all printable
ascii characters.
'[mark]
Jump to marked position mark. The default mark is ' that points to
the last position when using scroll_top, scroll_bottom, jump, any
of the find commands or if an anchor link was clicked.
CC
Allow persistent cookie for the current website. The domain will be
saved in cookies.allow. Cookies that are allowed by the
cookies.allow whitelist are stored in
$XDG_CONFIG_HOME/dwb/$profilename/cookies. (command allow_cookie,
aliases: cookie).
CS
Allow session cookie for the current website. The domain will be
saved in cookies_session.allow. This is only useful if
cookies-store-policy is set to never, see cookies-store-policy for
details. (command allow_session_cookie, aliases: scookie).
CT
Allow session cookies for the current website temporarily. Only
first party cookies are allowed. The domain is not saved to a
whitelist and the cookies will not be saved persitently. (command
allow_session_cookie_tmp, aliases: tcookie).
[n]yy
Yank the url of tab n or of current tab if n is omitted to
clipboard (command yank).
yY
Yank the url of tab n or of current tab if n is omitted to primary
selection (command yank_primary, aliases: pyank).
yt
Yank the title of tab n or of current tab if n is omitted to
clipboard (command yank_title, aliases: tyank).
yT
Yank the title of tab n or of current tab if n is omitted to
primary selection (command yank_title_primary, aliases: tpyank).
pp
Paste from clipboard (command paste).
pP
Paste from primary selection (command paste_primary, aliases:
ppaste).
Pp
Paste from clipboard and load in a new tab (command tab_paste,
aliases: tpaste).
PP
Paste from primary selection and load in a new tab (command
tab_paste_primary, aliases: tppaste).
wp
Paste from clipboard and load in a new window (command paste_nw,
aliases: winpaste).
wP
Paste from primary selection and load in a new window (command
paste_primary_nw, aliases: winppaste).
[n]ad
Cancel the download with number n or the first download in the
lists of running downloads if n is omitted. (command
cancel_download).
gs
Add a searchengine. Textfields can be chosen with tab and a keyword
must be specified. The first defined searchengine will be the
default searchengine. The keyword can be used in all open commands,
e.g. :open <keyword> <searchterm> (command save_search_field,
aliases: search).
gd
Download the current site. (command download).
Sb
Show bookmarks (command show_bookmarks, aliases: sbookmarks).
Sq
Show quickmarks (command show_quickmarks, aliases: squickmarks).
Sh
Show history (command show_history, aliases: shistory).
Sd
Show download (command show_downloads, aliases: sdownloads).
Sk
Show keys (command show_keys, aliases: skeys).
Ss
Show settings (command show_settings, aliases: ssettings).
ss
Set setting, the interactive version of the command set, for
changing settings in scripts use set instead (command set_setting).
sl
Set local setting, changes a setting but doesn’t save the setting
to configuration file. The interactive version of the command
local_set, for changing settings locally in scripts use local_set
instead (command set_local_setting).
sk
Set keyboard shortcut (command set_key, aliases: keys).
C-p
Toggle proxy (command proxy).
tsh
Toggle scripts for current host permanently (command
toggle_scripts_host, aliases: hscript).
tsu
Toggle scripts for current url permanently (command
toggle_scripts_uri, aliases: uscript).
tth
Toggle scripts for current host temporarily (command
toggle_scripts_host_tmp, aliases: thscript).
ttu
Toggle scripts for current url temporarily (command
toggle_scripts_uri_tmp, aliases: tuscript).
ph
Toggle plugins for current host permanently (command
toggle_plugins_host, aliases: hplugin).
pu
Toggle plugins for current url permanently (command
toggle_plugins_uri, aliases: uplugin).
pth
Toggle plugins for current host temporarily (command
toggle_plugins_host_tmp, aliases: thplugin).
ptu
Toggle plugins for current url temporarily (command
toggle_plugins_uri_tmp, aliases: tuplugin).
V
Next navigation action will be opened in a new tab (command
new_tab).
W
Next navigation action will be opened in a new window (command
new_win).
eu
Show and execute userscripts (command execute_userscript).
[n]wi
Show the webinspector of tab n or of current tab if n is omitted.
Note that enable-developer-extras has to be set. (commmand
web_inspector, aliases: inspect, insp).
C-e
Open external editor for current input/textarea (command
open_editor, aliases: editor).
g.
Toggle hidden files when browsing local filesystem. (command
toggle_hidden_files, aliases: hidden).
F11
Toggle fullscreen (command fullscreen, aliases: fs).
F12
Toggle presentation mode. (command presentation_mode, aliases:
present).
xx
Toggle visibility of tabbar and statusbar. (command toggle_bars,
aliases: bars).
xt
Toggle visibility of tabbar. (command toggle_tabbar, aliases:
tbar).
xb
Toggle visibility of statusbar. (command toggle_statusbar, aliases:
sbar).
xv
Toggle visibility of a tab. (command visible, aliases: vis).
[n]C-M-p
Print focused frame of tab n or of current tab if n is omitted.
(command print, aliases: ha).
unbound
Execute a javascript snippet (command execute_javascript, aliases:
exja, js).
unbound
Set a setting from commandline (command set).
unbound
Toggle a boolean setting from commandline (command toggle_setting,
aliases: toggle, tog).
unbound
Load a html string. This command is mainly intended for use in
userscripts (command load_html).
unbound
Load a html string in a new tab. This command is mainly intended
for use in userscripts (command load_html_tab).
unbound
Execute a javascript snippet that uses the the internal javascript
api. This command only works if the javascript interface is
enabled, i.e. if there are scripts in
$XDG_CONFIG_HOME/dwb/userscripts that use the api or if dwb is
started with -S/--enable-scripts (command eval).
Tab (S-Tab)
In normal mode Tab shows the next (previous) shortcut, that matches
the currently entered keysequence. When opening a url, the next
(previous) item in command history, bookmarks or history will be
completed. In hint mode the next (previous) hint will get focus.
Tab also completes settings and shortcut-settings. When initiating
a download, full paths (downloads and spawning programs) and
binaries (spawning programs) in PATH will be completed. In command
mode tab will complete builtin commands and urls if the command
accepts an url.
Textentry shortcuts
C-h
Delete a single letter.
C-w
Delete word back.
C-e
Delete word forward.
C-u
Delete to the beginning of the entry.
C-i
Delete to the end of the entry.
C-f
Move cursor one word forward.
C-b
Move cursor one word back.
C-j
Show next item in command history.
C-k
Show previous item in command history.
C-d
When completing delete the currently selected bookmark or history
item.
C-x
When initalizing a download, C-x toggles between choosing a file
path and choosing a spawning application.
C-g
Alternative shortcut for activate.
C-c
Alternative shortcut for escape, the corresponding setting is
entry_escape.
C-p
Init local path completion.
C-H
Init history completion.
C-B
Init bookmark completion.
C-I
Init input history completion.
C-S
Init searchengine completion.
C-U
Init userscript completion.
C-p
Complete local path.
Shortcut syntax
All printable shortcuts are case sensitive, i.e. aH means press a then
press shift, then press h. Shortcuts can be combined with a modifier,
valid modifiers are Control, Mod1, Mod4 and Shift where Shift can only
be used with non printable keys such as F1, space, Tab, ... . Non
printable keys must be surrounded by @, e.g. "Control @F1@", Shift
@space@. \ and @ itself must be escaped with \.
CUSTOM COMMANDS
Custom commands are a sequence of dwb commands that can be bound to a
shortcut. The syntax is
<shortcut>:<command>;;<command>;;...
where shortcut is the shortcut for the commandsequence, : may be
escaped with \: and command is of the form
[numerical modifier]<command or alias> [argument for the command]
for example
Control W:tabopen http://example.com;; 150zoom
opens http://example.com in a new tab and zooms to 150%.
COMMAND OVERVIEW
┌───────────────────────────┬────────────────────────────┐
│Command │ Description │
├───────────────────────────┼────────────────────────────┤
│ │ │
│adblock_reload_rules │ Reload adblocker rules │
├───────────────────────────┼────────────────────────────┤
│ │ │
│allow_cookie, cookie │ Allow persistent cookies │
│ │ for current site │
├───────────────────────────┼────────────────────────────┤
│ │ │
│allow_session_cookie, │ Allow session cookies for │
│scookie │ currrent site │
├───────────────────────────┼────────────────────────────┤
│ │ │
│allow_session_cookie_tmp, │ Allow session cookies for │
│tcookie │ current site temporarily │
├───────────────────────────┼────────────────────────────┤
│ │ │
│bookmark, bma, bmark │ Bookmark current page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│bookmarks, bmas, bmarks │ Show bookmarks │
├───────────────────────────┼────────────────────────────┤
│ │ │
│buffers, bu, ls │ Show all open tabs │
├───────────────────────────┼────────────────────────────┤
│ │ │
│cancel_download │ Cancel a download │
├───────────────────────────┼────────────────────────────┤
│ │ │
│clear_tab, clear │ Clear tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│close_tab, close │ Close tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│download │ Download current site │
├───────────────────────────┼────────────────────────────┤
│ │ │
│dump │ Write html of current │
│ │ website to a file or │
│ │ stdout if no argument is │
│ │ given │
├───────────────────────────┼────────────────────────────┤
│ │ │
│eval │ Execute a javascript │
│ │ snippet that uses the │
│ │ internal javascript api │
├───────────────────────────┼────────────────────────────┤
│ │ │
│execute_javascript, exja, │ Execute a javascript │
│js │ snippet │
├───────────────────────────┼────────────────────────────┤
│ │ │
│execute_userscript │ Execute userscript │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_backward, bfind │ Find backward │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_backward_ic, ibfind │ Find backward case │
│ │ sensitive │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_forward, ffind │ Find forward │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_forward_ic, iffind │ Find forward case │
│ │ sensitive │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_next, fnext │ Find next │
├───────────────────────────┼────────────────────────────┤
│ │ │
│find_previous, fprev │ Find previous │
├───────────────────────────┼────────────────────────────┤
│ │ │
│focus_input │ Focus next input │
├───────────────────────────┼────────────────────────────┤
│ │ │
│focus_next, tabnext │ Focus next tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│focus_prev, tabprev │ Focus previous tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│focus_tab, tab │ Focus nth tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│fullscreen, fs │ Toggle fullscreen │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints, hi │ Follow hints │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_background, │ Follow hints in a │
│backhints, bhi │ background tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_clipboard, chints, │ Save link location to │
│chi │ clipboard │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_download, dhints, │ Download via hints │
│dhi │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_editable, ehints, │ Focus editable elements │
│ehi │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_images, ihints, ihi │ Follow images │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_images_tab, │ Follow images in a new tab │
│itabhints, ithi │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_images_background, │ Follow images in a │
│ibackhints │ background tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_links, lhints, lhi │ Follow links │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_primary, phints, phi │ Save link location to │
│ │ primary selection │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_rapid, rhints, rhi │ Open new tabs in │
│ │ background rapidly │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_rapid_win, wrhints, │ Open new windows rapidly │
│wrhi │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_selector │ Show hints using a custom │
│ │ css selector │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_tab, tabhints, thi │ Follow hints in a new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_url, uhints, uhi │ Set hints url in │
│ │ commandline │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_url_tab, utabhints, │ Set hints url in │
│uthi │ commandline, open in a new │
│ │ tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_url_background, │ Set hints url in │
│ubackhints │ commandline, open in a │
│ │ background tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│hints_win, winhints, whi │ Follow hints in a new │
│ │ window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│history_back, ba, back │ Go back │
├───────────────────────────┼────────────────────────────┤
│ │ │
│history_forward, fo, │ Go forward │
│forward │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│insert_mode, i, insert │ Insert mode │
├───────────────────────────┼────────────────────────────┤
│ │ │
│jump │ Jump to marked position │
├───────────────────────────┼────────────────────────────┤
│ │ │
│local_set │ Set a setting only for the │
│ │ running instance, don’t │
│ │ save it to the │
│ │ configuration file │
├───────────────────────────┼────────────────────────────┤
│ │ │
│lock_domain, dlock │ Lock tab to current domain │
├───────────────────────────┼────────────────────────────┤
│ │ │
│lock_uri, ulock │ Lock tab to current uri │
├───────────────────────────┼────────────────────────────┤
│ │ │
│mark │ Mark current position in │
│ │ document │
├───────────────────────────┼────────────────────────────┤
│ │ │
│new_tab │ Open next navigation │
│ │ action in new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│new_win │ Open next navigation │
│ │ action in new window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│only │ Close all tabs except for │
│ │ the current one │
├───────────────────────────┼────────────────────────────┤
│ │ │
│open, o │ Open url │
├───────────────────────────┼────────────────────────────┤
│ │ │
│open_editor, editor │ Open external editor for │
│ │ input/textarea │
├───────────────────────────┼────────────────────────────┤
│ │ │
│open_url │ Open, edit current url │
├───────────────────────────┼────────────────────────────┤
│ │ │
│paste │ Open from clipboard │
├───────────────────────────┼────────────────────────────┤
│ │ │
│paste_primary, ppaste │ Open from primary │
│ │ selection │
├───────────────────────────┼────────────────────────────┤
│ │ │
│presentation_mode, present │ Toggle presentation mode │
├───────────────────────────┼────────────────────────────┤
│ │ │
│print, ha │ Print page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│print_preview │ Show a print preview │
├───────────────────────────┼────────────────────────────┤
│ │ │
│protect, prot │ Protect/unprotect tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│proxy │ Toggle proxy │
├───────────────────────────┼────────────────────────────┤
│ │ │
│quickmark, qmarks │ Open quickmark │
├───────────────────────────┼────────────────────────────┤
│ │ │
│quit, q │ Quit │
├───────────────────────────┼────────────────────────────┤
│ │ │
│reload, re │ Reload current page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│reload_bookmarks │ Reload bookmark file │
├───────────────────────────┼────────────────────────────┤
│ │ │
│reload_bypass_cache, │ Reload without using │
│refull │ cached data │
├───────────────────────────┼────────────────────────────┤
│ │ │
│reload_quickmarks │ Reload quickmark file │
├───────────────────────────┼────────────────────────────┤
│ │ │
│reload_userscripts │ Reload userscripts │
├───────────────────────────┼────────────────────────────┤
│ │ │
│save │ Save all configuration │
│ │ files │
├───────────────────────────┼────────────────────────────┤
│ │ │
│save_named_session, wqn │ Save current session with │
│ │ name │
├───────────────────────────┼────────────────────────────┤
│ │ │
│save_quickmark, qmark, │ Save a quickmark │
│quickmark │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│save_search_field, search │ Add a new searchengine │
├───────────────────────────┼────────────────────────────┤
│ │ │
│save_session, wq │ Save current session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_bottom, bottom │ Scroll to bottom of the │
│ │ page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_down, down │ Scroll down │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_halfpage_down, │ Scroll one-half page down │
│halfdown │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_halfpage_up, halfup │ Scroll one-half page up │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_left, left │ Scroll left │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_page_down, pagedown │ Scroll one page down │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_page_up, pageup │ Scroll one page up │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_right, right │ Scroll right │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_top, top │ Scroll to the top of the │
│ │ page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│scroll_up, up │ Scroll up │
├───────────────────────────┼────────────────────────────┤
│ │ │
│sanitize │ Clears history and │
│ │ cookies, sanitize history │
│ │ only clears history │
│ │ sanitize cookies only │
│ │ clears cookies │
├───────────────────────────┼────────────────────────────┤
│ │ │
│set │ Set a setting │
├───────────────────────────┼────────────────────────────┤
│ │ │
│set_key, keys │ Set keybinding │
├───────────────────────────┼────────────────────────────┤
│ │ │
│set_local_setting │ Set a setting for the │
│ │ running instance │
│ │ interactively │
├───────────────────────────┼────────────────────────────┤
│ │ │
│set_setting │ Set a setting interactive │
├───────────────────────────┼────────────────────────────┤
│ │ │
│show_keys, skeys │ Show and modify keyboard │
│ │ configuration │
├───────────────────────────┼────────────────────────────┤
│ │ │
│show_settings, ssettings │ Show and modify global │
│ │ properties │
├───────────────────────────┼────────────────────────────┤
│ │ │
│start_page, home │ Open the default homepage │
├───────────────────────────┼────────────────────────────┤
│ │ │
│stop_loading, st, stop │ Stop loading current page │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_bookmarks, tabmarks │ Show bookmarks, open in │
│ │ new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tabdo │ Execute a command in all │
│ │ tabs │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tabgrep │ Focus a tab by pattern or │
│ │ regular expression, │
│ │ regular expressions must │
│ │ start with / │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_hist_back, tba, │ Go back in a new tab │
│tabback │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_hist_forward, tfo, │ Go forward in a new tab │
│tabforward │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_move, tabm │ Move tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_move_left, tabl │ Move tab left │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_move_right, tabr │ Move tab right │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_new │ Open a new blank tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_paste, tpaste │ Open from clipboard in a │
│ │ new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_paste_primary, tppaste │ Open from primary │
│ │ selection in a new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tab_quickmark, tabqmarks │ Open quickmark in a new │
│ │ tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tabopen, t, topen │ Open in a new tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│tabopen_url │ Open in a new tab, edit │
│ │ current url │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_bars, bars │ Toggle tabbar and │
│ │ statusbar │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_hidden_files, │ Toggle hidden files in │
│hidden │ directory listings │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_plugins_host, │ Toggle plugin blocker for │
│hplugin │ host │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_plugins_host_tmp, │ Toggle plugin blocker for │
│tuplugin │ domain for this session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_plugins_uri, │ Toggle plugin blocker for │
│uplugin │ uri │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_plugins_uri_tmp, │ Toggle plugin blocker for │
│tuplugin │ uri for this session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_scripts_host, │ Toggle scripts for current │
│hscript │ domain │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_scripts_host_tmp, │ Toggle scripts for current │
│thscript │ host for this session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_scripts_uri, │ Toggle scripts for current │
│uscript │ uri │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_scripts_uri_tmp, │ Toggle scripts for current │
│tuscript │ uri for this session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_setting, tog, │ Toggle a setting │
│toggle │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_local_setting, │ Toggle a setting for the │
│loctog │ current session │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_statusbar, sbar │ Toggle statusbar │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_tab, ttab │ Toggle between current and │
│ │ last tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│toggle_tabbar, tbar │ Toggle tabbar │
├───────────────────────────┼────────────────────────────┤
│ │ │
│undo, u │ Undo closing last tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│view_source, so, source │ View page source │
├───────────────────────────┼────────────────────────────┤
│ │ │
│visible, vis │ Toggle visibility of a tab │
├───────────────────────────┼────────────────────────────┤
│ │ │
│web_inspector, insp, │ Open the webinspector │
│inspect │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_bookmarks, winmarks │ Show bookmarks, open in │
│ │ new window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_hist_back, wba, │ Go back in a new window │
│winback │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_hist_forward, wfo, │ Go forward in a new window │
│winforward │ │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_paste, wpaste │ Open from clipboard in a │
│ │ new window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_paste_primary, wppaste │ Open primary selection in │
│ │ a new window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│win_quickmark, winqmarks │ Open quickmark in a new │
│ │ window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│winopen, w, wopen │ Open in a new window │
├───────────────────────────┼────────────────────────────┤
│ │ │
│winopen_url │ Open in a new window, edit │
│ │ current url │
├───────────────────────────┼────────────────────────────┤
│ │ │
│yank │ Yank url to clipboard │
├───────────────────────────┼────────────────────────────┤
│ │ │
│yank_primary, pyank │ Yank url to primary │
│ │ selection │
├───────────────────────────┼────────────────────────────┤
│ │ │
│yank_title, tyank │ Yank title to clipboard │
├───────────────────────────┼────────────────────────────┤
│ │ │
│yank_title_primary, tpyank │ Yank title to primary │
│ │ selection │
├───────────────────────────┼────────────────────────────┤
│ │ │
│zoom, z │ Zoom │
├───────────────────────────┼────────────────────────────┤
│ │ │
│zoom_in, zi │ Zoom in │
├───────────────────────────┼────────────────────────────┤
│ │ │
│zoom_out, zo │ Zoom out │
└───────────────────────────┴────────────────────────────┘
dwb can be customized in a web interface (command show_settings) or via
command line (command set_setting). Modified settings will be saved in
~/.config/dwb/settings when closing dwb. Shortcuts can also be modified
in a web interface (command show_keys) or via command line (command
set_key). Shortcuts will be saved in $HOME/.config/dwb/keys.
If a string value is set to NULL the default value will be used.
WebKit builtin settings
auto-load-images
Load images automatically. Possible values: true/false, default
value: true.
auto-resize-window
Resize window through DOM-methods. Possible values: true/false,
default value: false.
auto-shrink-images
Automatically shrink standalone images to fit. Possible values:
true/false, default value: true.
cursive-font-family
Default cursive font family used to display text. Possible values:
a font description or NULL, default value: NULL.
custom-encoding
A custom encoding used for the webview. Possible values: encoding
string or NULL, default value: NULL.
default-encoding
The default encoding used to display text. Possible values:
encoding string or NULL, default value: NULL.
default-font-family
The default font family used to display text. Possible values: a
font description or NULL, default value: sans-serif.
default-font-size
The default font size used to display text. Possible values: a font
size (integer), default value: 12.
default-monospace-font-size
The default font size used to display monospace text. Possible
values: a font size (integer), default value: 10.
editable
Whether the content of a webpage should be editable. Possible
values: true/false, default value: false.
enable-caret-browsing
Whether to enable caret browsing. Possible values: true/false,
default value: false.
enable-default-context-menu
Whether right-clicks open a context menu. Possible values:
true/false, default value: false.
enable-dns-prefetching
Whether webkit prefetches domain names. default value: true.
enable-developer-extras
Whether the web-inspector should be enabled. Possible values:
true/false, default value: false.
enable-dom-paste
Whether enable DOM-paste. Possible values: true/false, default
value: false.
enable-frame-flattening
Whether to enable the Frame Flattening. With this setting each
subframe is expanded to its contents, which will flatten all the
frames to become one scrollable page. Whether file uris can be
accessed. Possible values: true/false, default value: false.
enable-file-access-from-file-uris
Whether file uris can be accessed. Possible values: true/false,
default value: true.
enable-html5-database
Whether to enable HTML5 client-side SQL database support. Possible
values: true/false, default value: true.
enable-html5-local-storage
Whether to enable HTML5 localStorage support. Possible values:
true/false, default value: true.
enable-java-applet
Whether to enable Java <applet>-tag. Possible values: true/false,
default value: true.
enable-offline-web-application-cache
Enable or disable HTML5 offline web application cache support.
Possible values: true/false, default value: true.
enable-page-cache
Enable or disable page cache. Possible values: true/false, default
value: false.
enable-plugins
Enable or disable embedded plugins. Possible values: true/false,
default value: true.
enable-private-browsing
Enable or disable private browsing. Possible values: true/false,
default value: false.
enable-scripts
Enable or disable embedded scripting-languages. Possible values:
true/false, default value: true.
enable-site-specific-quirks
Enables the site-specific compatibility workarounds. Possible
values: true/false, default value: false.
enable-spatial-navigation
Whether to enable the Spatial Navigation. This feature consists in
the ability to navigate between focusable elements in a Web page,
such as hyperlinks and form controls, by using Left, Right, Up and
Down arrow keys. Possible values: true/false, default value: false.
enable-spell-checking
Whether to enable spell checking. Possible values: true/false,
default value: false.
enable-universal-access-from-file-uris
Whether to allow files loaded through file:// URIs universal access
to all pages. Possible values: true/false, default value: true.
enable-webgl
Whether to enable the webgl on pages. Possible values: true/false,
default value: false.
enable-xss-auditor
Whether to enable the XSS Auditor. This feature filters some kinds
of reflective XSS attacks on vulnerable web sites. Possible values:
true/false, default value: true.
enforce-96-dpi
Enforce a resolution of 96 DPI. Possible values: true/false,
default value: false.
fantasy-font-family
Default fantasy font family used to display text. Possible values:
a font description or NULL, default value: serif.
javascript-can-access-clipboard
Whether javascript can access Clipboard. Possible values:
true/false, default value: false.
full-content-zoom
Whether the full content is scaled when zooming. Possible values:
true/false, default value: false.
javascript-can-open-windows-automatically
Whether JavaScript can open popup windows automatically without
user intervention. Possible values: true/false, default value:
false.
minimum-font-size
The minimum font size used to display text. Possible values: a font
size (integer), default value: 5.
minimum-logical-font-size
The minimum logical font size used to display text. Possible
values: a font size (integer), default value: 5.
monospace-font-family
Default font family used to display monospace text. Possible
values: a font description or NULL, default value: monospace.
print-backgrounds
Whether background images should be printed. Possible values:
true/false, default value: true.
resizable-text-areas
Whether text areas are resizable. Possible values: true/false,
default value: true.
sans-serif-font-family
Default sans-serif font family used to display text. Possible
values: a font description or NULL, default value: sans-serif.
serif-font-family
Default serif font family used to display text. Possible values: a
font description or NULL, default value: serif.
spell-checking-languages
The languages to be used for spell checking, separated by commas.
Possible values: a string or NULL, default value: NULL.
tab-cycles-through-elements
Whether the tab key cycles through elements on the page. Possible
values: true/false, default value: true.
user-agent
The user-agent-string. Possible values: a user-agent or NULL,
default value: NULL.
user-stylesheet-uri
The URI of a stylesheet that is applied to every page. If a local
file is used, must start with file://. Possible values: an
uri-string or NULL, default value: NULL.
zoom-level
The zoom level of the content. Possible values: a decimal, default
value: 1.0.
zoom-step
The value by which the zoom level is changed when zooming in or
out. Possible values: a decimal, default value: 0.1.
Other settings
accept-language
If set it will be used to set Accept-Language header for all
requests, default value: NULL
active-completion-bg-color
The background color for an active element in tab-completion.
Possible values: an rgb color-string, default value: #000000.
active-completion-fg-color
The foreground color for an active element in tab-completion.
Possible values: an rgb color-string. default value: #53868b.
adblocker
Block advertisements using a filterlist, see also .IR
adblocker-filterlist . Default value: false.
adblocker-element-hider
Whether element hiding rules are enabled. Disabling element hiding
results in faster rendering. Default value: true.
adblocker-filterlist
A path to a adblock plus compatible filterlist for the adblocker or
a path to a directory with filterlists. Default value: NULL.
addressbar-dns-lookup
Whether to perform a dns lookup for text typed into the address
bar. If set to true dwb performs a dns lookup for all text that
does not have a valid scheme and does not contain whitespaces.
Default value: false.
auto-completion
Whether possible keystrokes should be shown. (Shift-) Tab cycles
through keystrokes. Possible values: true/false, default value:
true.
auto-insert-mode
Whether to go automatically in insert mode if an editable element
has focus after loading a site. Possible values: true/false,
default value: false.
background-color
The background color of the statusbar. Possible values: an rgb
color-string, default value: #000000.
background-tabs
Open new tabs in background. Possible values: true/false, default
value: false.
bars-padding
Padding of the status, download, completion and tab bars, default
value: 0.
block-insecure-content
Whether to block http-requests on https-encrypted sites, default
value: false.
cache-model
The cache model used by webkit, possible values are webbrowser and
documentviewer. Webbrowser increases loading speed but increases
memory usage, documentviewer reduces memory usage but also
decreases browsing speed. Default Value: webbrowser.
close-last-tab-policy
Behaviour when the last tab is closed, possible values are ignore,
clear and close; default value: ignore.
close-tab-focus-policy
Controls the focus when the focused tab is closed, possible values
are right, left, rightmost, and leftmost; default value: right.
complete-bookmarks
Whether to complete bookmarks with tab-completion. Possible values:
true/false, default value: true.
complete-history
Whether to complete browsing history with tab-completion. Possible
values: true/false, default value: true.
complete-searchengines
Whether to complete searchengines with tab-completion. Possible
values: true/false, default value: false.
complete-userscripts
Whether to complete userscripts with tab-completion. Possible
values: true/false, default value: false.
cookie-expiration
Maximum time in seconds after a persistent cookie expires, the
suffix m can be used for minutes, h for hours, and d for days, the
maximum will only be used if it is smaller than the original
expiration time. Setting cookie-expiration to 0 will use the
original expiration time of the cookie.
cookies-store-policy
The storage policy for cookies, possible values are session,
persistent, and never. If set to session all session cookies are
accepted, only cookies with a matching domain in cookies.allow will
be stored persistently. If set to persistent all cookies are stored
persistently. If set to never the cookies allowed by
cookies_session.allow are allowed for the current session and
cookies allowed by cookies.allow are save persistently, all other
cookies are rejected. Default value: session.
cookies-accept-policy
The accept policy for cookies. always will accept all cookies,
nothirdparty will accept all cookies except for third party
cookies, never will reject all cookies. This setting also affects
session cookies. default value: always.
default-width
The default width of dwb’s window. Possible values: width in pixel,
default value: 800.
default-height
The default height of dwb’s window. Possible values: height in
pixel, default value: 600.
do-not-track
Whether to add do-not-track flag on request headers, default value:
true.
download-fg-color
The foreground color of the download bar, default value: #ffffff.
download-bg-color
The background color of the download bar, default value: #000000.
download-gradient-start
The start color for the download progress gradient color, default
value #0000aa.
download-gradient-stop
The end color for the download progress gradient color, default
value #00aa00.
download-external-command
A command that will be invoked if download-use-external-program is
set. There are four variables that can be used in the command:
dwb_uri will be replaced with the download-uri, dwb_output will be
replaced with the fullpath of the destination, dwb_cookies will be
replaced with the path to the cookie-file, dwb_referer will be
replaced with the uri of the site the download started, dwb_proxy
will be replaced with the proxy url if dwb uses a proxy.
Additionally the environment-variables DWB_URI, DWB_FILENAME,
DWB_COOKIES, DWB_REFERER, DWB_MIME_TYPE, DWB_PROXY and
DWB_USER_AGENT are set. Default value: xterm -e wget dwb_uri -O
dwb_output --load-cookies dwb_cookies.
download-directory
The default download directory, if empty, the current working
directory is used or the last download path is used. default value:
NULL.
download-no-confirm
Whether to start downloads immediately without asking for a path,
download-directory needs to be set to an existing path. default
value: false.
download-use-external-program
Whether to use an external download program specified in
download-external-programm or the builtin download helper. Possible
values: true/false, default value: false.
editor
External editor used for inputs/textareas. default value: xterm -e
vim dwb_uri.
enable-favicon
Whether to show a favicon in the tab. default value: true.
enable-ipc
Whether to enable inter process communication with dwbremote(1),
default value: true. default value: true.
error-color
The color for error-messages. Possible values: an rgb color-string,
default value: #ff0000.
error-color
The color for prompt-messages. Possible values: an rgb
color-string, default value: #00ff00.
favicon-size
The size of the favicon, if set to 0 tabbar-height will be used
file-sync-interval
Interval in seconds to save history, cookies or session to hdd or 0
to immediately save, see also sync-files, default value: 120.
font
The font used for the ui. Possible values: a font description
string, default value: monospace 8.
font-completion
The font used for tabcompletion. Possible values: a font
description string.
font-entry
The font used for the address bar. Possible values: a font
description string.
font-hidden-statusbar
The font used for status elements if the statusbar is hidden.
Possible values: a css font description. Default value: normal 10px
helvetica.
font-nofocus
The font used for tablabels without focus and completion items
without focus. Possible values: a font description string.
foreground-color
The foreground color of statusbar. Possible values: an rgb
color-string. default value: #ffffff.
hint-active-color
The background color for active link, i.e. the link followed when
Return is pressed. Possible values: a rgb color string, default
value: #00ff00.
hint-autofollow
Whether to follow hints automatically if only one hint matches the
typed letters. Default value: true.
hint-bg-color
The background color used for hints. Possible values: a rgb color
string, default value: #000088.
hint-border
The boreder used for hints. Possible values: a css border
description, default value: 2px dashed #000000.
hint-fg-color
The foreground color used for hints. Possible values: a rgb color
string, default value: #ffffff.
hint-font
The font used for hints. Possible values: css font description,
default value: bold 10px monospace.
hint-highlight-links
Whether to highlight all links in hint-mode, default value: false.
hint-letter-seq
A letter sequence used for letter hints. Possible values: a letter
sequence, every letter should appear only once. Default value:
FDSARTGBVECWXQYIOPMNHZULKJ.
hint-normal-color
The background color for a normal link. Possible values: a rgb
color string, default value: #ffff99.
hint-offset-left
Left offset of hints in pixel, negative values will shift hints to
the left, positive values to the right, default value: 0.
hint-offset-top
Top offset of hints in pixel, negative values will shift hints to
the top, positive values to the bottom, default value: 0.
hint-opacity
The opacity of a hint. Possible values: a decimal from 0.0 to 1.0,
default value: 0.75.
hint-style
The type of hints, that are used. When set to "number", letters
will match the links text. Possible values: letter/number, default
value: letter.
hints-key-lock
Timeout in milliseconds all keypresses are ignored after following
a hint, default value: 250
history-length
The urls that are saved in the browsing history. Specifying a too
large value can make tab-completion slow. Possible values: number
of urls, default value: 500.
javascript-api
Whether to enable the javascript api. If set to disabled the
javascript context won’t be initialized, meaning that also
extensions won’t work. If set to automatic the javascript context
will automatically be initialized if scripts that use the api are
present in $XDG_CONFIG_HOME/dwb/userscripts or extensions are
installed. If set to enabled the javascript context will always be
initialized, useful if no scripts are present in
$XDG_CONFIG_HOME/dwb/userscripts but the javascript api is used
from commandline or in a custom command. The javascript context is
only initialized on startup, so changing the value needs a restart.
Default value: automatic.
javascript-schemes
Whether to allow loading javascript snippets with scheme
javascript, default value: true.
load-on-focus
Whether to defer loading of a tab until a tab is focused,
especially useful on startup and with slow internet connections,
default value: false.
max-visible-completions
The maximum number of visible completions, default value: 11.
maximum-tabs
Limits the maximum number of visible tabs, 0 means no limit. If
tab-orientation is set to vertical-left or vertical-right the
number of maximum tabs is computed automatically and maximum-tabs
will be ignored, default value: 0.
message-delay
The duration messages are shown. Possible values: duration in
seconds (integer), default value: 2.
mouse-cycles-through-tabs
Whether mouse wheel cycles through tabs, default value: true.
navigation-history-max
Maximum length of navigation history. enable-private-browsing must
be disabled to save command history at all. default value: 500.
new-tab-position-policy
Controls the position of a newly created tab, possible values are
right, a new tab is created right of the current tab, left, a new
tab is created left of the current tab, rightmost, a new tab is
created left of the last tab and leftmost, a new tab is created
left of the first tab. Default value: right.
normal-completion-bg-color
The background color of inactive element in tab-completion.
Possible values: an rgb color-string, default value: #151515.
normal-completion-fg-color
The foreground color of inactive element in tab-completion.
Possible values: an rgb color-string. color-string, default value:
#eeeeee.
passthrough-keys
Keysstrokes that will be passed to the website, webkit means only
webkit builtin shortcuts will be passed through, all means all will
be passed through, none means no keystrokes will be passed through,
default value: webkit.
print-previewer
Program used for printing previews, default value: NULL.
private-color
Statusbar color used when private browsing is enabled, default
value: #505050.
proxy
Whether to use a HTTP-proxy. Possible values: true/false, default
value: false.
proxy-url
The proxy-url, can also be set via the http_proxy environment
variable. Possible values: an url string, default value: NULL.
save-session
Save the session when dwb is closed and restore the last saved
session when invoking dwb. Possible values: true/false, default
value: true.
scheme-handler
A script or application that handles uris that cannot be loaded by
dwb. dwb only loads uris with scheme http, https, file, about and
dwb; support for e.g. ftp is provided through a scheme handler. The
scheme handler can either be an application or a script. The first
command line argument will be the uri for your application, so you
can simply set this to xdg-open. There are also the environment
variables DWB_URI, DWB_SCHEME, DWB_COOKIES, DWB_USER_AGENT,
DWB_PROXY and DWB_REFERER available which can be used in a script,
for example:
#!/bin/sh
case ${DWB_SCHEME} in
mailto) xterm -e "mutt ${DWB_URI}";;
ftp) xterm -e "ncftp ${DWB_URI}";;
*) xdg-open ${DWB_URI}
esac
show-single-tab
Whether to show the tabbar if only one tab is open, default value:
true.
searchengine-submit-pattern
The pattern which will be replaced with the search terms.
scroll-step
The step-increment in pixels for scrolling. If set to a value lower
or equal 0, the default step-increment will be used. default value:
0.0.
scrollbars
Whether scrollbars should be enabled. default value: false.
single-instance
Only one instance of dwb per user. This option will be overridden
by the command line option -n. Possible values: true/false, default
value: true.
ssl-strict
Whether to allow only save ssl-certificates. default value: true.
ssl-ca-cert
Path to ssl-certificate, only with libsoup < 2.38.
ssl-use-system-ca-file
Whether to use the system certification file, only with libsoup >=
2.38. default value: true.
ssl-trusted-color
Color of the url in the statusbar for ssl-encrypted sites and
trusted certificate. default value: #00ff00.
ssl-untrusted-color
Color of the url in the statusbar for ssl-encrypted sites and
untrusted certificate. default value: #ff0000.
startpage
The default startpage. Possible values: an url or "about:blank" for
an empty startpage, default value: about:blank.
statusbar-height
Height of the statusbar, if set to 0 it will be computed
automatically.
sync-files
Type of files to sync, see also file-sync-interval. Possible values
are all, cookies, history, session or a combination, default value:
all.
tabbar-height
Height of the tabbar, if favicon-size is set the favicon-size
will be the minimum height, if set to 0 it will be computed
automatically.
tab-orientation (GTK2 only)
Orientation of tabs, possible values are horizontal, vertical-left
and vertical-right, if set to vertical-left or vertical-right t and
T in widget-packing will be ignored, instead tabs are placed
left/right to the webview respectively, default value: horizontal.
tab-width (GTK2 only)
Width of vertical tabs in pixel, will be ignored for horizontal
tabs, horizontal tabs will always use the complete space, default
value 100.
tabbar-visible
When the tabbar is hidden specifies the number of seconds the
tabbar is visible when switching between tabs, default value: 2.
tab-active-bg-color
The background color the tab of the focused tab. Possible values:
an rgb color-string, default value: #000000.
tab-active-fg-color
The foreground color of the tab of the focused tab. Possible
values: an rgb color-string, default value: #ffffff.
tab-normal-bg-color
The background color the tab of a not focused tab. Possible values:
an rgb color-string, default value: #505050.
tab-normal-fg-color
The foreground color of the tab of a not focused tab. Possible
values: an rgb color-string, default value: #cccccc.
tab-normal-fg-color
The foreground color of the tab of a not focused tab. Possible
values: an rgb color-string, default value: #cccccc.
tab-protected-color
The color of the tabnumber of protected tabs. Possible values: an
rgb color-string, default value: #ff0000.
tab-number-color
The color of the tabnumber. Possible values: an rgb color-string,
default value: #ff0000.
tabbed-browsing
Enable tabbed-browsing. If disabled, all new window/new tab
requests will be opened in a new window, default value: true.
update-search-delay
Delay in milliseconds before updating search results. If set to 0
search results will be updated after every keypress. If set to a
value greater than 0 search results will be updated after that
delay but only if the search-term has not changed since the timeout
started. It is recommended to set this value greater than 0,
default value: 200.
widget-packing
A string consisting of 4 characters, where possible characters are:
d, w, T, t, S and s. The order of the widgets correspond the the
order of characters in the string where d corresponds to the
download bar, t and T to the tab bar where T means that the tabbar
will not be visible, w to the webview and s and S to the statusbar
where S means that the statusbar won’t be visible. Default value:
dtws.
FILES
Userscripts
Userscripts can be stored in ~/.config/dwb/userscripts. The first
argument of the script will be the current url, the second argument is
the title, the third argument will be the profile name, the fourth
argument is the numerical modifier and the fifth argument is a
commandline argument. Also the variables DWB_URI, DWB_TITLE,
DWB_PROFILE, DWB_NUMMOD, DWB_ARGUMENT, DWB_REFERER, DWB_PROXY, and
DWB_USER_AGENT are set. The keybinding for the script must be defined
in the script itself in a commented line of the form <comment symbols>
dwb: <keybinding>.
dwb also provides a small javascript api, scripts that use the api must
have the special shebang #!javascript or start with //!javascript for
details see also http://portix.bitbucket.org/dwb/api/ and dwb-js(7).
Examples
The following script will download the current webpage:
#!/bin/bash
# dwb: Control w
wget $DWB_URI
Popup an alert dialog:
#!/bin/bash
# dwb: Control h
echo "js window.alert('Hello world');" > ${DWB_FIFO}
Block requests from specific sites:
#!javascript
var block = [ new RegExp("https://example.org.*"), new RegExp("https://example.co.uk.*") ];
Signal.connect("resource", function(wv, frame, request) {
for (var i=0, l=block.length; i<l; ++i)
{
if (block[i].test(request.uri))
{
request.uri = "about:blank";
return true;
}
}
return false;
});
RESOURCES
bitbucket: http://bitbucket.org/portix/dwb
homepage: http://portix.bitbucket.org/dwb/
SEE ALSO
dwbem(1) dwbremote(1) dwb-js(7)
03/24/2014 DWB(1)