mobile_user.js/README.md

95 lines
3.7 KiB
Markdown
Raw Normal View History

2019-05-10 09:07:21 +00:00
# user.js | Fennec F-Droid
2019-05-10 08:45:47 +00:00
2019-05-13 19:13:41 +00:00
I made this project to create something dedicated for Firefox for Android.
2019-05-13 19:19:27 +00:00
The `user.js` file is used to configure Firefox in the safest and fastest way possible.
2019-05-13 19:13:41 +00:00
To realize this project I was inspirated by various authors of `user.js` and I've implemented some preferences of mine.
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
2019-05-10 08:46:24 +00:00
* online security
* more privacy
* better performance
* less unique fingerprint possible
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Best Use:
2019-05-13 17:48:53 +00:00
This `user.js` has been designed for Mobile use and you can use on these browsers:
2019-05-10 08:45:47 +00:00
* [Fennec F-Droid](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid
* [Firefox for Android](https://archive.mozilla.org/pub/mobile/releases/) - Mozilla Archive
* [Firefox for Android Beta](https://archive.mozilla.org/pub/mobile/releases/) - Mozilla Archive
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
2019-09-05 10:08:34 +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-03-01 17:45:12 +00:00
- Download and install Fennec F-Droid from the official [F-Droid client](https://f-droid.org/FDroid.apk) or from the official [F-Droid Website](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/)
2020-01-17 23:00:36 +00:00
- Start Fennec for the first time (offline mode/no data connections) and wait about 5 sec.
- Close Fennec.
2019-05-13 17:48:18 +00:00
- Clone or download zip file and extract it
- Locate Fennec's installation directory `data/data/org.mozilla.fennec_fdroid/files/mozilla/[xxxxxxx].default`
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
- Start Fennec F-Droid and test if `user.js` was applied :
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
2019-05-13 17:48:18 +00:00
- Download and install Fennec F-Droid form the official [F-Droid client](https://f-droid.org/FDroid.apk) or from the official [F-Droid Website](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/)
2020-01-17 23:00:36 +00:00
- Download and install [User.js Updater](https://github.com/v1nc/user.js-updater/releases)
- Start Fennec for the first time (offline mode/no data connections) and wait about 5 sec.
- Close Fennec.
- Open `User.js Updater` app and grant storage permission.
- Tap `UPDATE` at the bottom and grant root permission.
2020-03-01 17:45:12 +00:00
- Start Fennec and test if `user.js` was applied :
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
## Comparision:
You can also compare my `user.js` with the `user.js` from other authors [HERE](https://v1nc.github.io/comparison/).
2019-05-13 17:48:18 +00:00
## Contacts:
2019-05-10 08:45:47 +00:00
2019-11-22 19:42:11 +00:00
You can join [Fennec F-Droid | CHAT](https://t.me/qd_invitation) with Telegram for support or talk about privacy and security topics.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Thanks:
2019-05-13 23:27:27 +00:00
I really thanks all the authors who inspired me:
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
* [gHacks](https://github.com/ghacksuserjs/ghacks-user.js)
* [Librefox Browser](https://github.com/intika/Librefox)
2019-05-13 23:20:29 +00:00
* [pyllyukko](https://github.com/pyllyukko/user.js)
* [OrangeManBad](https://git.nixnet.xyz/OrangeManBad/user.js) - (pyllyukko fork)
2019-05-13 17:48:18 +00:00
* [CHEF-KOCH](https://github.com/CHEF-KOCH/FFCK/tree/master/user.js)
2019-05-10 08:45:47 +00:00
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
2019-05-14 01:34:39 +00:00
to all the members of my Telegram group who support me and give me motivation.