SysTray-X/README.md

SysTray-X

SysTray-X is a system tray extension for Thunderbird 68+. The addon uses the WebExtension API's to control an external system dependent system tray application.

The addon and system tray application can do:

• custom new mail icon
• display number of unread mails
• show / hide Thunderbird (minimize)
• minimizing hides to tray (remove Thunderbird from taskbar when minimized)
• minimize on startup
• minimize on close

Warning:

This add-on and companion app will NOT work with FULL Wayland desktops. No interaction between window clients is possible in Wayland.

Donations

To support this project, you can make a donation to its current maintainer:

Contributers

Luigi Baldoni <aloisio@gmx.com> : Initial setup of the OpenSuSE Build Service rpm package.

Known issues

Some Gnome status / application bars do not respect the "remove from taskbar X11 atom (_NET_WM_STATE_SKIP_TASKBAR)". So Thunderbird stays always visible when minimized.

• Ubuntu Gnome (red status dot stays visible) Please be aware that the icon always will be visible because is a launchbar also...
• CentOS Gnome (Thunderbird stays visible in the taskbar)

Binaries (System)

These packages will install the Thunderbird addon and companion app system wide.
Root credentials are required.

Make shure you removed / uninstalled any SysTray-X package installed with a script installer.
You can verify this by checking the ~/.mozilla/native-messaging-hosts directory. There should be NO SysTray-X packages or links in there. Remove them and remove the add-on from the Thunderbird add-ons page.

openSuSE

Repository

Installing the repository:

Tumbleweed

sudo zypper ar -f https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/openSUSE_Tumbleweed/ SysTray-X

Leap 15.2

sudo zypper ar -f https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/openSUSE_Leap_15.2/ SysTray-X

Leap 15.1

sudo zypper ar -f https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/openSUSE_Leap_15.1/ SysTray-X

SLE 15 SP1

sudo zypper ar -f https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/openSUSE_SLE_15_SP1/ SysTray-X

SLE 15

sudo zypper ar -f https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/openSUSE_SLE_15/ SysTray-X

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo zypper in systray-x

GNOME

sudo zypper in systray-x-gnome

XFCE / Others (non-KDE, non-GNOME)

sudo zypper in systray-x-minimal

xUbuntu

Repository

Installing the repository:

20.10

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_20.10/Release.key
sudo mv -f  Release.key  /etc/apt/trusted.gpg.d/Systray-x.Ximi1970.asc
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_20.10 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

20.04 LTS

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_20.04/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_20.04 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

19.10

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_19.10/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_19.10 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

18.04 LTS

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_18.04/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_18.04 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

16.04 LTS

wget -q http://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_16.04/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb http://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/xUbuntu_16.04 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo apt install systray-x

GNOME

sudo apt install systray-x-gnome

Unity / XFCE / Others (non-KDE, non-GNOME)

sudo apt install systray-x-minimal

Debian

Repository

Installing the repository:

10

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Debian_10/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Debian_10 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo apt install systray-x

GNOME

sudo apt install systray-x-gnome

XFCE / Others (non-KDE, non-GNOME)

sudo apt install systray-x-minimal

Fedora

Repository

Installing the repository:

33

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Fedora_33/home:Ximi1970:Mozilla:Add-ons.repo
sudo dnf update --refresh

32

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Fedora_32/home:Ximi1970:Mozilla:Add-ons.repo
sudo dnf update --refresh

31

sudo dnf config-manager --add-repo https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Fedora_31/home:Ximi1970:Mozilla:Add-ons.repo
sudo dnf update --refresh

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo dnf install systray-x

GNOME

sudo dnf install systray-x-gnome

XFCE / Others (non-KDE, non-GNOME)

sudo dnf install systray-x-minimal

Arch

AUR

A git package is available in the user repository (KDE Plasma version). To install it, just use some AUR helper, like yay:

yay -S systray-x-git

Repository

Installing the repository:

wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Arch/x86_64/home_Ximi1970_Mozilla_Add-ons_Arch.key
sudo pacman-key --add home_Ximi1970_Mozilla_Add-ons_Arch.key
sudo pacman-key --lsign-key BEEF5C3607D86FE9
sudo echo -e "\n[home_Ximi1970_Mozilla_Add-ons_Arch]\nSigLevel = PackageOptional\nServer = https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Arch/x86_64" | sudo tee -a /etc/pacman.conf 
sudo pacman -Syyu

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo pacman -S systray-x

GNOME

sudo pacman -S systray-x-gnome
sudo pacman -S gnome-tweaks

Please use Tweaks to activate the gnome shell extension Kstatusnotifieritem/appindicator support or reboot the system.

XFCE / Others (non-KDE, non-GNOME)

sudo pacman -S systray-x-minimal

CentOS

Repository

Installing the repository:

8 Stream

sudo yum-config-manager --add-repo=https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/CentOS_8_Stream/home:Ximi1970:Mozilla:Add-ons.repo
sudo yum update

8

