Thunderbird-115.5.1

Introduction to Thunderbird

Thunderbird is a stand-alone mail/news client based on the Mozilla codebase. It uses the Gecko rendering engine to enable it to display and compose HTML emails.

[Note]

Note

Development versions of BLFS may not build or run some packages properly if LFS or dependencies have been updated since the most recent stable versions of the books.

Package Information

Thunderbird Dependencies

Required

Cbindgen-0.26.0, dbus-glib-0.112, GTK+-3.24.38, LLVM-17.0.1 including clang, nodejs-20.10.0, PulseAudio-16.1 (or alsa-lib-1.2.10 if you edit the mozconfig; although it is now deprecated by mozilla), Python-3.12.0 (rebuilt with the sqlite module), six-1.16.0, startup-notification-0.12, and UnZip-6.0

Recommended

[Note]

Note

If you don't install recommended dependencies, then internal copies of those packages will be used. They might be tested to work, but they can be out of date or contain security holes.

Optional

pciutils-3.10.0 (runtime), Wget-1.21.4, Wireless Tools-29, and watchman

Editor Notes: https://wiki.linuxfromscratch.org/blfs/wiki/Thunderbird

Installation of Thunderbird

[Note]

Note

The build process for Thunderbird can use 8GB+ of RAM when linking. Make sure that you have adequate swap or RAM before continuing.

The building system ships several internal copies of the Python 3 modules setuptools and six.py. The shipped copies are too old to work well with Python 3.12 or later. Replace them with the symlinks to the LFS setuptools package and six-1.16.0 already installed on the system, and adapt the building system for these updated Python modules. We also need to rewrite the code based on the imp module removed in Python 3.12 and later using the importlib module:

(for i in $(find -name six.py); do
   ln -sfv /usr/lib/python3.12/site-packages/six.py $i
   [ $? = 0 ] || exit $?
 done) &&

sed '/ConfigParser/s/Safe//'                          \
    -i testing/mozbase/mozprofile/mozprofile/prefs.py &&

(for i in setuptools distutils-precedence.pth  \
          pkg_resources _distutils_hack; do
   rm -rf third_party/python/setuptools/$i     &&
   ln -sv /usr/lib/python3.12/site-packages/$i \
          third_party/python/setuptools
   [ $? = 0 ] || exit $?
 done) &&

sed 's/distutils/setuptools._&/'            \
    -i python/mozbuild/mozbuild/nodeutil.py &&

sed -e '/^import/s/imp$/importlib.util/'             \
    -e 's/imp.new_module/__import__/'                \
    -e "s/imp.load_source\(.*\)/spec =               \
        importlib.util.spec_from_file_location\1;    \
        mod = importlib.util.module_from_spec(spec); \
        spec.loader.exec_module(mod)/" -i python/mach/mach/main.py &&
sed '/import imp/d' -i netwerk/dns/prepare_tlds.py

The configuration of Thunderbird is accomplished by creating a mozconfig file containing the desired configuration options. A default mozconfig is created below. To see the entire list of available configuration options (and a brief description of each), issue ./mach configure -- --help | less. Create the file with the following command:

cat > mozconfig << "EOF"
# If you have a multicore machine, all cores will be used.

# If you have installed wireless-tools comment out this line:
ac_add_options --disable-necko-wifi

# Uncomment the following option if you have not installed PulseAudio
#ac_add_options --enable-audio-backends=alsa

# Comment out following options if you have not installed
# recommended dependencies:
ac_add_options --with-system-libevent
ac_add_options --with-system-libvpx
ac_add_options --with-system-nspr
ac_add_options --with-system-nss
ac_add_options --with-system-webp

# on some machines. It is supposed to improve startup time and it shrinks
# libxul.so by a few MB.  With recent Binutils releases the linker already
# supports a much safer and generic way for this.
ac_add_options --disable-elf-hack
export LDFLAGS="$LDFLAGS -Wl,-z,pack-relative-relocs"

# The BLFS editors recommend not changing anything below this line:
ac_add_options --prefix=/usr
ac_add_options --enable-application=comm/mail

ac_add_options --disable-crashreporter
ac_add_options --disable-updater
ac_add_options --disable-debug
ac_add_options --disable-debug-symbols
ac_add_options --disable-tests

# This enables SIMD optimization in the shipped encoding_rs crate.
ac_add_options --enable-rust-simd

