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.