sudo yum-config-manager --add-repo=https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/CentOS_8/home:Ximi1970:Mozilla:Add-ons.repo
sudo yum update

7

sudo yum-config-manager --add-repo=https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/CentOS_7/home:Ximi1970:Mozilla:Add-ons.repo
sudo yum update

Package

Installing the SysTray-X addon and companion app package:

KDE

sudo yum install systray-x-minimal

or

sudo yum install epel-release
sudo yum install systray-x

GNOME

sudo yum install systray-x-gnome
sudo yum install gnome-tweaks

Please use Tweaks to activate the gnome shell extension Kstatusnotifieritem/appindicator support or reboot the system.

MX

First install the Debian latest Thunderbird version. Replace the xx.x.x with the correct version.

sudo apt install thunderbird=1:xx.x.x-1~deb10u1

Then add the SysTray-X Debian repository and install the SysTray-X package.

sudo apt install thunderbird=1:78.x.x-1~deb10u1
wget -q https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Debian_10/Release.key
sudo apt-key add Release.key
sudo bash -c 'echo "deb https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/Debian_10 ./" > /etc/apt/sources.list.d/systray-x.list'
sudo apt update
sudo apt install systray-x-minimal

Binaries (User)

User installable package.
No root credentials required.

Download the installer here (click on the assets dropdown list):

Addon and companion app installer

Please keep in mind that using the script will override the SysTray-X packages installed with a repository. Use the -u option with the script installer to uninstall.

Windows

Get the SysTray-X-setup32-x.x.x.exe or SysTray-X-setup64-x.x.x.exe depending on the Thunderbird version (32bit or 64bit) you are using.
Run the installer.
If you want to change the install directory, please make sure to select an empty / unused directory.
ALL files in the selected install directory will be removed when uninstalling !! Please remove the Systray-X add-on from Thunderbird before uninstalling.

When reinstalling you need to add the add-on manually to Thunderbird again by using the Installl Add-On From File option in the Add-ons manager. You can find add-on file in the install directory called systray-x@Ximi1970.xpi

Building

Linux

Clone the repository:

git clone https://github.com/Ximi1970/systray-x.git

Requirements:

• OpenSuSE:

  sudo zypper install zip git gcc-c++ make qt5-qtbase-devel knotifications-devel
  

• Fedora/RHEL:

  sudo dnf install qt5-qtbase-devel gnome-shell-extension-appindicator kf5-knotifications-devel
  gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com
  

• CentOS:

  sudo yum install epel-release
  sudo yum install kf5-knotifications-devel
  sudo yum install qt5-qtbase-devel
  

  If you want to use systray-x under Gnome you also need to add the SysTray-X repository for your CentOS version (replace the XX with your version):

  sudo yum-config-manager --add-repo=https://download.opensuse.org/repositories/home:/Ximi1970:/Mozilla:/Add-ons/CentOS_XX/home:Ximi1970:Mozilla:Add-ons.repo
  sudo yum update
  sudo yum install gnome-shell-extension-appindicator
  gnome-extensions enable appindicatorsupport@rgcjonas.gmail.com
  

• Ubuntu:

  20.04 LTS

  sudo apt install zip git g++ make qt5-default
  gnome-extensions enable ubuntu-appindicator@ubuntu.com
  

  19.10

  sudo apt install zip git g++ make qt5-default gnome-shell-extension-appindicator
  gnome-extensions enable ubuntu-appindicator@ubuntu.com
  

  16.04 LTS / 18.04 LTS

  sudo apt install zip git g++ make qt5-default gnome-shell-extension-appindicator
  gnome-shell-extension-tool -e ubuntu-appindicator@ubuntu.com
  

• Debian:

  sudo apt install zip git g++ make qt5-default gnome-shell-extension-appindicator
  gnome-shell-extension-tool -e ubuntu-appindicator@ubuntu.com
  

Build (KDE):

cd systray-x
make

or if knotifications is not available:

cd systray-x
make OPTIONS="DEFINES+=NO_KDE_INTEGRATION"

Build (GNOME):

cd systray-x
make OPTIONS="DEFINES+=NO_KDE_INTEGRATION"

Install and run SysTray-X from the build directory in the repository:

mkdir -p ~/.mozilla/native-messaging-hosts
cp -f app/config/linux/SysTray_X.json ~/.mozilla/native-messaging-hosts/
cp -f systray-x@Ximi1970.xpi ~/.thunderbird/*.default-release/extensions/

User install:

...

System install:

...

Windows

Install:

• Visual Studio Express 2017
• Visual Code Studio
• Git for Windows
• TortoiseGit
• PuTTY
• Qt

Clone the repository using TortoiseGit:

...

Translations

de :
el : askembris
en_US :
it : lgbaldoni
nl :
pt_BR : fabianski7
ru_RU : PutinVladimir

Remarks

Branches:

master : Should be stable and working for all supported systems
develop : Working but maybe not for all systems
feature-xxx : Experimental