From 4445d3f4eaaf4382e9694c2ec6c296a5eb353c60 Mon Sep 17 00:00:00 2001
From: Alexander Bocken <alexander@bocken.org>
Date: Mon, 15 Nov 2021 22:07:45 +0100
Subject: [PATCH] added qutebrowser help

---
 docs/qutebrowser.md | 30 ++++++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 docs/qutebrowser.md

diff --git a/docs/qutebrowser.md b/docs/qutebrowser.md
new file mode 100644
index 0000000..9c9359f
--- /dev/null
+++ b/docs/qutebrowser.md
@@ -0,0 +1,30 @@
+# qutebrowser
+
+## General
+
+Qutebrowser is very dotfiles friendly, nonetheless there are some features which require manual intervention to work correctly at initial setup.
+
+## Ad-blocking
+
+Do not forget to install `python-adblock` if you want brave-like adblocking. To have domain blocking and brave-like adblocking:
+```
+:set content.blocking.method both
+:adblock-update
+```
+
+### Automatic adblock list updates:
+
+Adding to your crontab at whatever interval you wish:
+```sh
+qutebrowser --nowindow ':adblock-update;;later 10000 download-clear;;later 10500 close'
+```
+will update the adblock lists without starting a qutebrowser window.
+
+## Greasemonkey scripts
+
+To add scripts such as 4chanX to qutebrowser add the js file to `${XDG_DATA_HOME:-$HOME/.local/share}/qutebrowser/greasemonkey`. For 4chanX this would be:
+
+```sh
+wget -P ${XDG_DATA_HOME:-$HOME/.local/share}/qutebrowser/greasemonkey https://www.4chan-x.net/builds/4chan-X.user.js
+```
+followed by a `:greasemonkey-reload` in qutebrowser to activate the newly added Java scripts.