update documentation

software/001-librewolf.qd

@@ -0,0 +1,87 @@
+.docname {Librewolf Browser}
+.include {docs}
+
+Install the librewolf browser with `yay -S librewolf-bin`.
+
+## Configuration
+
+### Account and Synchronisation
+
+- Name the Profile
+- Enable backup of non-sensitive data
+
+### Home and Startup
+
+- Set start page for new windows to `http://zechert.net`
+- Set start page for new tabs to `Firefox Home`
+
+### Search
+
+- Use DuckDuckGo as search engine
+
+### Privacy and Security
+
+- Enable `Limit cross-origin referers`
+- Disable `Enable ResistFingerprinting` (required to apply a theme)
+- Disable `Remember browsing and download history`
+
+Some websites should be able to store some cookies, e.g. to keep logins alive.
+Add them to the Exceptions in `Browsing Data -> Manage Exceptions`
+
+- `https://accounts.google.com`
+- `https://www.youtube.com`
+- `https://github.com`
+- `https://copilot.microsoft.com`
+- `https://login.microsoftonline.com`
+- `https://login.live.com`
+- `https://git.zechert.net`
+
+### Appearance
+
+- Set `Web site appearance` to `Dark`
+
+### Tabs and browsing
+
+- Enable `Ctrl+Tab cycles through tabs in recently used order`
+- Enable `Search for text when you start typing`
+- Disable `Enable picture-in-picture video controls`
+- Enable `Play DRM-controlled content`
+- Disable `Enable middle click paste`
+
+### Accessibility
+
+- Enable `Use autoscrolling`
+- Enable `Always show scrollbars`
+
+### Languages
+
+- Disable `Prompt to translate pages`
+- Spellcheck: Download dictionaries for en-GB, en-US and de-DE
+
+### Other settings
+
+Open the advanced settings by typing `about:config` in the address bar and set the following
+
+- `browser.sessionstore.resume_from_crash: false`
+
+## Themes
+
+Install the Extension [Firefox Color](https://addons.mozilla.org/en-GB/firefox/addon/firefox-color/). Select the accent color from
+<https://github.com/catppuccin/firefox?tab=readme-ov-file#usage>. E.g. Macchiato-Lavender.
+
+## Extensions
+
+Download and Install the following extensions
+
+- `Bitwarden`
+- `uBlock origin`:
+  - Enable `I am an advanced user`.
+  - Activate the following global blocks:
+    - `3rd party frames`
+    - `3rd party scripts`
+  - Configure Filter Lists as required
+- `Dark Reader`
+- `Stylus`: Custom themes for websites
+   Check <https://github.com/catppuccin/userstyles/tree/main>.
+   Usage guide: <https://userstyles.catppuccin.com/getting-started/usage/>
+