ac_add_options --enable-strip
ac_add_options --enable-install-strip

# You cannot distribute the binary if you do this.
ac_add_options --enable-official-branding

ac_add_options --enable-system-ffi
ac_add_options --enable-system-pixman

ac_add_options --with-system-jpeg
ac_add_options --with-system-png
ac_add_options --with-system-zlib

# Using sandboxed wasm libraries has been moved to all builds instead
# of only mozilla automation builds. It requires extra llvm packages
# and was reported to seriously slow the build. Disable it.
ac_add_options --without-wasm-sandboxed-libraries
EOF

Now invoke the Python mach script to compile Thunderbird:

[Note]

Note

If you are compiling this package in chroot you must ensure that /dev/shm is mounted. If you do not do this, the Python configuration will fail with a traceback report referencing /usr/lib/pythonN.N/multiprocessing/synchronize.py. As the root user, run:

mountpoint -q /dev/shm || mount -t tmpfs devshm /dev/shm

export MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none &&
export MOZBUILD_STATE_PATH=./mozbuild               &&
./mach configure                                    &&
./mach build

This package does not come with a test suite.

Install Thunderbird by running the following commands as the root user:

MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none ./mach install

Empty the environment variables which were set above:

unset MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE MOZBUILD_STATE_PATH

Command Explanations

MACH_BUILD_PYTHON_NATIVE_PACKAGE_SOURCE=none: Use the system python to create a virtual environment for mach without downloading any python wheels nor using the system python modules. This prevent version mismatches between system modules and bundled ones.

./mach configure: This validates the supplied dependencies and the mozconfig.

./mach build --verbose: Use this alternative if you need details of which files are being compiled, together with any C or C++ flags being used.

./mach build -jN: The build should, by default, use all the online CPU cores. If using all the cores causes the build to swap because you have insufficient memory, using fewer cores can be faster.

CC=gcc CXX=g++: BLFS used to prefer to use gcc and g++ instead of upstream's defaults of the clang programs. With the release of gcc-12 the build takes longer with gcc and g++, primarily because of extra warnings, and is bigger. Set these environment variables before you run the configure script if you wish to continue to use gcc, g++. Building with GCC on i?86 is currently broken.

Configuring Thunderbird

Configuration Information

If your Window Manager or Desktop Environment does not allow you to configure a default browser, you can add a configuration parameter to Thunderbird so that a browser will start when you click on an Internet/intranet/local URL. The procedure to check or modify any of the configuration parameters is quite simple and the instructions here can be used to view or modify any of the parameters.

First, open the configuration dialog by opening the Edit drop-down menu. Choose Preferences and then scroll down to the bottom of the page. Then, click the Config Editor button. Click on the I accept the risk! button. This will display a list of the configuration preferences and information related to each one. You can use the Filter: bar to enter search criteria and narrow down the listed items. Changing a preference can be done using two methods. One, if the preference has a boolean value (True/False), simply double-click on the preference to toggle the value and two, for other preferences simply right-click on the desired line, choose Modify from the menu and change the value. Creating new preference items is accomplished in the same way, except choose New from the menu and provide the desired data into the fields when prompted.

The configuration preference item you need to check so that Thunderbird uses a specified browser is the network.protocol-handler.app.http which should be set to the path of the desired browser, e.g. /usr/bin/firefox.

If you use a desktop environment such as GNOME or KDE, a desktop file thunderbird.desktop may be created, in order to include a Thunderbird entry in the menu. Run the following commands as the root user:

mkdir -pv /usr/share/{applications,pixmaps} &&

cat > /usr/share/applications/thunderbird.desktop << "EOF" &&
[Desktop Entry]
Name=Thunderbird Mail
Comment=Send and receive mail with Thunderbird
GenericName=Mail Client
Exec=thunderbird %u
Terminal=false
Type=Application
Icon=thunderbird
Categories=Network;Email;
MimeType=text/html;text/xml;application/xhtml+xml;application/xml;application/rss+xml;x-scheme-handler/mailto;
StartupNotify=true
EOF

ln -sfv /usr/lib/thunderbird/chrome/icons/default/default256.png \
        /usr/share/pixmaps/thunderbird.png

Contents

Installed Program: thunderbird
Installed Libraries: Numerous libraries and modules in the /usr/lib/thunderbird directory
Installed Directory: /usr/lib/thunderbird

Short Descriptions

thunderbird

is Mozilla's email and newsgroup client