thunderbird-user.js/README.md

# Thunderbird User.JS

> An ongoing comprehensive user.js template for configuring and hardening Thunderbird privacy, security and anti-fingerprinting

### :large_blue_diamond: user.js

An `user.js` is a configuration file that can control hundreds of Thunderbird settings.  
For a more technical breakdown and explanation, you can read more on the [overview](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/1.1-Overview) Wiki page.

### :large_blue_diamond: thunderbird user.js

The Thunderbird `user.js` is a **template** which aims to provide as much privacy and enhanced security as possible.  
It differs from the `ghacks user.js` in that the focus is to keep Thunderbird as an **email client** and disable as many web browsing features as possible. We believe web browsing should be done in a web browser, and not an email client.

- If you're using Thunderbird with Tor we suggest that you install the [TorBirdy](https://addons.thunderbird.net/addon/torbirdy) add-on. If you are using Tor, you should also consider using [Tails](https://tails.boum.org/) or [Whonix](https://www.whonix.org/).
- If you're a **Gmail** user see [this article about OAuth2](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/3.1-OAuth2-Users).
- For information about [extensions](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/4.1-Extensions), see the Wiki. **Calendar** users should [see this page](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/4.1.1-Calendar).

Also be aware that this `user.js` is made specifically for Thunderbird and has only been tested in the latest stable release.

### :large_blue_diamond: Acknowledgments

* [tya99](https://github.com/tya99) most of the ground work and initial port from the Firefox version of [ghacks user.js](https://github.com/ghacksuserjs/ghacks-user.js)
* [dngray](https://github.com/dngray) continual maintenance and Wiki
* [HorlogeSkynet](https://github.com/HorlogeSkynet) continual maintenance

### :large_blue_diamond: Related Projects

* [CHEF-KOCH/TBCK](https://github.com/CHEF-KOCH/TBCK)
* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31d.htm)

### :large_blue_diamond: [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
Removes "gHacks" from the project title See <https://github.com/HorlogeSkynet/thunderbird-user.js/commit/d78aa86edea15d0d9d54dc83e25c423ccbc600ec#r36108350>. 2019-11-24 12:58:39 -05:00			`# Thunderbird User.JS`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00
			`> An ongoing comprehensive user.js template for configuring and hardening Thunderbird privacy, security and anti-fingerprinting`

2019-11-23 19:00:00 -05:00			`### :large_blue_diamond: user.js`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00
Some more README's blemish fixes 2020-03-23 09:54:57 -04:00			An `user.js` is a configuration file that can control hundreds of Thunderbird settings.
			`For a more technical breakdown and explanation, you can read more on the [overview](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/1.1-Overview) Wiki page.`
2019-11-23 19:00:00 -05:00
			`### :large_blue_diamond: thunderbird user.js`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00
Some more README's blemish fixes 2020-03-23 09:54:57 -04:00			The Thunderbird `user.js` is a template which aims to provide as much privacy and enhanced security as possible.
			It differs from the `ghacks user.js` in that the focus is to keep Thunderbird as an email client and disable as many web browsing features as possible. We believe web browsing should be done in a web browser, and not an email client.
2019-11-23 19:00:00 -05:00
Fixes little blemish on README 2020-03-23 05:32:53 -04:00			`- If you're using Thunderbird with Tor we suggest that you install the [TorBirdy](https://addons.thunderbird.net/addon/torbirdy) add-on. If you are using Tor, you should also consider using [Tails](https://tails.boum.org/) or [Whonix](https://www.whonix.org/).`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00			`- If you're a Gmail user see [this article about OAuth2](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/3.1-OAuth2-Users).`
Fixes little blemish on README 2020-03-23 05:32:53 -04:00			`- For information about [extensions](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/4.1-Extensions), see the Wiki. Calendar users should [see this page](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki/4.1.1-Calendar).`
2019-11-23 19:00:00 -05:00
			Also be aware that this `user.js` is made specifically for Thunderbird and has only been tested in the latest stable release.

Adds a "Related Projects" section in README 2020-03-23 09:53:05 -04:00			`### :large_blue_diamond: Acknowledgments`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00
2019-11-23 19:00:00 -05:00			`* [tya99](https://github.com/tya99) most of the ground work and initial port from the Firefox version of [ghacks user.js](https://github.com/ghacksuserjs/ghacks-user.js)`
			`* [dngray](https://github.com/dngray) continual maintenance and Wiki`
Project take over ! * First changes for v68.0 Thunderbird version * Adds CI to automatically lint the `user.js` script * Updates links due to repository transfer 2019-11-24 05:59:26 -05:00			`* [HorlogeSkynet](https://github.com/HorlogeSkynet) continual maintenance`
2019-11-23 19:00:00 -05:00
Adds a "Related Projects" section in README 2020-03-23 09:53:05 -04:00			`### :large_blue_diamond: Related Projects`

			`* [CHEF-KOCH/TBCK](https://github.com/CHEF-KOCH/TBCK)`
			`* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31d.htm)`

2019-11-23 19:00:00 -05:00			`### :large_blue_diamond: [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)`