summaryrefslogtreecommitdiffstats
path: root/network/qutebrowser/README
diff options
context:
space:
mode:
Diffstat (limited to 'network/qutebrowser/README')
-rw-r--r--network/qutebrowser/README50
1 files changed, 37 insertions, 13 deletions
diff --git a/network/qutebrowser/README b/network/qutebrowser/README
index 9e22eb03c3..f5269d0514 100644
--- a/network/qutebrowser/README
+++ b/network/qutebrowser/README
@@ -1,29 +1,53 @@
-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.
+ADBLOCK NOTE:
-Optional dependency:
+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.
-qt5-webkit-annulen (for the webkit backend)
+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:
-NOTE:
+1. Update llvm to the package in extra/
-pyPEG2 needs building for python3:
+To update with slackpkg:
-PYTHON3=yes ./pyPEG2.SlackBuild
+Edit /etc/slackpkg/slackpkg.conf and change the order of PRIORITY so
+that `extra' is before `%PKGMAIN' in the list:
-If you are using sbopkg you can add this as an option on
-their pages before starting the build queue.
+ PRIORITY=( extra patches %PKGMAIN pasture testing )
+Run `slackpkg upgrade llvm'
-NOTE 2:
+Reset PRIORITY back to the default order. The pip3 commands should be
+run as your normal user:
-There is a list of changes and fixes for versions on the
-release page:
+2. Update pip3 to the latest version: pip3 install --user --upgrade pip
-https://github.com/qutebrowser/qutebrowser/releases
+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:
+
+:adblock-update
+
+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.