|
|
# Gajim 1.1 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](https://brew.sh/).
|
|
|
|
|
|
**Install Gajim's dependencies**
|
|
|
|
|
|
* Make sure you install the necessary build dependencies and 'link' gettext formula:
|
|
|
|
|
|
```bash
|
|
|
brew install gettext python3 librsvg git
|
|
|
brew install gtk+3 pygobject3 adwaita-icon-theme libsoup
|
|
|
brew link --force gettext
|
|
|
```
|
|
|
|
|
|
* Install python packages with pip3:
|
|
|
|
|
|
```bash
|
|
|
pip3 install --upgrade nbxmpp pyOpenSSL pyasn1 pyobjc pillow idna precis-i18n certifi cssutils
|
|
|
```
|
|
|
|
|
|
If you want to use current master of Gajim, dependencies differ a bit:
|
|
|
|
|
|
```bash
|
|
|
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
|
|
|
```
|
|
|
|
|
|
### Download and run Gajim
|
|
|
|
|
|
```bash
|
|
|
git clone https://dev.gajim.org/gajim/gajim.git
|
|
|
cd gajim
|
|
|
git checkout gajim_1.1
|
|
|
```
|
|
|
|
|
|
You can now either run gajim from the terminal:
|
|
|
```bash
|
|
|
./launch.py
|
|
|
```
|
|
|
|
|
|
Or create an .app bundle so Gajim can be run from the desktop as a native app:
|
|
|
```bash
|
|
|
mac/makebundle.py ~/Applications/Gajim.app --bin-path="$(pwd)/launch.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):
|
|
|
|
|
|
```bash
|
|
|
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.1_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.
|
|
|
```ini
|
|
|
[Settings]
|
|
|
gtk-theme-name = Gnome-OSC-HS-(transparent)
|
|
|
```
|
|
|
|
|
|
Next time you start gajim the theme should be applied. |