Gajim on macOS

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:

./launch.py

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 mac/makebundle.py.

Possible errors

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.

Plugins

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:

https://ftp.gajim.org/plugins_1.3_zip/plugin_installer.zip

Then extract the downloaded files to ~/.local/share/gajim/plugins/.

Afterwards activate the installer from the Plugins Menu inside Gajim.

Theme

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

Create ~/.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.