Mail Tweak



Here is a list of the tweaks in version 1.0 of Mail Tweak for Thunderbird 3.

Tweaks marked with an asterisk * are enabled by default.
Tweaks marked with two asterisks ** are always enabled, and so they do not appear in Mail Tweak's Options/Preferences dialog.

Account Settings cleanup *

Cleans up the list of accounts in Account Settings, so that when you open Account Settings the current account is the only one expanded.

Account tools

Account management tools in Account Settings, in the Account Actions menu:

Address lines

When you write a message, this allows you to move the splitter at the top of the message body upwards to reduce the number of address lines, so you have more room for the message body.

Also sets the initial number of address lines to the value here.

Background color inheritance

When you reply to or forward a message that is displayed in the message pane or in its own window, your new message inherits the background color of the original.

Bcc by default

Makes Bcc (instead of To) the default for addresses in a new message.

Collected reply

Various changes to the way Thunderbird composes replies and sends messages.

When you select more than one message to reply to, this tweak composes a single message in reply to all the selected messages.

Optionally, to use Bcc in collected replies, so that the people you are replying to do not see each other's e-mail addresses, check the box: Use Bcc in collected replies

To reply to each message in turn, choose: Message – Reply to Each

This tweak sends all messages (not only replies) through your Outbox, so that the Write window closes immediately.

To watch a message being sent, choose: File – Send & Watch

Optionally, to retry sending automatically when sending fails, check the box: Retry until sent

Note that when this tweak is active, you cannot use your Outbox for other purposes in the usual way, because sending any message will send all the messages. To delay sending messages, choose File Offline Work Offline to take Thunderbird offline.

The retry delay is 120 seconds (two minutes) by default. To change the delay, set the preference extension.mailtweak.collect.delay to a number of seconds.

Column heading lock

Locks column headings so that the view sorting does not change if you click a heading accidentally.

When you really want to change the view sorting, hold down the Shift key while you click a column heading.

Command line quit **

Enables the command line switch -quit to close Thunderbird.

Compact from folder properties *

In the Folder Properties dialog, adds a Compact button and shows the unused space in the folder file as a percentage of its size on disk.

In a folder's context menu, disables the Compact choice when the folder is already compact.

Configuration menu *

Adds Tools – Configuration menu choices for direct access to directories and files used by Thunderbird.

Each menu choice opens a configuration directory or file using your operating system's default application, and displays its path in Thunderbird's status bar. The menu choices are:

Installation...Program installation directory
Profiles INI...Profile Manager data file
Current Profile...Current profile directory
Chrome CSS...CSS style rules for the user interface: userChrome.css
Content CSS...CSS style rules for message content: userContent.css


CSS selector

Identifies possible CSS selectors for elements in Thunderbird's user interface, to help in customizing Thunderbird's appearance.

In a Mail & Newsgroups window, choose CSS Selector... Then Shift+Click the element in Thunderbird's user interface that you want to identify.

For more information and examples, see: Mail Tweak CSS tweaks


Defers messages until a later time.

This feature can be used on messages you have received. Deferred messages disappear from your Inbox. At the specified time the messages reappear in your Inbox, marked unread and optionally tagged with a tag that you specify.

The feature can also be used on messages that you send, so that they are sent at the specified time.

For more detailed information, see: Defer

Deletion behavior

Specify what is selected after a message is deleted: nothing, the row above the deletion, or the row below the deletion. If the specified row does not exist, then nothing is selected.

Dialogs menu

Menu for more direct access to various dialogs. The dialogs are:

Connection SettingsFonts & EncodingsDownloadsPassword Managerabout:config
Offline SettingsSend OptionsJunk Mail LogCertificates
Items for Offline UseReturn ReceiptsUpdate HistoryRevocation Lists
SMTP Servers  Device Manager

Discard new message

Prevents the prompt when you close a message without saving it or sending it.

Disconnect when idle

Runs a script after Thunderbird has been idle for a number of seconds. You can use the script to disconnect, or for any other purpose.

To place Thunderbird in offline mode after running the script, check the box: Work offline

Activities that trigger the script include getting mail and sending unsent messages. Sending an individual message and working with Thunderbird's user interface do not trigger the script.

Place the script in your Thunderbird profile, or in Thunderbird's installation directory.

Extension options/preferences

Adds a page to the main Options/Preferences dialog where you can open extensions' Options dialogs.

Press Shift+PageUp or Shift+PageDown to switch pages. Press Ctrl+PageUp or Ctrl+PageDown to switch tabs on a page.

File picker guard *

Prevents attempts to open a file picker on a directory that does not exist, which can cause Thunderbird to hang as it waits for the network to time out.

Folder icons

Enables CSS style rules for named accounts or folders in the folders pane, allowing custom icons and other effects.

This is only an enabler. It has no effect by itself. To change the appearance of accounts or folders, you must write appropriate CSS style rules in your userChrome.css file.

For more information and examples, see: Mail Tweak CSS tweaks

Folder menus

Adds a Recent checkbox to folders' context menus, so that you can add or remove folders from your list of recently used folders.

