added the content of readme

README.md

@@ -1,2 +1,55 @@
-# user.js
-Removes Mozilla spyware from Firefox and makes it more secure
+<h1 align="center">hnhx/user.js</h1>
+<p align="center">Removes Mozilla spyware from Firefox and makes Firefox more secure</p>
+
+<br>
+
+## About this user.js
+
+This user.js aims at disabling all Firefox telemetry (spyware), it also hardens the browser and replaces the spyware search engines with privacy respecting ones.
+
+<br>
+
+## Can't I just disable telemetry in the settings?
+
+Just simply disabling telemetry in the settings is not enough anymore, Firefox will still make multiple connections to Mozilla, Google and other servers, some of these connections even persist as long as Firefox is open.
+
+<br>
+
+## How to use (GNU/Linux)
+
+Clone the repo
+```
+git clone https://github.com/hnhx/user.js
+```
+
+Find your Firefox profile directory, it will probably look like this: (random string).default-release
+```
+ls $HOME/.mozilla/firefox
+```
+
+Close Firefox now!
+<br>
+
+Remove the content of the directory 
+```
+rm -rf $HOME/.mozilla/firefox/(YOUR PROFILE DIR)/*
+```
+
+Now move the content of the repo to your profile directory
+```
+cp user.js/firefox/* $HOME/.mozilla/firefox/(YOUR PROFILE DIR)
+```
+
+Done! Now you can open Firefox again!
+
+<br>
+
+## Is this any better than arkenfox?
+<p align="center">
+  <img src="./screenshot.png" width="400">
+  <img src="./screenshot_arkenfox.png" width="400">
+</p>
+
+Arkenfox improves on the situation however as you can see on the image Firefox still makes multiple connection to Google and other servers (the firefox related connections are in the red area).
+<br><br>
+You can replicate the results with the `iftop` tool.