Install dependencies via Brew
First install Brew
Please follow installation instructions at brew.sh.
Install Gajim's dependencies
Make sure you install the necessary build dependencies and 'link' gettext formula:
brew install gettext python librsvg git brew install gtk+3 pygobject3 adwaita-icon-theme libsoup@2 gst-python gtksourceview4 brew link --force gettext brew link libsoup@2
Make sure correct python version is used
python3 --version pip3 --version
both should point to python3.9
Install python packages with pip3:
pip3 install --upgrade nbxmpp pyOpenSSL pyasn1 pyobjc pillow idna precis-i18n certifi css-parser keyring packaging
If you want to use current master of Gajim, dependencies differ a bit:
pip3 install --upgrade git+https://dev.gajim.org/gajim/python-nbxmpp.git pip3 install --upgrade pyOpenSSL pyasn1 pyobjc pillow idna precis-i18n certifi css-parser keyring packaging
Download and run Gajim
git clone https://dev.gajim.org/gajim/gajim.git cd gajim git checkout gajim_1.3
You can now run gajim from the terminal:
Note: The following approach does not work currently!
Alternatively, you can create an .app bundle so Gajim can be run from the desktop as a native app:
pip3 install PyInstaller mac/makebundle.py
You can now go to
~/Applications and open the Gajim app.
Note: when using the .app method, the cloned gajim repository has to stay at it's original location (
$(pwd) at time of creation), or Gajim.app will fail to run and you will have to re-run
If Python complains about unknown locale, try this (with your country code):
echo -e "export LC_ALL=en_US.UTF-8 \nexport LANG=en_US.UTF-8" >> ~/.bash_profile
Or if using the .app method, add those lines to
~/Applications/Gajim.app/Contents/MacOS/launch.sh, right after the first line.
Note: Some plugins have external dependencies that need to be installed separately. Check the plugin's wiki page for details.
For plugins, download the plugin_installer:
Then extract the downloaded files to
Afterwards activate the installer from the Plugins Menu inside Gajim.
Download the theme you want and place the folder containing the
gtk-3.0 folder in
~/.local/share/themes. If you downloaded the theme linked above you should have a file structure like this:
$ ls -l ~/.local/share/themes/Gnome-OSC-HS-\(transparent\)/ total 48 -rw-r--r-- 1 user staff 18092 Mar 24 17:52 COPYING -rw-r--r-- 1 user staff 1008 Apr 15 11:36 READ ME drwxr-xr-x 8 user staff 256 Nov 26 2017 gtk-2.0 drwxr-xr-x 6 user staff 192 Apr 15 11:59 gtk-3.0
~/.config/gtk-3.0/settings.ini with the following content where
Gnome-OSC-HS-(transparent) can be replaced with the folder name of the theme you installed.
[Settings] gtk-theme-name = Gnome-OSC-HS-(transparent)
Next time you start gajim the theme should be applied.