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 (< 68) 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 using **Gmail**, please check [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 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

* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31p.htm)
* [Privacy Haters](http://r-36.net/scm/privacy-haters/file/README.md.html)
* [12bytes.org's user-overrides.js](https://codeberg.org/12bytes.org/thunderbird-user.js-supplement)
* ~~CHEF-KOCH/TBCK~~
Removes "gHacks" from the project title See <https://github.com/HorlogeSkynet/thunderbird-user.js/commit/d78aa86edea15d0d9d54dc83e25c423ccbc600ec#r36108350>. 2019-11-24 17:58:39 +00: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 10:59:26 +00:00
Updates README layout to reflect latest arkenfox design 2020-11-01 11:09:30 +00: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 10:59:26 +00:00
Updates README layout to reflect latest arkenfox design 2020-11-01 11:09:30 +00: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 10:59:26 +00:00
Some more README's blemish fixes 2020-03-23 13:54:57 +00: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-24 00:00:00 +00:00
Updates README layout to reflect latest arkenfox design 2020-11-01 11:09:30 +00: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 10:59:26 +00:00
Updates README layout to reflect latest arkenfox design 2020-11-01 11:09:30 +00: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 21:22:23 +00: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-24 00:00:00 +00:00
TorBirdy is actually not compatible against Thunderbird >= v68 > See <https://trac.torproject.org/projects/tor/ticket/31341> 2020-11-01 22:25:58 +00:00			`- If you're using Thunderbird (< 68) 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 using Gmail, please check [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).`
2019-11-24 00:00:00 +00: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 11:09:30 +00: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 10:59:26 +00:00
@tya99's account does not exist on GitHub anymore 2020-11-01 22:26:35 +00:00			`* @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`
2019-11-24 00:00:00 +00:00
Updates README layout to reflect latest arkenfox design 2020-11-01 11:09:30 +00:00			`### :blue_square: Related Projects`
Adds a "Related Projects" section in README 2020-03-23 13:53:05 +00:00
Merges some options and behavior from Privacy Handbuch project for v78 2020-11-01 21:57:55 +00:00			`* [Privacy Handbuch](https://www.privacy-handbuch.de/handbuch_31p.htm)`
Adds "Privacy Haters" as one more related project > The HTTP link has been set, as the website uses a self-signed certificate. 2020-11-03 19:45:51 +00:00			`* [Privacy Haters](http://r-36.net/scm/privacy-haters/file/README.md.html)`
Incorporates some prefs from 12bytes.org's user.js (related project too) (cc @atomGit) 2020-11-08 21:50:22 +00:00			`* [12bytes.org's user-overrides.js](https://codeberg.org/12bytes.org/thunderbird-user.js-supplement)`
Definitely removes link to CHEF-KOCH/TBCK in "related projects" list > See: <https://github.com/arkenfox/user.js/issues/323> 2020-11-07 20:05:24 +00:00			`* ~~CHEF-KOCH/TBCK~~`