From 24ef11e857810fbaa32b3398612663536edc1ce7 Mon Sep 17 00:00:00 2001 From: quindecim <49964366+quindecim@users.noreply.github.com> Date: Mon, 13 May 2019 17:48:18 +0000 Subject: [PATCH] Update README.md --- README.md | 85 +++++++++++++++++++++++++++++++++---------------------- 1 file changed, 51 insertions(+), 34 deletions(-) diff --git a/README.md b/README.md index 3df3cf6..bc1cf81 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,12 @@ # user.js | Fennec F-Droid -I created this project with the intention of creating something really dedicated for Android variants of Firefox. -Taking inspiration from various authors of user.js for Desktop, investigating and evaluating with experts in privacy various parameters dedicated. Giving a description and documentation to discuss each preferences in the better way possible. +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. -## aims + + +## Aims: * online security * more privacy @@ -11,63 +14,77 @@ Taking inspiration from various authors of user.js for Desktop, investigating an * less unique fingerprint possible -## best use -This user.js has been designed exclusively for Mobile use and you can use on these browsers: +## Best Use: + +This `user.js` has been designed exclusively for Mobile use and you can use on these browsers: * [Fennec F-Droid](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid -* [Firefox Browser](https://play.google.com/store/apps/details?id=org.mozilla.firefox&hl=en_US) - Google Play +* [Firefox for Android](https://play.google.com/store/apps/details?id=org.mozilla.firefox&hl=en_US) - Google Play * [IceCatMobile](https://f-droid.org/en/packages/org.mozilla.fennec_fdroid/) - F-Droid -## installation +## Settings Protection: -### first root method +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. -1. 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/). -2. Start for the first time (offline mode/no data connections) and wait 5 sec. -3. Close Fennec. -4. Download and move my user.js file in: -data/data/org.mozilla.fennec_fdroid/files/mozilla/[xxxxxxx].default -5. Start Fennec and test if user.js was applied browsing to "about:config" and see if "user.js.applied" is "true". + + +## 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`. If this doesn't work I suggest you to use "second root method" below. -### second root method +### second root method (Fennec F-Droid) -1. 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/). -2. Download and install [user.js-updater app](https://github.com/v1nc/user.js-updater/releases). -2. Start for the first time (offline mode/no data connections) and wait 5 sec. -4. Close Fennec. -5. Open user.js-updater app. -6. Select the browser you want to apply user.js through the "SELECT BROWSER" bar at the top. -7. Select "quindecim" as the author of user.js you want to apply. -8. Tap "UPDATE" at the bottom and grant root permission to proceed. -9. Start Fennec and test if user.js was applied browsing to "about:config" and see if "user.js.applied" is "true". +- 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`. Thanks to [v1nc](https://github.com/v1nc/) for creating this app, useful for this method. -## comparision + +## Comparision: You can also compare my user.js with user.js from other authors [HERE](https://quindecim.github.io/compare-user.js/) -## contacts + +## Contacts: You can enjoy my [Telegram group](https://t.me/fennec_fdroid) for support, talk about privacy and security topics in general. -## thanks to -I really thank all the authors of user.js from which I took inspiration: +## Thanks: -* [pyllyukko](https://github.com/pyllyukko/user.js) - Desktop optimized -* [OrangeManBad](https://git.nixnet.xyz/OrangeManBad/user.js) - Desktop optimized / pyllyukko fork -* [gHacks](https://github.com/ghacksuserjs/ghacks-user.js) - Desktop optimized -* [Librefox Browser](https://github.com/intika/Librefox) - Desktop optimized +I really thank all the authors of `user.js` from which I took inspiration: -## special thanks to +* [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) -all the members of my Telegram group who support me and give me motivation :) +## Special Thanks: + +to all the members of my Telegram group who support me and give me motivation