summaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorIvan Boikov <66747290+ivan-boikov@users.noreply.github.com>2024-05-10 20:27:26 +0000
committerGitHub <noreply@github.com>2024-05-10 20:27:26 +0000
commit19d4eb62593e360eb2ad45cb9bdbea12c1537df6 (patch)
tree218c25f18af4b3faa8b74da53a0126ef7961724a /README.md
parent251f28af53e2f3c7ec2059edb98143b8a6e5b58a (diff)
Create README.md
Diffstat (limited to 'README.md')
-rw-r--r--README.md21
1 files changed, 21 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..f02fc24
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+# genfox-overlay
+Essential privacy and usability addons, handled like Gentoo packages.
+
+## Motivation
+* Automatic updates are great until a [rugpull](https://www.i-dont-care-about-cookies.eu/whats-new/acquisition/) [happens](https://adblockplus.org/acceptable-ads).
+* Manual updates can be forgotten.
+* Global configuration is useful for multi-user computers.
+
+## Installation
+1. `eselect repository add genfox-overlay git https://github.com/ivan-boikov/genfox-overlay.git`
+2. `emaint sync --repo genfox-overlay`
+3. `emerge www-misc/firefox-policy` installs a system-wide policy for blocking updates for the browser and addons specified with USE flags.
+
+## Notes
+* Addon policies are permissive: they can be disabled/deleted by a user.
+* [Since 2020 Firefox no longer supports addon sideloading](https://blog.mozilla.org/addons/2020/03/10/support-for-extension-sideloading-has-ended) except for [ESR, Developer, Nightly and unbranded editions](https://support.mozilla.org/en-US/kb/add-on-signing-in-firefox).
+Only binary packages for addons are supported, although there is a source-based `uBlock Origin` package.
+* [Excess addons harm privacy](https://github.com/arkenfox/user.js/wiki/4.1-Extensions), so only a few addons are included.
+
+## TODO
+* arkenfox configs