now is the time to forget the whimpering child, become the warrior
9.2. Manually editing the preferences
Manual editing of preferences are intended for advanced users only. Enigmail preferences are stored together with Mozilla global preferences inside the user.js and prefs.js files in your profile directory. Mozilla first reads the preferences in user.js, if this file exists, and copies them in prefs.js. You can create the file user.js in order to keep your custom preferences that you do not wish to be ever changed; this file, unlike prefs.js, won't be modified by Mozilla. The preferences are accessible in SeaMonkey by opening the URL about:config, and in Thunderbird under Tools → Preferences → Advanced → General → Config Editor. From there, you can change the preferences values, which will then be written in prefs.js under the following format: user_pref("preference_name",value); This section provides a reference in alphabetical order to the various Enigmail preferences. First is printed the preference name and its default value; then follows its meaning, and the relevant menu command if the preference can also be set from the GUI. You can review the default preferences settings in the enigmail.jsfile.
| extensions.enigmail.addHeaders | true |
Adds custom X-Enigmail mail headers to all outgoing messages. These headers are not currently used for any function, but may be used by Enigmail in the future. Currently the added headers are: X-Enigmail-Version: 0.96.0.0 (or whatever) X-Enigmail-Supports: pgp-inline, pgp-mime |
|
| extensions.enigmail.advancedUser | false |
| Shows the advanced settings. OpenPGP → Preferences → Display Expert Settings / Hide Expert Settings | |
| extensions.enigmail.agentPath | "" |
| The path to the GnuPG executable. If it is already in the PATH, this setting can be left blank. OpenPGP → Preferences → Files and Directories | |
| extensions.enigmail.allowEmptySubject | false |
| Allows the user to send a mail with no subject. OpenPGP → Preferences → Sending → Don't warn about empty subject line | |
| extensions.enigmail.alwaysTrustSend | true |
| Always trust other people's keys when sending. Default is on. OpenPGP → Preferences → Sending → Always trust people's keys | |
| extensions.enigmail.autoCrypto | false |
| Reserved for future use; do not change this setting. | |
| extensions.enigmail.autoDecrypt | true |
| Automatically decrypt/verify received messages. OpenPGP → Automatically Decrypt/Verify Messages | |
| extensions.enigmail.autoKeyRetrieve | "" |
| Keyserver to automatically download public keys from. As default, no keyserver is specified. OpenPGP → Preferences → Keyserver → Automatically download keys for signature verification from the following keyserver: | |
| extensions.enigmail.composeHtmlAlertcount | 3 |
| Sets the number of times a warning message is shown when composing in HTML and attempting to send a signed message using inline PGP. | |
| extensions.enigmail.configuredVersion | "" |
| The last configured Enigmail version. This setting should not be changed. | |
| extensions.enigmail.confirmBeforeSend | false |
| Pops up the confirmation dialog before sending a message. OpenPGP → Preferences → Sending → Always confirm before sending | |
| extensions.enigmail.disableSMIMEui | false |
| Disables the S/MIME button (only for SeaMonkey). OpenPGP → Preferences → Advanced → Hide SMIME buttons/menus | |
| extensions.enigmail.displayPartiallySigned | true |
| Handles the display of the OpenPGP status bar if only part of the message is signed (this may happen for instance when a person replies quoting a signed message). An example of a partly signed message is shown in the figure at page 58. If set to false, PGP headers that appear within the message body will be ignored and displayed literally. This does not apply for the PGP headers at the beginning and the end of the message body, which are present there when the message is normally signed in full; in this case, the OpenPGP status bar will appear. If set to true (default), Enigmail even removes the quote prefix character ( > ) from signed text embedded in the rest of the body if the message itself as a whole is not signed. This only works if the embedded quote has not been modified at all. | |
| extensions.enigmail.displaySecondaryUid | true |
| Forces Enigmail to search your keyring for secondary IDs in order to match the sender address of a received message, and displays it instead of the default key ID. | |
| extensions.enigmail.displaySignWarn | true |
| Warns when you change the signing status by clicking on the sign icon in the bottom right corner of the message composition window. | |
| extensions.enigmail.doubledashSeparator | true |
| Handles the double dash (--) as a signature separator.. OpenPGP → Preferences → Advanced → '--' is a signature separator | |
| extensions.enigmail.encryptAttachments | 1 |
| This setting stores the value of the last encryption method used to send a message with attachment. | |
| extensions.enigmail.encryptAttachmentsSkipDlg | 0 |
| Controls whether to skip the attachment dialog, where the user is asked how attachments should be encrypted/signed. | |
| extensions.enigmail.encryptToNews | false |
| If set to false (default), won't allow user to send an encrypted message to a newsgroup. | |
| extensions.enigmail.encryptToSelf | true |
| Automatically encrypts outgoing messages with your public key too. OpenPGP → Preferences → Sending → Add my own key to the recipients list | |
| extensions.enigmail.gpgVersionWarncount | 1 |
| Warns if the installed version of GnuPG is less than v1.0.6, which is the minimum version Enigmail can work with. | |
| extensions.enigmail.handleDoubleClick | true |
| Normally, to decrypt and open an encrypted attachment you right-click on it and select Decrypt and Open from the pop-up menu. This option enables automatic decryption and opening if you double-click on the attachment. | |
| extensions.enigmail.hideHeaders | x-enigmail-version openpgp content-transfer-encoding x-mimeole x-bugzilla-reason x-php-bug |
| Specifies the mail headers that must be retrieved from the mail backend, but hidden to users. This preference exists only in Enigmail v0.96.0 and earlier. | |
| extensions.enigmail.hushMailSupport | false |
| Enables support for Hushmail. OpenPGP → Preferences → Advanced → Use '<' and '>' to specify email addresses | |
| extensions.enigmail.initAlert | true |
| Displays a warning if Enigmime fails to initialize. | |
| extensions.enigmail.inlineAttachAsciiArmor | false |
| Encrypts attachments in ASCII-armored format (GnuPG parameter -a) when sending inline PGP encrypted messages. | |
| extensions.enigmail.inlineAttachExt | ".pgp" |
Sets the extension to be appended when creating attachments to inline PGP encrypted messages. Default is .pgp (i.e. a file filename.ext will be renamed to filename.ext.pgp when encrypted). |
|
| extensions.enigmail.inlineSigAttachExt | ".sig" |
| Enables encryption of replies to encrypted messages. OpenPGP → Preferences → Advanced → Encrypt replies to encrypted message | |
| extensions.enigmail.keepSettingsForReply | true |
| Enables encryption of replies to encrypted messages. OpenPGP → Preferences → Advanced → Encrypt replies to encrypted message | |
| extensions.enigmail.keyManShowAllKeys | false |
| If set to false (default), the Key Management window shows only those keys that match the search terms entered in the field Search for. If set to true, all keys are displayed. OpenPGP → Key Management → Display All Keys by Default | |
| extensions.enigmail.keyserver | "pool.sks-keyservers.net, subkeys.pgp.net, pgp.mit.edu, ldap://certserver.pgp.com" |
| The list of keyservers to use. OpenPGP → Preferences → Keyserver → Specify your keyserver(s) | |
| extensions.enigmail.logDirectory | "" |
| Specifies the log directory. If set, also enables debugging. Default is empty (unset). OpenPGP → Preferences → Debugging → Log directory | |
| extensions.enigmail.maxIdleMinutes | 5 |
| Caches the passphrase for the specified time. Default is 5 minutes. OpenPGP → Preferences → Remember passphrase for [ ] minutes of idle time | |
| extensions.enigmail.mimeHashAlgorithm | 0 |
|
GnuPG hash algorithm to use. Available values are: 0 – automatic selection, let GnuPG choose (default) 1 – SHA1 2 – RIPEMD160 3 – SHA256 4 – SHA384 5 – SHA512 |
|
| extensions.enigmail.noPassphrase | false |
| Tells Enigmail to never ask for a passphrase. OpenPGP → Preferences → Basic → Never ask for any passphrase | |
| extensions.enigmail.parseAllHeaders | true |
| Tells Enigmail to parse all MIME headers in the message. This value is for testing purposes only, and must be left enabled. | |
| extensions.enigmail.quotedPrintableWarn | 0 |
| Issues a warning when Enigmail detects that a message going to be sent contains 8-bit characters and will use Quoted Printable encoding. Default is off. This setting remembers the selected state. | |
| extensions.enigmail.recipientsSelection | 2 |
| Controls how Enigmail should select the keys for unknown recipients of encrypted messages. Available values are: 1 – by per-recipient rules only 2 – by per-recipient rules and email address (default) 3 – by email address only 4 – manually, by prompting the user 5 – no key selection OpenPGP → Preferences → Key Selection |
|
| extensions.enigmail.respectHttpProxy | true |
| Uses the same HTTP proxy settings that were defined in Thunderbird / SeaMonkey to retrieve keys from keyservers. | |
| extensions.enigmail.saveEncrypted | true |
| If this setting is on, when composing a message that is going to be sent encrypted, if you save it as a draft Enigmail asks if you would like to encrypt the draft. Default is on. This setting remembers the selected state. | |
| extensions.enigmail.supportMultiPass | false |
| Support for multiple passphrase on the same key pair. Reserved for future use; do not change this setting. | |
| extensions.enigmail.useDefaultComment | false |
| If set to false (default), adds an Enigmail comment in OpenPGP signature. OpenPGP → Preferences → Advanced → Add Enigmail comment in OpenPGP signature | |
| extensions.enigmail.useGpgAgent | false |
| Use gpg-agent to handle passphrases. OpenPGP → Preferences → Advanced → Use gpg-agent for passphrases | |
| extensions.enigmail.useGpgKeysTool | true |
| Enables Enigmail to use the gpgkeys_hkp, gpgkeys_ldap, and gpgkeys_http tools to retrieve keys from keyservers without using gpg itself. | |
| extensions.enigmail.warnClearPassphrase | true |
| Has Enigmail pop up a confirmation message informing you that the passphrase has been cleared. | |
| extensions.enigmail.warnGpgAgentAndIdleTime | true |
| Warns if gpg-agent is found and the setting Remember passphrase for [ ] minutes of idle time is active. | |
| extensions.enigmail.warniso2022jp | true |
| Displays a warning if the broken character set ISO-2022-JP is used. This setting remembers the selected state. | |
| extensions.enigmail.warnOnrulesConflict | 0 |
| Issues a warning when sending a message to multiple addresses with conflicting per-recipient rules. Default is off. This setting remembers the selected state. | |
| extensions.enigmail.warnOnSendingNewsgroups | true |
| Issues a warning when trying to send an encrypted message to a newsgroup. | |
| extensions.enigmail.warnRefreshAll | true |
| Displays a warning when all keys are going to be refreshed. | |
| extensions.enigmail.wrapHtmlBeforeSend | true |
| Re-wrap HTML text in signed messages before sending. Default is on. OpenPGP → Preferences → Sending → Re-wrap signed HTML text before sending | |
| mail.identity.default.enablePgp mail.identity.default.pgpkeyId mail.identity.default.pgpKeyMode mail.identity.default.pgpSignPlain mail.identity.default.pgpSignEncrypted mail.identity.default.defaultEncryptionPolicy mail.identity.default.openPgpHeaderMode mail.identity.default.openPgpUrlName mail.identity.default.pgpMimeMode mail.identity.default.attachPgpKey | false "" 0 false false 0 0 "" false false |
| Preferences for per-identity settings. | |