Git/firefox-user.js
1
0
Fork 0
mirror of https://github.com/arkenfox/user.js.git synced 2024-11-24 19:41:38 +01:00
Code Issues Packages Projects Releases Wiki Activity

Updated 1.3 Implementation (markdown)

Thorin-Oakenpants 2021-12-11 10:41:02 +00:00
parent b2a2c9abbb
commit 65e03779f8
1 changed files with 9 additions and 18 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
1.3-Implementation.md

@ -1,11 +1,11 @@
### :small_orange_diamond: Before you do anything...
### :small_orange_diamond: You WILL have to make changes
:star: Do not just take the `user.js` and use it as is. It's a template, treat it as such. Much has gone into making the defaults responsible and to not put anyone at risk. At worst, you will get some inconvenience and breakage (to be expected with a fairly hardened setup). Everyone's mileage will differ, and you can undo things that "break" (except deleted items like cookies and history: read the entire page!).
Do not just take the `user.js` and use it as is. It's a template, treat it as such. Much has gone into making the defaults responsible and to not put anyone at risk. At worst, you will get some inconvenience and breakage (to be expected with a fairly hardened setup). Everyone's mileage will differ, and you can undo things that "break" (except deleted items like cookies and history: read the entire page!).
Also:
- Read the [overview](https://github.com/arkenfox/user.js/wiki/1.1-Overview). It is important to understand how a `user.js` works.
- Learn how to find and [back up](https://github.com/arkenfox/user.js/wiki/1.2-Backing-Up) your profile(s)
- If you already have a `user.js`, consider using [Compare-UserJS](https://github.com/claustromaniac/Compare-UserJS), an excellent tool to compare user.js files and output the diffs in detailed breakdown - developed by our very own resident cat, [claustromaniac](https://github.com/claustromaniac) :cat2:
- If you already have a `user.js`, consider using [Compare-UserJS](https://github.com/claustromaniac/Compare-UserJS), an excellent tool to compare user.js files and output the diffs in detailed breakdown
### :small_orange_diamond: At a bare minimum...
@ -19,13 +19,6 @@ You will need to make changes. Make sure to read about applying `overrides` on [
* :star: You will **always get prompts** and reminders from Firefox
* Please keep your software up to date in a timely fashion
:exclamation: SUPER IMPORTANT: First Party Isolation (FPI), privacy.resistFingerprinting (RFP)
- FPI is enabled (4001)
* It is recommended that you clear (Ctrl-Shift-Del) everything (except passwords) when first enabling (or permanently disabling) this, so orphaned Origin Attribute data is cleared
- RFP is enabled (4501) and webGL is disabled (4520)
* :eyes: The **letterboxing pref** `4504` is independent of `4501`. FYI: this is the pref that creates borders around your webpages: if you want dark borders, use the hidden pref `ui.systemUsesDarkTheme` = `1`
:exclamation: QUITE IMPORTANT: Change to suit
- We disable session restore (0102)
@ -43,6 +36,12 @@ You will need to make changes. Make sure to read about applying `overrides` on [
- We hardened cross origin referers (1601)
* :star: This may cause breakage where third party images and videos may not load
* Change to suit and consider installing an extension
- We disable webGL (4520)
* :star: If you want it, change it
- We enable RFP (4501) and letterboxing (4504)
* :star: If you don't want it, change it
* :eyes: The **letterboxing pref** `4504` is independent of `4501`. FYI: this is the pref that creates borders around your webpages
* :eyes: if you want dark borders, use the hidden pref `ui.systemUsesDarkTheme` = `1`
:exclamation: OTHER: Other preferences may cause site breakage, but nothing that can't be fixed. You won't "lose" anything...- it's not the end of the world.
@ -53,11 +52,3 @@ You will need to make changes. Make sure to read about applying `overrides` on [
* `[SETUP-PERF]` may impact performance
- There is a deprecated section (9999)
* You can reset these prefs in about:config if they no longer apply to your Firefox release
### :small_orange_diamond: Decide on a strategy...
So you have a `user.js`, you know how it all works, and you have checked and made a few changes. Now you can choose what profile to use. You can read all about working with [profiles](https://github.com/arkenfox/user.js/wiki/2.1-Multiple-Profiles) and [portable profiles](https://github.com/arkenfox/user.js/wiki/2.2-Multiple-Profiles-%5BFirefox-Portable%5D) and also how to run [concurrent profiles](https://github.com/arkenfox/user.js/wiki/2.3-Concurrent-Profiles) right here in this wiki.
Either use a new profile for testing or use your current profile (back it up first). The only other consideration would be how much of the `user.js` to introduce. You could either add the whole thing in one hit, or just add a few sections every so often. To be honest, there are probably less than a dozen settings that "break" a few sites functionality and they are easily reset.
Good luck, and don't be afraid to ask for help.