Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • gajim gajim
  • Project information
    • Project information
    • Activity
    • Labels
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 177
    • Issues 177
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 7
    • Merge requests 7
  • Deployments
    • Deployments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Wiki
    • Wiki
  • Activity
  • Graph
  • Create a new issue
  • Commits
  • Issue Boards
Collapse sidebar
  • gajim
  • gajimgajim
  • Wiki
  • Help
  • Gajim on macOS

Last edited by Daniel Brötzmann May 05, 2022
Page history

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.

Clone repository

Home

Keyboard Shortcuts

Setting Overrides


Development

Contributing

Updating Changlog