thunderbird-user.js/README.md

# Thunderbird User.JS

> Thunderbird privacy, security and anti-fingerprinting: a comprehensive user.js template for configuration and hardening

### :purple_square: 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.

### :green_square: Thunderbird user.js

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

The `thunderbird user.js` is a **template** which aims to provide as much privacy and enhanced security as possible.  
It differs from the `arkenfox 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.

### :orange_square: Sitemap

- [Releases](https://github.com/HorlogeSkynet/thunderbird-user.js/releases)
- [Issues](https://github.com/HorlogeSkynet/thunderbird-user.js/issues)
- [Wiki](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki)

### :red_square: Acknowledgments

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

### :blue_square: Related Projects

* [CHEF-KOCH/TBCK](https://github.com/CHEF-KOCH/TBCK)
* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31d.htm)
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
Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`> Thunderbird privacy, security and anti-fingerprinting: a comprehensive user.js template for configuration and hardening`
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
Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`### :purple_square: 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
Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`### :green_square: 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
Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)`

			The `thunderbird user.js` is a template which aims to provide as much privacy and enhanced security as possible.
Replaces gHacks occurrences by arkenfox (see arkenfox/user.js#1009) 2020-10-31 17:22:23 -04:00			It differs from the `arkenfox 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.

Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`### :orange_square: Sitemap`

			`- [Releases](https://github.com/HorlogeSkynet/thunderbird-user.js/releases)`
			`- [Issues](https://github.com/HorlogeSkynet/thunderbird-user.js/issues)`
			`- [Wiki](https://github.com/HorlogeSkynet/thunderbird-user.js/wiki)`

			`### :red_square: 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
Replaces gHacks occurrences by arkenfox (see arkenfox/user.js#1009) 2020-10-31 17:22:23 -04:00			`* [tya99](https://github.com/tya99) most of the ground work and initial port from the Firefox version of [arkenfox user.js](https://github.com/arkenfox/user.js)`
2019-11-23 19:00:00 -05:00			`* [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
Updates README layout to reflect latest arkenfox design 2020-11-01 06:09:30 -05:00			`### :blue_square: Related Projects`
Adds a "Related Projects" section in README 2020-03-23 09:53:05 -04:00
			`* [CHEF-KOCH/TBCK](https://github.com/CHEF-KOCH/TBCK)`
			`* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31d.htm)`