Adds tooltips to the cycle buttons at the top of the folder pane, so you can see which views the buttons will show.

Optionally adds a Favorite menu to, or removes the Recent menu from, all Move To and Copy To menus.

Folder pane auto-hide

Automatically hides the folder pane.

To reveal the folder pane, move your mouse over the left edge of Thunderbird's main window.

Hide Local Folders

Hides the Local Folders account in the folders pane. (The account is still available in Account Settings and elsewhere.)

To display Local Folders temporarily, choose: View – Local Folders

Image defaults

Default settings for the Image Properties dialog in an HTML message, when you choose Insert Image...

This controls the defaults for the checkbox "Attach the image to the message", and for alternate text.

Insert menu

Adds an Insert Text file... menu choice so that you can import text from a file.

Also enables the Insert menu in the plain text editor, where the Characters and Symbols choice also works.

Keep a copy prompt

Asks you whether you want to keep a copy when you send a message. Choose Yes (default) to send the message and keep a copy, or No to send the message without keeping a copy, or Cancel to cancel sending. This allows you to send some messages without keeping a copy.

Also adds a menu choice: Options – Keep a Copy, which is checked by default when the current identity (From address) is set to keep copies of messages you send. Uncheck this menu choice to send the message without keeping a copy.

If you use this menu choice, or the Options – Send a Copy To menu choice, then there is no prompt when you send the message.

Message font

A simplified interface for setting the default message font family and size.

This tweak is designed for users who want a simple way to set the font in messages. If you need more complex settings, then do not use this tweak, because it can interfere with settings that are available in other parts of Thunderbird.

Content types

Set the message font separately for the two content types that Thunderbird supports: HTML and plain text.

For HTML, choose any font that you find easy to read.

For plain text, a monospaced font is best, because some plain text messages cannot be formatted correctly in other fonts. Monospaced fonts are also known as fixed pitch or fixed width.

Font family

A named font is known as a font family, because it usually provides a family of at least three font faces: normal, bold and italic.


The size is the nominal height of the font. To obtain the most accurate size, specify the size in pixels. A pixel is usually the smallest area or dot that your display can resolve.

Alternatively, you can specify a size in points. In theory, 72 points make one inch, but the conversion to pixels depends on your display settings.

Standardizes the labels and buttons in message header panes by capitalizing initial letters.

Message number

Adds a Message Number... choice to local mail folder context menus, so that you can select a message by its sequential number in the folder file.

This is intended to help you find a message reported as malicious by a "security" program. Note that a message stored in a Thunderbird folder cannot ever cause harm, as long as it remains in the folder. Even if you display the message in Thunderbird, it cannot cause harm. A malicious message can only cause harm if you yourself open its attached file.

A folder file may contain deleted messages, which you cannot see in Thunderbird. To remove these messages, compact the folder.

New mail account

Replaces the Mail Account Setup wizard with a simpler New Mail Account dialog, which does not try to guess the settings you require.

The dialog supports POP3, IMAP and Local accounts. A Local account cannot receive or send mail it is only for storing local mail folders.

Optionally specify an existing account of the same type as a template, so that most of its settings are copied to the new account.

Optionally check the box "No identity" to create an account that can only receive mail, not send mail.

Optionally check the box "No new SMTP server" when outgoing mail from your new account can use an existing SMTP server.

You will often need to customize your account in Account Settings, unless you have used an existing working account as a template. All the settings except the account type (POP3/IMAP/Local) can be changed later in Account Settings.

Offline options

Enables offline startup. Set this in the Offline Settings dialog: Tools Options Advanced Network & Disk Space Offline

Optionally resets servers when Thunderbird goes offline, forgetting cached passwords and closing connections. Stored passwords in the password manager are not affected.

Open folder

This tweak makes various changes to help you to work with many accounts or folders in separate windows.

In the folder pane, makes the Open action in an account's or folder's context menu collapse the rest of the new window's folder pane.

Makes double-click on an account or folder perform the Open action.

Displays internal URIs in the Account Settings and Folder Properties dialogs, so that you can copy them and paste them in command lines.

Note:  To open a folder in a new window from a command line, use the switch -mail followed by the internal URI of the account or folder. You can use this, for example, to make a desktop icon that opens a particular account. (THIS IS BROKEN IN THUNDERBIRD 3) For example:

thunderbird -mail mailbox://nobody@Local%20Folders/Inbox

Password display

NOT IMPLEMENTED YET: This tweak is disabled because of a bug that can cause stored passwords to be lost.

Controls the display of server password in the Account Settings and Password Manager dialogs.

To work with passwords in Account settings, check the box: Set passwords in Account Settings

To prevent the display of password in the user interface, check the box: Hide all passwords in the user interface   Note that this is not a security featuree — to secure your passwords, use a Master password.

Permanent pen

A permanent color and style for adding comments in replies.

Press the specified key or choose Format – Permanent Pen to enable or disable the pen. Look for an indicator in the formatting toolbar to show that the pen is enabled. The indicator is a colored line beside the existing color controls.

