Files and folders in the profile

From MZLAZine
Jump to navigation Jump to search

This article is a supplement to Profile folder - Thunderbird and provides more detail about files in the Thunderbird profile folder.

The profile folder contains many files and folders. Most are described below, but you may see a few strange files which are probably either due to an add-on or this article not being updated yet. However, if you see a directory name of places.sqlite-wal or places.sqlite-shm then you have a bug which causes severe performance problems.

Files[edit]

None of these files should be read-only. If any are read-only it might be a side effect of having put files on removable media, and then copying them or restoring them back to your profile.

Name Status Description .autoreg Temporary empty file that signals a change in the installed extensions. .parentlock (Mac OS X) See parent.lock abook.mab Personal Address Book

addons.json

Used by add-ons manager.

addons.sqlite

Obsolete. Used by add-ons manager.

blist.sqlite

Suspect it is used with the blocking list

blocklist.xml

Added list of dangerous extensions. Replaced by kinto.sqlite around version 60.

cache.sqlite

Used by the Lightning add-on if the "Cache" option is enabled in the calendar properties, to provide offline support. [1]

cert8.db

Obsolete. Used for Security certificates. It works together with key3.db, and should be copied together.

cert9.db

New file used for Security certificates. It works together with key4.db, and should be copied together.

cert_override.txt

This is an optional file used to store a security exception. It appears to store the host name , thus preventing you from creating a security exception for a rotating SMTP server.

chromeappsstore.sqlite

Unknown. There is a similar file in Firefox profiles used by localstorage/DOMStorage to store about: pages. [2]

compatibility.ini

Stores the version and path of the application this profile was last used with. When the profile is loaded with an application with a different version/path, the XPCOM components registration process is triggered. Thunderbird 3.x appears to use the version information to decide whether to display additional tabs such as the migration assistant and whats new. This file is automatically generated and can safely be deleted.

components.ini

Obsolete. Lists extension folders with XPCOM components. Replaced with extensions.ini in Thunderbird 1.5 and above.

compreg.dat

Lists registered XPCOM components. Automatically regenerated whenever XPCOM registration process is triggered.

content-prefs.sqlite

The permissions.sqlite and content-prefs.sqlite files store the permissions for what what remote content can be displayed. This used to be stored in the address book.

custom-strings.txt in chrome
(does not exist by default)

It can be used to replace text in the user interface. [3]

cookies.txt

Obsolete. Cookies RSS cookies - Thunderbird

cookies.sqlite

Stores all cookies.

cookies.sqlite-journal

Journal file for cookies.sqlite

cookies.sqlite-shm , cookies.sqlite-wal

write-ahead log files for cookies.sqlite

deleted.sqlite in calendar-data

Used by Lightning add-on. No information on what its used for.

directoryTree.json

downloads.rdf

Download history. Can be deleted to resolve slow downloads or program hangs (Bug 159107)

downloads.sqlite

Download history. Replaced downloads.rdf in version 3.

extensions.cache

Obsolete. Lists installed extensions, their IDs, and the folders they are installed to, along with their last-modify time. It is used, for example, to register extensions installed by dropping a folder into one of known install locations. This file is automatically regenerated and can be deleted to resolve various issues.

extensions.ini

Lists folders of installed extensions and themes. The file is automatically generated by nsExtensionManager and is used by low-level code to detect chrome packages and XPCOM components provided by installed addons. It can be safely deleted to resolve various issues.

extensions.log

Records some errors reported by the Extension Manager.

extensions.rdf

Obsolete. Installed extension information. It can be deleted to remove "ghost" entries from the extension list [4] and to resolve various other issues.

extensions.sqlite

Obsolete. Stores data about installed extensions, not clear yet if it replaces or supplements the extensions.rdf file.

feeds.rdf

Stores your RSS subscriptions. Its in in the Mail\feeds directory

feeditems.rdf

Records RSS feeds. Its in in the Mail\feeds directory

filterlog.html

Message filter log. If filter logging is enabled its stored in the accounts directory.

foldertree.json

Used by the folder pane.

formhistory.sqlite

global-messages-db.journal

rollback transaction journal for global-messages-db.sqlite (temporary file)

global-messages-db.sqlite

An index of all of your messages created by the global search engine (gloda). Can be deleted if db is corrupt or search isn't working correctly - it will be rebuilt.

history.mab

Collected addresses address book

hostinfo.dat in News

Contains all the newsgroups available for the current server

junklog.html

Junk mail log for that account

key3.db

Obsolete. Key database. Works together with cert8.db, and should be copied together.

key4.db

New file used for the Key database. Works together with cert9.db, and should be copied together.

kinto.sqlite

Kinto is a JSON storage service that stores blocklists. It replaces blocklist.xml . [5] [6]

lightweighttheme-footer, lightweighttheme-header

Optional. Created if you install a persona (light weight themes).

localstore.rdf

Obsolete. Replaced by xulstore.json in one of the updates to version 38. It stores the toolbar, window layout and size/position settings. It can be safely deleted to resolve various issues.

localstore-safe.rdf

Special version of localstore.rdf used in Safe Mode to set toolbars and window customizations to defaults. [7]

