Skip to content

GitLab

Last edited by Daniel Brötzmann
Page history

Gajim on macOS

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 python@3.8 librsvg git
brew install gtk+3 pygobject3 adwaita-icon-theme libsoup
brew link --force gettext

  • Make Python 3.8 the default:

    echo 'export PATH="/usr/local/opt/python@3.8/bin:$PATH"' >> ~/.zshrc
export PATH="/usr/local/opt/python@3.8/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:

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

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

This is a nice Mac theme: https://www.gnome-look.org/p/1171688/

Installation

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.