Gajim on macOS
Dev note: It should be relatively easy to create a 'brew' based on the recipe below.
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 firstname.lastname@example.org librsvg git brew install gtk+3 pygobject3 adwaita-icon-theme libsoup brew link --force gettext
Make Python 3.8 the default:
echo 'export PATH="/email@example.com/bin:$PATH"' >> ~/.zshrc export PATH="/firstname.lastname@example.org/bin:$PATH"
Make sure correct python version is used
python3 --version pip3 --version
both should point to python3.8
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.
For plugins, download the plugin_installer:
Then extract the downloaded files to
Afterwards activate the installer from the Plugins Menu inside Gajim.
This is a nice Mac theme: https://www.gnome-look.org/p/1171688/
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.