Thunderbird Custom CSS Repository

Welcome to the hub for customizing and enhancing your Thunderbird experience! We are dedicated to sharing everything from custom CSS snippets to themes and even fully developed tools that can enhance the Thunderbird experience. Whether you're looking to tweak colors, add new features, or create an entirely new theme, this is the place to start. If you are just here to use the tools, scripts, or resources but are unfamilliar with using custom CSS, see the explaination below. Otherwise if you have a particularly organized and functional personal custom CSS script, have developed a useful themeing tool, or a unique css snippet and are here to contribute. thank you! Read the details below to get started.

---

GitHub Page Rules

• Respect the Community: Constructive feedback is encouraged, but please be respectful to others.
• Document Your Changes: Ensure that all changes are well-documented, especially when creating or modifying CSS snippets.
• Test Before You Push: Always test your customizations locally before submitting a pull fork request.
• Use Descriptive Commit Messages: Commit messages should clearly describe the changes made.
• Add Images If Possible: Its hard to know if you'd like a theme or element without seeing it.

How to Pull and Make Changes

1. Fork the Repository: Start by forking this repository to create your own copy.
2. Clone Your Fork: Use git clone to clone your fork to your local machine.*
3. Create a New Branch: Use git checkout -b your-branch-name to create a new branch for your changes.
4. Make Your Changes: Edit or add CSS files in your local clone.
5. Commit Your Changes: Commit your changes with a clear and descriptive message.
6. Push to Your Fork: Push your branch to your GitHub fork using git push origin your-branch-name.
7. Open a Pull Request: Go to the original repository and open a pull request from your branch.

*If you dont use git/use git locally, feel free to update your fork however you like. I just ask that you are throurough with identifying and documenting changes so its easier to use and combine with other code if possible.

**One note to be mindful of - global variables declared in :root{} will apply to all instances of the style in which they are declared.

So if you declare a global variable that is commonly used such --blue it has a good chance to affect other chromium based applicatoins that allow custom css (Chrome/Edge).

You may or may not use these applicatoins or notice this, and if you do notice it, it may be a desired effect (such as in commit 1). Just be sure to document this so its easily removable for users who run into issues.

---

Introduction to Using CSS in Thunderbird

This section will guide you through customizing the appearance of Thunderbird using CSS. The provided code allows you to customize aspects of Thunderbird UI from simply changing colors to completely altering the look of your app. Follow these steps to apply your custom CSS:

1. Open Thunderbird and go to the "Help" menu.
2. Select "Troubleshooting Information."
3. In the "Application Basics" section, click on "Show Folder" to open the profile folder.
4. Create a folder named chrome if it doesn't exist.
5. Inside chrome, create a file named userChrome.css and paste your custom CSS.
6. Enable the customizations by setting toolkit.legacyUserProfileCustomizations.stylesheets to true in the about:config page.
7. Restart Thunderbird to apply the changes.

For more details, please refer to Mozilla's documentation on custom CSS.

---

Contributing

We welcome contributions from everyone! Whether you’re adding a new feature, tool, or script, fixing a bug, or improving documentation, your input is valued. Please follow the contribution guidelines outlined above.

Repository Home Page