This repository has been archived on 2020-10-12. You can view files and clone it, but cannot push or open issues or pull requests.
mobile_user.js/README.md

91 lines
3.5 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 17:48:18 +00:00
I created this project with the intention of creating something really dedicated for Firefox for Android.
The file contained here is used to configure Firefox in the safest and fastest way possible.
To realize this project I took inspiration from various authors of `user.js` and I've implemented some preferences of my own.
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
2019-05-13 17:48:18 +00:00
* [Firefox for Android](https://play.google.com/store/apps/details?id=org.mozilla.firefox&hl=en_US) - Google Play
2019-05-10 08:45:47 +00:00
* [IceCatMobile](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid
2019-05-13 17:48:18 +00:00
## Settings Protection:
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 natively by Mozilla without we can realize it.
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:
### first root method (Fennec F-Droid)
- 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/)
- Start for the first time (offline mode/no data connections) and wait 5 sec.
- Close your browser
- Clone or download zip file and extract it
- Locate Fennec's installation directory `data/data/org.mozilla.fennec_fdroid/files/mozilla/[xxxxxxx].default`
- Copy the extracted `user.js` file to the install directory
- Delete `prefs.js` file inside the install directory
- Start Fennec F-Droid and test if `user.js` was applied browsing to `about:config` and look if `user.js.applied` is `true`.
2019-05-10 08:45:47 +00:00
If this doesn't work I suggest you to use "second root method" below.
2019-05-13 17:48:18 +00:00
### second root method (Fennec F-Droid)
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/)
- Download and install [user.js-updater app](https://github.com/v1nc/user.js-updater/releases)
- Start for the first time (offline mode/no data connections) and wait 5 sec.
- Close your browser
- Open `user.js-updater` app
- Select the browser you want to apply `user.js` through the `SELECT BROWSER` bar at the top
- Select `quindecim` as the author
- Tap `UPDATE` at the bottom and grant root permission to proceed
- Start Fennec F-Droid and test if `user.js` was applied browsing to `about:config` and look if `user.js.applied` is `true`.
2019-05-10 08:45:47 +00:00
2019-05-10 09:16:23 +00:00
Thanks to [v1nc](https://github.com/v1nc/) for creating this app, useful for this method.
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Comparision:
2019-05-10 08:45:47 +00:00
2019-05-10 09:01:04 +00:00
You can also compare my user.js with user.js from other authors [HERE](https://quindecim.github.io/compare-user.js/)
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
## Contacts:
2019-05-10 08:45:47 +00:00
You can enjoy my [Telegram group](https://t.me/fennec_fdroid) for support, talk about privacy and security topics in general.
2019-05-13 17:48:18 +00:00
## Thanks:
I really thank all the authors of `user.js` from which I took inspiration:
2019-05-10 08:45:47 +00:00
2019-05-13 17:48:18 +00:00
* [pyllyukko](https://github.com/pyllyukko/user.js)
* [OrangeManBad](https://git.nixnet.xyz/OrangeManBad/user.js) - (pyllyukko fork)
* [gHacks](https://github.com/ghacksuserjs/ghacks-user.js)
* [Librefox Browser](https://github.com/intika/Librefox)
* [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-13 17:48:18 +00:00
to all the members of my Telegram group who support me and give me motivation