path: root/network/qutebrowser
diff options
author Dave Woodfall <>2021-03-19 06:50:24 +0000
committer Willy Sudiarto Raharjo <>2021-03-20 11:00:45 +0700
commit9d8418512a5c788ba3fc1f800d09c5591df9a072 (patch)
tree04c7a5ea79c5970a1edc1bf4231ca620c8c04798 /network/qutebrowser
parentc2c34c5f56368483587ea701d4ffc4790003aeb0 (diff)
network/qutebrowser: Add adblock notes to README.
Signed-off-by: Dave Woodfall <> Signed-off-by: Willy Sudiarto Raharjo <>
Diffstat (limited to 'network/qutebrowser')
1 files changed, 50 insertions, 3 deletions
diff --git a/network/qutebrowser/README b/network/qutebrowser/README
index 5d3cf497f4..f1ca3e6236 100644
--- a/network/qutebrowser/README
+++ b/network/qutebrowser/README
@@ -1,12 +1,59 @@
-qutebrowser (qt5 keyboard driven webbrowser)
+Qutebrowser (qt5 keyboard driven web browser)
-qutebrowser is a keyboard-focused browser with a minimal
+Qutebrowser is a keyboard-focused browser with a minimal
GUI. It's based on Python and PyQt5 and free software,
licensed under the GPL. It was inspired by other
browsers/addons like dwb and Vimperator/Pentadactyl.
-Optional dependencies:
qt5-webkit (for the webkit backend)
Pygments (for the :view-source command with the QtWebKit backend.
and with QtWebEngine for ":view-source --pygments")
+If the Python `adblock' library is available, it is now used to
+integrate Brave's Rust adblocker library for improved adblocking based
+on ABP-like filter lists (such as EasyList). If it is unavailable,
+Qutebrowser falls back to host-blocking.
+There are 36 rust requirements for python-adblock, and they aren't
+available on SBo yet, so the easiest way to install it is with pip3,
+which requires a working network connection.
+Instructions to install it into ~/.local/lib with pip3:
+1. Update llvm to the package in extra/
+To update with slackpkg:
+Edit /etc/slackpkg/slackpkg.conf and change the order of PRIORITY so
+that `extra' is before `%PKGMAIN' in the list:
+ PRIORITY=( extra patches %PKGMAIN pasture testing )
+Run `slackpkg upgrade llvm'
+Reset PRIORITY back to the default order. The pip3 commands should be
+run as your normal user:
+2. Update pip3 to the latest version: pip3 install --user --upgrade pip
+3. Install adblock: pip3 install --user adblock
+Now start Qutebrowser and check `:version;'. It should list adblock
+with the version number, e.g.:
+adblock: 0.4.2
+Next, run the update command:
+To see what options there are:
+:set content.blocking<TAB>
+llvm can be added to /etc/slackpkg/blacklist to keep this version, or
+run the slackpkg command again to revert back to the stock version.