local.sqlite in calendar-data

Internal calendar data (in SQLite format) if you use the Lightning extension.

lock (Linux)

See parent.lock

logins.json

Stores encrypted passwords, and requires key4.db and cert9.db to work. Replaces signons.sqlite, which had replaced signons.txt.

mailviews.dat

Defines your current message view (you can customize it)

menuedit.rdf

Used by Menu Editor extension

mimeTypes.rdf

Action to perform when downloading certain types of files. Can be deleted to reset download actions.

msgFilterRules.dat in ImapMail, Mail, News

Message filters

nstmp

Thunderbird creates a nstmp temporary file when compacting a folder. You should not see it (or nstmp-1, nstmp-2 etc.) unless Thunderbird was interrupted while compacting.

panacea.dat

Mail folder cache of recent folders and visited links. It is also used to store the move-to recent history. It can be safely deleted to resolve various issues. A corrupt version can cause messages in offline folders to be lost. [8].

parent.lock (Windows)

Marker showing that the current profile is in use. Can be deleted to unlock the profile.

persdict.dat

Personal spelling dictionary

permissions.sqlite

The permissions.sqlite and content-prefs.sqlite files store the permissions for what remote content can be displayed. Lightning also uses that file.

pkcs11.txt

Security module database. cert8.db, key3.db, and secmod.db were replaced by cert9.db, key4.db, and pkcs11.txt. There have been several reports of passwords not being saved when upgrading to version 60.2.1 that were solved by deleting the pkcs11.txt file. [9]

places.sqlite

A SQLite database used to store annotations, bookmarks, favicons, input history, keywords, and browsing history. Thunderbird appears to use it mainly to record what links you clicked on in mail messages.

places.sqlite-shm, places.sqlite.wal

Write-ahead log files for places.sqlite. You should not have a places.sqlite-shm and a places.sqlite.wal directory (instead of files with that name). If you do that causes Thunderbird to be extremely slow. Its not clear what creates them, but the workaround is to delete those two directories. [10]

popstate.dat in Mail

Keeps track of which messages have been left on the POP3 server

prefs.js

All preferences, including account settings and mail folder locations. See: Modify Thunderbird settings

pubring.gpg

Public keys (yours and any you collected) for the Enigmail (OpenPGP) extension.

revocations.txt

rulesbackup.dat

If msgFilterRules.dat can't be read it backs it up in that file and creates a new msgFilterRules.dat.

search.json

Not clear what it is since there is no search.sqlite to cache. [11]

search.json.mozlz4

A compressed file used to store the list of search providers (OpenSearch). It is not editable. You need to install a search provider add-on and delete the old copy of this file to add a search provider. When restarted Thunderbird will build a new copy of the file. You can no longer add a search provider (such as Google or DuckDuckGo) by just adding a XML file to the searchplugins directory in the profile due to support for that being removed in the Mozilla toolkit. There is a patch to Thunderbird being developed to restore that feature. [12] [13]

secmod.db

Obsolete. Security module database. cert8.db, key3.db, and secmod.db were replaced by cert9.db, key4.db, and pkcs11.txt.

secring.gpg

Private keys for the Enigmail (OpenPGP) extension.

session.json

Default windows layout. This includes data on what tabs are open. Thunderbird (3.0 and later) deletes this file after reading the settings. Its re-created and the layout saved when Thunderbird terminates normally.

sessionCheckpoints.json

Signons.sqlite

Obsolete. Replaced by logins.json. It stores encrypted saved passwords, and requires key3.db and cert8.db to work. If you delete it, also delete key3.db and cert8.db. Thunderbird used to use signons.txt or signons3.txt.

SiteSecurityServiceState.txt

storage.sdb

Internal calendar data (in SQLite format) if you use the Lightning extension. Its been replaced by local.sqlite but is still maintained for compatibility in case you switch between different Thunderbird+Lightning versions.

times.json

training.dat

Custom training for Junk Mail Controls

traits.dat

Bayes traits training data used by the TaQuilla add-on

tmprules.dat

Temporary file used when modifying message filters.

Unsent Messages.

The "Unsent Messages." mbox file in ..\Mail\Local Folders is displayed as the Outbox folder by recent versions of Thunderbird. That folder is used to queue unsent messages if you use "Send Later".

urlclassifier2.sqlite

Obsolete. Contains information on known phishing sites.

urlclassifier3.sqlite

Contains information on known phishing sites. Seems to be a replacement for urlclassifier2.sqlite, which replaced urlclassifier.sqlite.

user.js
(does not exist by default)

User-set, overrides the preferences in prefs.js

userChrome.css in chrome
(does not exist by default)

User-set CSS to change the way the application looks

userContent.css in chrome
(does not exist by default)

User-set CSS to change the way webpages look

userChrome.js in chrome
(does not exist by default)

User-set JavaScript to change the way the application works

virtualfolders.dat

Saved Search folder settings

webappsstore.sqlite, webappsstore.sqlite-shm, webappsstore.sqlite-wal

Contains DOM storage data. Its used similar to cookies by web sites.

xpti.dat