In Mail Tweak Options, specify the key, font face, size, color and style for your permanent pen.


Personalize messages

Sends each recipient an individual message, using data from your address book or a CSV file.

To use this feature, write a message by choosing: Message – Personalize...   You can address it to a list, or to individuals in your address book. Alternatively, select cards in your address book, then get a context menu (for example, by right-clicking a card) and choose: Personalize  

To use addresses from a CSV file, do not specify any addresses in the message.

To send the message, press the Personalize button or choose: File – Personalize   If the message has no recipients, then MailTweak prompts you to choose a CSV file that specifies the recipients.

MailTweak creates an individual copy of the message for each recipient, regardless of whether the recipient was originally specified using To:, Cc: or Bcc:. The messages are placed in your Unsent folder, so if you wish you can review them before sending them.

To include data from your address book or CSV file, specify fields in your message. For example, if you specify %%firstName%% then the actual message sent will have the recipient's first name in that position in the message.

The available address book field names are the properties listed here: nsIAbCard   Field names in a CSV file are as specified in the first line of the file, but with spaces changed to underscores. For example, if the CSV file specifies the field name First Name, then type %%First_Name%% (with an underscore) in the message.

You can specify a different field marker (default: %%).

By default each personalized message has a unique internal message ID. You can turn this off to send messages with the same internal message ID (but some mail systems might not be able to handle distinct messages that have the same ID).

In each record of a CSV file, the first field that contains an @ sign is taken to be the e-mail address. Alternatively, set the preference to the name of the field that contains the e-mail address, changing spaces in the name to underscores.

CSV files are taken to be in the platform charset by default. Alternatively, set the preference extension.mailtweak.personal.csv.charset to specify the charset of the CSV file.

Note:  In Templates and Drafts folders, the default action is Edit Message As New. To personalize a template or draft, choose: Message – Personalize As New...  

Restrictions:  The following restrictions apply in the current version. Future versions might have fewer restrictions:

Preferences cache

Backs up preference settings, including account settings, and restores them automatically if your accounts ever disappear.

This tweak is only a convenience. It is not a substitute for regular backups of all your data.

Save as web page **

Provides a menu choice File Save As Web page in main windows and message windows, to save the current message as a complete local web page. Images and other resources are saved as separate files.

Search windows

Allows multiple Search Messages windows and Advanced Address Book Search windows to be open at the same time.


Sends messages composed in HTML to be sent as HTML by default.

(Changes the default choice in the Options – Format menu.)

To send both plain text and HTML by default, check the box: Send both plain text and HTML

Send with no subject

Prevents the prompt when you send a message with an empty subject, and sets the subject to some specified text (which can be empty).

Splitter highlight *

Highlights the splitter between panes in a window when one of the panes is collapsed and the mouse pointer moves over the splitter, making it easier to find the splitter and drag it to open the collapsed pane.

Start page

A choice of built-in and remote start pages.

The MailTweak start page has a clock and calendar. You can use CSS to adjust their appearance (including the appearance of the analog clock) in a userContent.css file.

Status icons *

Adds icons in the status bar of the message window, showing the status of the message at the time you opened it.

The icons depend on the theme you are using. In the default theme on Windows they are:

Replied to
Replied to and forwarded

Note:  The icons might not be available in some themes—for example, themes based on earlier releases of Thunderbird.

Status message cache *

Displays each status message in the main window for a fixed time so you have time to read it.

Also keeps recent status messages. To review them, click on the status bar.

Note that when an operation generates many status messages, the operation might complete long before all the messages can be displayed. You do not have to wait for all the messages to be displayed before continuing with your work.

Tag numbering *

Numbers all your tags, not just 1 to 9.

To tag one or more selected messages, type a tag number.

In Mail Tweak Options, specify the delay to apply before a tag number takes effect, depending on how fast you type. For example, if you type 19 too slowly, then your messages will be tagged with tag 1 and tag 9 instead of tag 19.

Tag tools

Changes the interface for managing tags. Choose: Tools – Options... – Display – Tags   in the usual way.

To change the rank of tags, move them up or down the list. A message's highest-ranked tag is the tag used to set the message's color.

To share tags between profiles, either export and import them whenever you need to, or specify a pool. The pool is a file that Thunderbird reads from when it starts up, and writes to whenever you change the tag list.

Tree font

Sets the font size in the folder pane, thread pane and address book.

Themes and other customizations can override this setting.

Word count *

Counts words and characters when you are composing a message. To see the counts, select some text and look for the message in the status bar at the bottom of the Write window.

To count all the words and characters in the message, select all the text—for example by pressing: Ctrl+A

To see the count while you type the message, choose: View – Word count

The counts are approximate, because of the way the text in a message is encoded by the editor. Also, a message is encoded differently for transmission, so the character count does not tell you the size the message will be when you send it.


For questions or comments about Mail Tweak, please use this thread in the mozillaZine Extension/Theme Releases forum: Mail Tweak (for Thunderbird)

For questions or comments not about a specific project, please read our feedback page.
Copyright © 2004, 2008 All rights reserved. Terms of Use.