badwolf - Man Page

minimalist and privacy-oriented WebkitGTK browser

Synopsis

badwolf[webkit/gtk options] [URLs or paths]

Description

badwolf is a minimalist browser that cares about privacy, it is based on WebKitGTK and thus also accepts WebKitGTK (and dependencies) flags and environment variables, unfortunately there doesn't seems to be manpages for theses.

Runtime configuration specific to badwolf will probably get added at a later release.

Keybindings

The following section lists the keybinding by their action, each item is described by the widget the focus is on or ⟨any⟩ if it works for the whole window, followed by the keybind it grabs.

webview Ctrl-Scroll

Zooms the webpage in/out.

webview Ctrl-0

Resets webpage zoom to 100%.

any Ctrl-t

Creates a new tab (in a new session, similar as pressing the button)

browser Ctrl-F4, browser Alt-d

Closes the current tab

browser Ctrl-f

Focuses on the search entry

browser Ctrl-l

Focuses on the location(URL) entry

browser Ctrl-Shift-r / Ctrl-r, browser F5

Reloads the content in the current tab (with/without clearing cache)

browser Escape

Stops loading the content in the current tab

browser F7

Toggles caret browsing.

browser F12

Opens the web inspector.

browser Ctrl-[ / Ctrl-]

Go back/forward in current tab’s history

browser Ctrl-p

Print the current page. (spawns a dialog)

any Alt-Left / Alt-Right

Go to the previous/next tab

any F1

Shows the about dialog

any Alt-n

Where n is any numeric-row key. Go to the n-th tab, 0 goes to the last one.

Default Ones

Here is a incomplete list of the default Webkit/GTK keybindings:

any Ctrl-PageUp / Ctrl-PageDown

Go to the previous/next tab

search Ctrl-g / Ctrl-Shift-g

When the search box is focused it goes to the Next/Previous search term.

search Escape

Cancels current search

Environment

BADWOLF_L10N

A colon-separated list in the form lang_COUNTRY where lang is in ISO-639 and COUNTRY in ISO-3166. For example BADWOLF_L10N="en_GB:fr_FR:de_DE". When this variable isn't set, spelling isn't activated. A more generic variable name is also intended to be used in the future.

Files

${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/webkit-web-extensions/

Directory containing the WebKitWebExtensions to be loaded into badwolf. Note: They aren't the JavaScript-based Web-Extensions supported by Firefox or Chrome, but native code in shared objects using the WebKitGTK API.

Examples of useful extensions may be found at: https://hacktivis.me/git/badwolf-extensions https://github.com/jun7/wyebadblock

${DATADIR:-/usr/local/share}/badwolf/interface.css
${XDG_DATA_HOME:-$HOME/.local/share}/badwolf/interface.css

CSS files (respectively system and user-level) for styling badwolf interface. See https://developer.gnome.org/gtk3/stable/chap-css-properties.html for the properties being available.

For testing your styles I would recommend using the GTK_DEBUG=interactive environment variable on launching badwolf and going to the CSS tab.

Authors

Haelwenn (lanodan) Monnier <contact+badwolf@hacktivis.me>

Bugs

You can submit contributions or tickets to https://gitlab.com/lanodan/badwolf or contact+badwolf@hacktivis.me, with git-send-email(1) for patches.

Info

2019-10-31