README.md 2.36 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16
# Welcome to Gajim


### Runtime Requirements

- python3.4 or higher
- python3-gi
- python3-gi-cairo
- gir1.2-gtk-3.0
- python3-nbxmpp
- python3-openssl (>=0.14)
- python3-pyasn1


### Optional Runtime Requirements

17
- python3-pil (pillow) for support of webp avatars
18 19
- python3-crypto to enable End to end encryption
- python3-gnupg to enable GPG encryption
20
- For zeroconf (bonjour) you need dbus-glib, python-avahi
21
- gir1.2-gspell-1 and hunspell-LANG where lang is your locale eg. en, fr etc
22 23 24 25 26 27
- gir1.2-secret-1 for GNOME Keyring or KDE support as password storage
- D-Bus running to have gajim-remote working. Some distributions split dbus-x11, which is needed for dbus to work with Gajim. Version >= 0.80 is required.
- python3-dbus bindings (>=1.2.0)
- gir1.2-farstream-0.2, gir1.2-gstreamer-1.0 and gir1.2-gst-plugins-base-1.0 for audio and video calls
- gir1.2-gupnpigd-1.0 for better NAT traversing
- gir1.2-networkmanager-1.0 for network lose detection
28
- gir1.2-geoclue-2.0 for sharing your location
29 30 31 32 33 34 35 36 37
- python3-idna and python3-precis-i18n for correctly parsing JIDs

### Compile-time Requirements

- python-setuptools


### Installation Procedure

38 39 40 41 42 43 44 45 46 47
#### Packages

- [Arch](https://aur.archlinux.org/packages/gajim-git/)
- [Debian](https://packages.debian.org/source/experimental/gajim) (tested with Debian ``testing`` and ``unstable``)

#### Snapshots

- [Daily Linux](https://www.gajim.org/downloads/snap/?M=D)
- [Daily Windows](https://gajim.org/downloads/snap/win)

48
#### Linux
49 50 51 52 53 54 55

``./setup.py install --root=/``

or

``pip install .`` (python-pip is required)

56 57 58 59
#### Mac

see [Wiki](https://dev.gajim.org/gajim/gajim/wikis/help/gajimmacosx#python3brew)

60
#### Developing
61

62
For developing you dont have to install Gajim.
63

64
After installing all dependencys execute
65

66
``./launch.py``
67

68 69 70 71 72
#### Flatpak

see [README](./flatpak/README.md)

#### Windows
73

74 75 76
see [README](./win/README.md)

### Miscellaneous
77

78
#### Debugging
79 80 81

Execute gajim with --verbose

82
#### Links
83 84 85 86 87 88 89 90 91 92 93 94 95 96

- [FAQ](https://dev.gajim.org/gajim/gajim/wikis/help/gajimfaq)
- [Wiki](https://dev.gajim.org/gajim/gajim/wikis/home)



That is all, **enjoy**!

(C) 2003-2017
The Gajim Team
[https://gajim.org](https://gajim.org)


We use original art and parts of sounds and other art from Psi, Gossip, Gnomebaker, Gaim and some icons from various gnome-icons (mostly Dropline Etiquette) we found at art.gnome.org If you think we're violating a license please inform us. Thank you.