firefox-user.js/README.md

24 lines
2.2 KiB
Markdown
Raw Normal View History

### ![][b] user.js
2017-04-02 06:56:06 +00:00
A `user.js` is a configuration file that can control hundreds of Firefox settings. For a more technical breakdown and explanation, you can read more on the [overview](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.1-Overview) wiki page.
2017-03-30 17:36:53 +00:00
2020-08-14 09:01:14 +00:00
### ![][b] This user.js
This `user.js` is a **template** which aims to provide as much privacy and enhanced security as possible, and to reduce tracking and fingerprinting as much as possible - while minimizing any loss of functionality and breakage (but it will happen).
2017-03-30 22:27:57 +00:00
2020-08-14 09:01:14 +00:00
Everyone, experts included, should at least read the [implementation](https://github.com/ghacksuserjs/ghacks-user.js/wiki/1.3-Implementation) wiki page, as it contains important information regarding a few `user.js` settings.
2017-04-02 06:14:01 +00:00
Note that we do *not* recommend connecting over Tor on Firefox. Use the [Tor Browser](https://www.torproject.org/projects/torbrowser.html.en) if your [threat model](https://www.torproject.org/about/torusers.html.en) calls for it, or for accessing hidden services.
2019-11-08 13:46:20 +00:00
Also be aware that this `user.js` is made specifically for desktop Firefox. Using it as-is in other Gecko-based browsers can be counterproductive, especially in the Tor Browser.
2018-01-04 11:29:24 +00:00
Sitemap: [Releases](https://github.com/ghacksuserjs/ghacks-user.js/releases), [changelogs](https://github.com/ghacksuserjs/ghacks-user.js/issues?utf8=%E2%9C%93&q=is%3Aissue+label%3Achangelog), [Wiki](https://github.com/ghacksuserjs/ghacks-user.js/wiki), [stickies](https://github.com/ghacksuserjs/ghacks-user.js/issues?q=is%3Aissue+is%3Aopen+label%3A%22sticky+topic%22). [diffs](https://github.com/ghacksuserjs/ghacks-user.js/issues?q=is%3Aissue+label%3Adiffs)
2017-12-19 17:37:24 +00:00
2018-10-27 14:52:19 +00:00
### ![][b] acknowledgments
2020-08-14 09:01:14 +00:00
Literally thousands of sources, references and suggestions. Special mention to:
2017-04-02 06:14:01 +00:00
2018-12-10 19:26:17 +00:00
* [12bytes](https://12bytes.org/articles/tech/firefox/firefoxgecko-configuration-guide-for-privacy-and-performance-buffs)
2019-11-02 16:00:12 +00:00
* The 12bytes article now uses this user.js and supplements it with an additional JS hosted at [Codeberg](https://codeberg.org/12bytes.org/Firefox-user.js-supplement)
2017-04-02 06:14:01 +00:00
2018-10-28 15:58:47 +00:00
### ![][b] [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
2018-10-27 14:52:19 +00:00
[b]: /wikipiki/bullet01.png