mobile_user.js/README.md

146 lines
4.9 KiB
Markdown
Raw Normal View History

2021-08-03 15:09:34 +00:00
# user.js | Firefox Fenix Nightly, Iceraven, Fennec F-Droid and Mull
2019-05-10 08:45:47 +00:00
2020-09-19 13:47:04 +00:00
The `user.js` file is used to configure Firefox for android in the safest and fastest way possible.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
2020-09-19 14:40:41 +00:00
## Goals:
2019-05-10 08:45:47 +00:00
2020-09-19 14:17:55 +00:00
* enhance security and privacy
* improve performance
* better fingerprint possible
* reduce automatic connections
2019-05-10 08:45:47 +00:00
2020-09-19 14:40:41 +00:00
## Compatible browsers:
2019-05-13 17:48:18 +00:00
2020-09-19 13:17:49 +00:00
This `user.js` has been designed for mobile purposes and you can use it on these browsers:
2019-05-10 08:45:47 +00:00
2020-09-19 10:00:39 +00:00
* [Firefox Fenix Nightly for Android](https://firefox-ci-tc.services.mozilla.com/tasks/index/mobile.v2.fenix.nightly.latest) - Mozilla-mobile
2020-09-19 10:11:07 +00:00
* [Iceraven browser](https://github.com/fork-maintainers/iceraven-browser) - Forks maintainers
2020-09-30 19:45:15 +00:00
* [Fennec F-Droid](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid
2021-08-03 15:02:13 +00:00
* [Mull](https://f-droid.org/en/packages/us.spotco.fennec_dos/) - F-Droid
2020-09-19 10:00:39 +00:00
2020-12-12 11:42:57 +00:00
If you are running IcecatMobile or old Fennec (version 68) use [Quindecim user.js](https://git.nixnet.xyz/quindecim/mobile_user.js) instead.
2019-05-10 08:45:47 +00:00
2024-03-12 19:10:06 +00:00
## How to install (only rooted devices)
2019-05-13 17:48:18 +00:00
2024-03-12 19:10:06 +00:00
I would like to suggest the use of [Amaze](https://github.com/TeamAmaze/AmazeFileManager) or [TWRP File Manager](https://twrp.me/Devices/) before proceed.
As for the first one, make sure you enable "Use legacy listing for root" in Settings/Behavior/Advanced.
2021-08-03 18:02:54 +00:00
- Download and install the browsers from their official websites (see above)
2020-09-19 10:11:07 +00:00
- Start the browser for the first time (offline mode/no data connections) and wait about 5 sec.
- Close it.
2019-05-13 17:48:18 +00:00
- Clone or download zip file and extract it
2020-09-19 13:49:32 +00:00
- Locate browser's installation directory similar to this:
2020-09-19 13:50:37 +00:00
✳️ Firefox Fenix Nightly `data/data/org.mozilla.fenix/files/mozilla/[xxxxxxx].default`
2020-09-19 13:50:01 +00:00
2020-09-19 13:50:37 +00:00
✳️ Iceraven `data/data/io.github.forkmaintainers.iceraven/files/mozilla/[xxxxxxx].default`
2020-09-19 13:50:01 +00:00
2020-09-30 19:43:47 +00:00
✳️ Fennec F-Droid `data/data/org.mozilla.fennec_froid/files/mozilla/[xxxxxxx].default`
2020-09-19 13:49:32 +00:00
2021-08-03 18:02:54 +00:00
✳️ Mull `data/data/us.spotco.fennec_dos/files/mozilla/[xxxxxxx].default`
2020-09-19 13:58:16 +00:00
2024-03-12 19:10:06 +00:00
- Copy the extracted `user.js` file to the above installation directory. If you are using Amaze, once the file is copied, tap the three dots, properties/permissions and enable all the "read" ones and "write" for owner and group. Finally, tap Set and Ok.
2020-03-01 17:45:12 +00:00
- Delete `prefs.js` file inside the above directory
2020-09-19 10:13:17 +00:00
- Start the browser and test if `user.js` was applied :
2024-03-12 19:10:06 +00:00
browse to `about:config` and look if `_config.is.applied` is `true`.
2019-05-10 08:45:47 +00:00
2024-06-14 09:07:07 +00:00
2024-06-14 09:10:10 +00:00
## Non-rooted devices
Have a look at this:
2024-06-14 09:06:43 +00:00
2024-06-14 09:06:04 +00:00
https://github.com/yokoffing/Betterfox/issues/240
2019-05-13 17:48:18 +00:00
2024-06-14 09:07:07 +00:00
2022-01-13 14:04:59 +00:00
## Installing Iceraven addons in Fennec/Mull/Firefox Nightly
2024-03-12 19:10:06 +00:00
First of all, take into account automatic addons updates are blocked in order to avoid all the Mozilla connections.
2024-03-12 19:13:58 +00:00
2022-01-13 14:04:59 +00:00
Go to Settings, about Fennec/Mull/Firefox Nightly, tap 5 times over its logo, Debug mode will enable.
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
Back to Settings, Install add-on from file and select your .xpi files.
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
Anyway, if you wish automatic updates, edit these files adding // this way -> user_pref -> // user_pref
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
user_pref("extensions.update.enabled", false);
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
user_pref("extensions.update.url", "");
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
user_pref("extensions.autoupdate.enabled", false);
2024-03-12 19:13:58 +00:00
2024-03-12 19:10:06 +00:00
user_pref("extensions.update.background.url", "");
2020-11-04 20:47:41 +00:00
2024-03-12 19:13:58 +00:00
user_pref("extensions.update.autoUpdateDefault", false);
2020-11-04 20:47:41 +00:00
## Considerations
2024-03-12 19:10:06 +00:00
Once installed, go to Settings, ETP and select Strict.
2022-03-02 11:04:44 +00:00
2022-01-13 14:04:59 +00:00
Some automatic connections could not be blocked so you will have to add them to your host list.
2020-11-04 20:47:41 +00:00
firefox.settings.services.mozilla.com
2020-12-21 10:17:26 +00:00
https://bugzilla.mozilla.org/show_bug.cgi?id=1598562#c13
2024-03-12 19:10:06 +00:00
gitlab.com (Fennec), in order to install [wallpapers](https://gitlab.com/relan/fennecbuild/-/merge_requests/40)
2020-12-21 10:17:26 +00:00
2021-04-02 12:49:16 +00:00
safebrowsing.googleapis.com, safebrowsing.google.com, malware-error.mozilla.com, phish-error.mozilla.com and developers.google.com (safebrowsing is active and not changeable)
2020-11-04 20:47:41 +00:00
2020-12-21 10:17:26 +00:00
https://github.com/mozilla-mobile/fenix/issues/14163
2020-11-04 20:47:41 +00:00
2021-08-07 13:49:48 +00:00
## Known problems
`Some breakage?`
Try changing "network.http.referer.XOriginPolicy" from 2 to 1
`Performance loss?`
2022-01-13 14:04:59 +00:00
You have to change these strings from false to true:
2021-08-07 13:49:48 +00:00
javascript.options.ion
javascript.options.baselinejit
javascript.options.native_regexp
2020-11-04 20:47:41 +00:00
2022-07-23 11:37:47 +00:00
`Bugs with HTTP sites?`
2022-07-23 11:40:48 +00:00
Due to fission is enabled, HTTP websites don't load when HTTPS only mode is activated . Consider disabling it. There are also issues with self signed certificates in HTTPS webs.
2022-07-23 11:37:47 +00:00
2020-11-04 20:47:41 +00:00
## Thanks
2019-05-13 17:48:18 +00:00
2020-09-19 11:40:35 +00:00
I really thank the following authors:
2019-05-10 08:45:47 +00:00
2021-04-02 13:05:50 +00:00
* [Arkenfox](https://github.com/arkenfox/user.js) - The majority of this user.js.
2021-07-28 18:45:01 +00:00
* [Tor Project](https://www.torproject.org) - Some Tor Browser strings.
2021-08-11 08:10:13 +00:00
* [Quindecim](https://git.nixnet.xyz/quindecim/mobile_user.js) - Initial releases, unique strings and user design.
* [LibreWolf](https://gitlab.com/librewolf-community) - Some strings.
2022-02-13 10:17:50 +00:00
* [Better-Fox](https://github.com/yokoffing/Better-Fox) - Some strings
2020-11-19 20:50:01 +00:00
* [gallegonovato](https://git.nixnet.xyz/gallegonovato) - For his suggestions and support.
2021-04-02 13:05:50 +00:00
* [v1nc](https://github.com/v1nc/) - For his user.js updater app.
2020-09-21 21:23:18 +00:00
## License
GNU General Public License v3.0.
2021-02-04 10:17:22 +00:00
See `LICENSE` for more details.
## Other mirrors
2022-02-05 16:02:33 +00:00
https://codeberg.org/Narsil/user.js/src/branch/main/mobile