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
92 ${XDG_CONFIG_HOME:-$HOME/.config}/badwolf/content-filters.json
93 WebKit-specific content-filter file, this allows to block un‐
94 wanted content (ads, nagware, ...). For some introductory infor‐
95 mation about the format see:
96 https://webkit.org/blog/3476/content-blockers-first-look/
97 https://webkit.org/blog/4062/targeting-domains-with-content-
98 blockers/
99 https://developer.apple.com/documentation/safariservices/creating_a_content_blocker
100 For a converter using AblockPlus-style filters, try:
102 https://gitlab.com/eyeo/adblockplus/abp2blocklist
103 For a ready-to-use file (that you should update periodically), try:
105 https://easylist-
106 downloads.adblockplus.org/easylist_min_content_blocker.json
107 This is where the compiled filters are stored, the file(s) in it are au‐
108 tomatically generated and so shouldn't be edited.
109 XBEL (XML Bookmark Exchange Language) file, known to be currently sup‐
110 ported by: elinks(1), konqueror(1), kbookmarkeditor(1). Doing a symbolic
111 link from their path works fine but you might also want to use XInclude
112 to merge multiple XBEL files.
113 For more information about this format see:
115 http://pyxml.sourceforge.net/topics/xbel/
116 Directory containing the WebKitWebExtensions:
117 https://webkitgtk.org/reference/webkit2gtk/stable/WebKitWebExtension.html
118 to be loaded into badwolf. Note: They aren't the JavaScript-based
119 Web-Extensions supported by Firefox or Chrome, but native code in shared
120 objects using the WebKitGTK API.
121 Examples of useful extensions may be found at:
123 https://hacktivis.me/git/badwolf-extensions
124 CSS files (respectively system and user-level) for styling badwolf inter‐
125 face. See https://developer.gnome.org/gtk3/stable/chap-css-
126 properties.html for the properties being available.
127 For testing your styles I would recommend using the GTK_DEBUG=interactive
129 environment variable on launching badwolf and going to the CSS tab.
130
132 Haelwenn (lanodan) Monnier <contact+badwolf@hacktivis.me>
133
135 You can submit contributions or tickets to
136 https://gitlab.com/lanodan/badwolf or contact+badwolf@hacktivis.me, with
137 git-send-email(1) for patches.
138 June 14, 2021