Obsolete. Lists registered XPCOM interfaces. Automatically regenerated whenever XPCOM registration process is triggered.

XPC.mfl

Obsolete. A cache file for components (XPC)

xul.mfasl (Linux)

Obsolete. See XUL.mfl file

XUL.mfl (Windows)

Obsolete. Cached user interface data. Can be deleted to resolve various issues.
File location changed in Thunderbird 1.5. [14]

XUL FastLoad File (Mac OS X)

Obsolete. See XUL.mfl

xulstore.json

Toolbar, window layout and size/position settings. It can be safely deleted to resolve various issues.

Files without specific names[edit]

Name Status Description
(number).s Obsolete. It used to be used for saving passwords. The "(number).s" value was specified by the signon.SignonFileName preference.
* in ImapMail, Mail, and News (no file extension) Mbox files. They are text files that contain all of the messages for that folder. They are named after the folder, but have no file extension. "inbox." is a mbox file for the inbox folder.
*.mab other than abook.mab and history.mab User-created or imported address books.
*.msf in ImapMail, Mail, and News Index files for mail messages. They contain a cache of the folder listing plus a few folder specific settings.
*.mozeml Each file is a partial copy (up to 20kb) of a message in the mail folder, stored in a .mozmsgs subdirectory. It is used by the optional Spotlight Integration component under OSX. It's deleted when the message in the mbox is deleted. [15]
*.rc in News Subscribed groups.
*.tha The MoreFunctionsForAddressBook add-on uses this file extension for contacts.
*.thm The MoreFunctionsForAddressBook add-on uses this file extension for mailing lists.
*.wdseml Each file is a partial copy (up to 49KB) of a message in the mail folder, stored in a .mozmsgs subdirectory. It is used by Windows Search Integration (requires Vista or a later version of Windows). They're actually renamed .eml files. You can disable this feature by unchecking Tools -> Options -> Advanced -> General -> System Integration -> "Allow Windows Search to search messages". [16][17]
*.xpi in Extensions .xpi files are renamed .zip files used by add-ons. Usually they're unzipped and the files stored in a child directory (its name is the GUID that uniquely identifies that add-on) when the add-on is installed but some (such as IgnoreAero and Add-on Compatibility Reporter) aren't.

Files outside the profile folder[edit]

Name Description
application.ini The installation directory has an application.ini file with general information about what build you are using and additional entries that control whether the profile manager and extension manager are enabled.
custom-strings.txt File in the chrome subdirectory in the programs installations directory used to replace strings. [18] [19]
MozillaMailnews Directory in the systems temporary files directory.
nsmail.eml, nsmail.tmp, nsmail.html Temporary files created in MozillaMailnews when sending a message. If you get an error message about being unable to open the temp file nsmail.tmp when sending a message try re-configuring your anti-virus program not to scan email messages.
Updates

C:\Users\user_name\AppData\Local\Thunderbird\updates is the directory used to store updates when upgrading under Windows 10. This is not the same directory tree as %APPDATA%. The directory has one or more child directories whose name is a 16 hexadecimal digit string (a GUID). Each of those child directories is for a separate channel (release, beta, daily etc.) and has a updates child directory plus a "updates.xml" and a "active-update.xml" file. If an update gets caught in a loop you can break the cycle by deleting the appropriate "updates.xml" file and its child directories. However, its usually easier to just delete the entire ..\Thunderbird\updates directory. So far Thunderbird re-creates that directory as necessary if its missing. Similar directories are created for other operating systems.

omni.ja It contains most of the default preference files that used to be stored in in the defaults\pref subdirectory in the Thunderbird program directory such as mailnews.js and all-thunderbird.js. Its in the root of the program directory. Its contents can be viewed using any program that knows how to open a .zip archive file. It used to be called omni.jar but was renamed because WindowΓÇÖs System Restore does not backup .jar files. [20]
pluginreg.dat Registration of plugin MIME types. It's located in the "Thunderbird" directory containing the profiles.
profiles.ini Keeps track of the profile folder location. It's located in the "Thunderbird" directory containing the profiles. It can be edited to point to a moved profile folder. If deleted, profiles.ini will be regenerated along with a new default profile folder upon program restart.
registry.dat Obsolete. Keeps track of profile folder location in previous Thunderbird versions. It's located in the "Thunderbird" directory containing the profiles.

You can store messages outside of the profile by changing the "Local directory" in Account Settings -> Server Settings to a directory outside of the profile. If you want to do that you must move the existing files from the old local directory to the new location yourself because the modifying settings only tells Thunderbird where to look for the files. Be careful about changing this location:

  1. Some locations can be bad, including those which are dangerous that Thunderbird will automatically prevent.
  2. Make sure you backup the directory, because programs designed to back up Thunderbird or mozilla profiles will not backup folders that are outside the profile structure.
  3. Think about whether you want to set a folder exclusion for the new location in your anti-virus and anti-malware programs if they normally don't scan your profile.

Other[edit]

The layout engine (Gecko) has a Javascript cache, which is not automatically cleared when Thunderbird is restarted. This can prevent a script change from taking effect when you restart Thunderbird. To clear the cache when restarting, add a -purgecaches command line argument.

Profiles