1BADWOLF(1) BSD General Commands Manual BADWOLF(1)
2
4 badwolf — minimalist and privacy-oriented web browser based on WebKitGTK
5
7 badwolf [webkit/gtk options] [URLs or paths]
8
10 badwolf is a minimalist browser that cares about privacy, it is based on
11 WebKitGTK and thus also accepts WebKitGTK (and dependencies) flags and
12 environment variables, unfortunately there doesn't seems to be manpages
13 for theses.
14 Runtime configuration specific to badwolf will probably get added at a
16 later release.
17
19 The following section lists the keybinding by their action, each item is
20 described by the widget the focus is on or ⟨any⟩ if it works for the
21 whole window, followed by the keybind it grabs.
22 webview Ctrl-Scroll
24 Zooms the webpage in/out.
25 webview Ctrl-0
27 Resets webpage zoom to 100%.
28 any Ctrl-t
30 Creates a new tab (in a new session, similar as pressing the but‐
31 ton)
32 browser Ctrl-F4, browser Alt-d
34 Closes the current tab
35 browser Ctrl-f
37 Focuses on the search entry
38 browser Ctrl-l
40 Focuses on the location(URL) entry
41 browser Ctrl-Shift-r / Ctrl-r, browser F5
43 Reloads the content in the current tab (with/without clearing
44 cache)
45 browser Escape
47 Stops loading the content in the current tab
48 browser F7
50 Toggles caret browsing.
51 browser F12
53 Opens the web inspector.
54 browser Ctrl-[ / Ctrl-]
56 Go back/forward in current tab's history
57 browser Ctrl-p
59 Print the current page. (spawns a dialog)
60 any Alt-Left / Alt-Right
62 Go to the previous/next tab
63 any F1 Shows the about dialog
65 any Alt-n
67 Where n is any numeric-row key. Go to the n-th tab, 0 goes to
68 the last one.
69 DEFAULT ONES
71 Here is a incomplete list of the default Webkit/GTK keybindings:
72 any Ctrl-PageUp / Ctrl-PageDown
74 Go to the previous/next tab
75 search Ctrl-g / Ctrl-Shift-g
77 When the search box is focused it goes to the Next/Previous
78 search term.
79 search Escape
81 Cancels current search
82
84 BADWOLF_L10N
85 A colon-separated list in the form lang_COUNTRY where lang is in
86 ISO-639 and COUNTRY in ISO-3166. For example
87 BADWOLF_L10N="en_GB:fr_FR:de_DE". When this variable isn't set,
88 spelling isn't activated. A more generic variable name is also
89 intended to be used in the future.
90 To get the list of supported dictionaries execute enchant-lsmod-2
92 -list-dicts or before enchant 2.0: enchant-lsmod -list-dicts
93
95 The following paths are using sh(1) syntax to correctly support XDG Base
96 Directory Specification, you can use the echo(1) command to check where
97 it is on your system.
98 ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
100 WebKit-specific content-filter file, this allows to block un‐
101 wanted content (ads, nagware, ...). For some introductory infor‐
102 mation about the format see:
103 https://webkit.org/blog/3476/content-blockers-first-look/
104 https://webkit.org/blog/4062/targeting-domains-with-content-
105 blockers/
106 https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
107 For a converter using AblockPlus-style filters, try:
109 https://gitlab.com/eyeo/adblockplus/abp2blocklist
110 For a ready-to-use file (that you should update periodically),
112 try: https://easylist-
113 downloads.adblockplus.org/easylist_min_content_blocker.json
114 ${XDG_CACHE_HOME:-$HOME/.cache}/badwolf/filters
115 This is where the compiled filters are stored, the file(s) in it
116 are automatically generated and so shouldn't be edited. Docu‐
117 mented here only for sandboxing / access-control purposes.
118 ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/bookmarks.xbel
119 XBEL (XML Bookmark Exchange Language) file, known to be currently
120 supported by: elinks(1), konqueror(1), kbookmarkeditor(1). Doing
121 a symbolic link from their path works fine but you might also
122 want to use XInclude to merge multiple XBEL files.
123 For more information about this format see:
125 http://pyxml.sourceforge.net/topics/xbel/
126 For an example XBEL file see: https://hacktivis.me/bookmarks.xbel
128 ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extension/
129 Directory containing the WebKitWebExtensions:
130 https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html
131 to be loaded into badwolf. Note: They aren't the JavaScript-based
132 Web-Extensions supported by Firefox or Chrome, but native code in
133 shared objects using the WebKitGTK API.
134 Examples of useful extensions may be found at:
136 https://hacktivis.me/git/badwolf-extensions
137 ${DATADIR:-/usr/local/share}/badwolf/interface.css
138 ${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css
139 CSS files (respectively system and user-level) for styling bad‐
140 wolf interface. See
141 http://web.archive.org/web/20210420214617/https://developer.gnome.org/gtk3/stable/chap-
142 css-properties.html for the properties being available.
143 For testing your styles I would recommend using the
145 GTK_DEBUG=interactive environment variable on launching badwolf
146 and going to the CSS tab.
147
149 Haelwenn (lanodan) Monnier <contact+badwolf@hacktivis.me>
150
152 You can submit contributions or tickets to
153 https://gitlab.com/lanodan/badwolf or contact+badwolf@hacktivis.me, with
154 git-send-email(1) for patches.
155BSD December 5, 2021 BSD