mobile_user.js/README.md

88 lines
3.3 KiB
Markdown
Raw Normal View History

2020-09-19 13:47:04 +00:00
# user.js | Firefox Fenix Nightly), Iceraven or Fennec F-Droid
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.
2020-09-19 12:07:26 +00:00
There are 2 versions:
2020-09-19 12:08:09 +00:00
* One, recommended by default for average users.
* Another one with less connections as possible, meaning there are not automatic addons updates. You'll have to uninstall and reinstall them.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Aims:
2019-05-10 08:45:47 +00:00
2020-09-19 13:07:37 +00:00
* enhance security
* improve privacy
2019-05-10 08:46:24 +00:00
* better performance
* less unique fingerprint possible
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Best Use:
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
* [Fennec F-Droid](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid (out of date)
2020-09-19 10:00:39 +00:00
2019-05-10 08:45:47 +00:00
2019-05-14 01:34:39 +00:00
## Note:
2019-05-13 17:48:18 +00:00
2019-05-13 19:13:41 +00:00
This file contains prefs. that are not native to the Android version of Firefox, but I have chosen to add them to avoid that in the future they can be implemented by Mozilla without we can realize it.
2019-05-14 01:34:39 +00:00
2019-05-13 17:48:18 +00:00
All this does not lead into stability issues.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Installation:
2019-08-04 23:33:17 +00:00
### **ROOT METHOD 1** *(file manager)*
2019-05-13 17:48:18 +00:00
2020-09-19 13:50:01 +00:00
I would like to suggest the use of [Amaze](https://f-droid.org/en/packages/com.amaze.filemanager/) or [TWRP File Manager](https://twrp.me/Devices/) before proceed.
2020-09-19 11:48:40 +00:00
- Download and install Fenix, Iceraven or Fennec F-Droid from 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:48:56 +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:48:56 +00:00
✳️ Iceraven `data/data/io.github.forkmaintainers.iceraven/files/mozilla/[xxxxxxx].default`
2020-09-19 13:50:01 +00:00
2020-09-19 13:48:56 +00:00
✳️ Fennec F-Droid `data/data/org.fdroid.froid/files/mozilla/[xxxxxxx].default`
2020-09-19 13:49:32 +00:00
2020-03-01 17:45:12 +00:00
- Copy the extracted `user.js` file to the above installation directory.
- 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 :
2020-03-01 17:45:12 +00:00
browse to `about:config` (put it in search bar) and look if `config.applied` is `true`.
2019-05-10 08:45:47 +00:00
2020-01-17 23:00:36 +00:00
If this doesn't work I suggest you to use the **ROOT METHOD 2** below.
2019-05-10 08:45:47 +00:00
2019-08-04 23:32:46 +00:00
### **ROOT METHOD 2** *(app)*
2019-05-10 08:45:47 +00:00
2020-09-19 13:09:01 +00:00
- Download and install the browser from official websites.
2020-01-17 23:00:36 +00:00
- Download and install [User.js Updater](https://github.com/v1nc/user.js-updater/releases)
2020-09-19 10:13:17 +00:00
- Start the browser for the first time (offline mode/no data connections) and wait about 5 sec.
2020-09-19 11:30:02 +00:00
- Close it.
2020-01-17 23:00:36 +00:00
- Open `User.js Updater` app and grant storage permission.
- Tap `UPDATE` at the bottom and grant root permission.
2020-09-19 10:13:17 +00:00
- Start the browser and test if `user.js` was applied :
2020-03-01 17:45:12 +00:00
browse to `about:config` (put it in search bar) and look if `config.applied` is `true`.
2020-01-17 23:00:36 +00:00
- **AFWall+ USERS:** You can disable `Use Download Manager` option into `Settings` and enable data connection just to the app itself.
2019-05-10 08:45:47 +00:00
2020-01-17 23:01:42 +00:00
Thanks to [v1nc](https://github.com/v1nc/) for creating this app.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
2019-05-13 17:48:18 +00:00
## Thanks:
2020-09-19 11:40:35 +00:00
I really thank the following authors:
2019-05-10 08:45:47 +00:00
2020-09-19 13:15:45 +00:00
* [Quindecim] (https://git.lelux.fi/quindecim/mobile_user.js) - Without him/her, this project could not be possible.
2020-09-19 13:10:58 +00:00
* [Arkenfox] (https://github.com/arkenfox/user.js) - Updates.
2019-05-10 08:47:34 +00:00
2019-05-13 17:48:18 +00:00
## Special Thanks:
2019-05-10 08:45:47 +00:00
2020-09-19 10:00:39 +00:00
***