Skip to content
Snippets Groups Projects
README.md 2.16 KiB
Newer Older
Philipp Hörist's avatar
Philipp Hörist committed
# Welcome to Gajim


### Runtime Requirements

- python3.5 or higher
Philipp Hörist's avatar
Philipp Hörist committed
- python3-gi
- python3-gi-cairo
- gir1.2-gtk-3.0 (>=3.22)
Philipp Hörist's avatar
Philipp Hörist committed
- python3-nbxmpp
- python3-openssl (>=0.14)
Philipp Hörist's avatar
Philipp Hörist committed
- python3-cssutils (>=1.0.2)
Philipp Hörist's avatar
Philipp Hörist committed
- python3-keyring
- python3-precis-i18n
Philipp Hörist's avatar
Philipp Hörist committed

### Optional Runtime Requirements

Philipp Hörist's avatar
Philipp Hörist committed
- python3-pil (pillow) for support of webp avatars
Philipp Hörist's avatar
Philipp Hörist committed
- python3-gnupg to enable GPG encryption
- For zeroconf (bonjour) you need python3-dbus
Philipp Hörist's avatar
Philipp Hörist committed
- gir1.2-gspell-1 and hunspell-LANG where lang is your locale eg. en, fr etc
Philipp Hörist's avatar
Philipp Hörist committed
- gir1.2-secret-1 for GNOME Keyring or KDE support as password storage
Philipp Hörist's avatar
Philipp Hörist committed
- D-Bus running to have gajim-remote working
Philipp Hörist's avatar
Philipp Hörist committed
- 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
- gir1.2-geoclue-2.0 for sharing your location
Philipp Hörist's avatar
Philipp Hörist committed

### Compile-time Requirements

- python-setuptools


### Installation Procedure

Philipp Hörist's avatar
Philipp Hörist committed
#### 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)

Philipp Hörist's avatar
Philipp Hörist committed
#### Linux
Philipp Hörist's avatar
Philipp Hörist committed

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

or

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

Philipp Hörist's avatar
Philipp Hörist committed
#### Mac

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

Philipp Hörist's avatar
Philipp Hörist committed
#### Developing
Philipp Hörist's avatar
Philipp Hörist committed

Alexander Krotov's avatar
Alexander Krotov committed
For developing you don't have to install Gajim.
Philipp Hörist's avatar
Philipp Hörist committed

Alexander Krotov's avatar
Alexander Krotov committed
After installing all dependencies execute
Philipp Hörist's avatar
Philipp Hörist committed

Philipp Hörist's avatar
Philipp Hörist committed
``./launch.py``
Philipp Hörist's avatar
Philipp Hörist committed

Philipp Hörist's avatar
Philipp Hörist committed
#### Flatpak

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

#### Windows
Philipp Hörist's avatar
Philipp Hörist committed

Philipp Hörist's avatar
Philipp Hörist committed
see [README](./win/README.md)

### Miscellaneous
Philipp Hörist's avatar
Philipp Hörist committed

Philipp Hörist's avatar
Philipp Hörist committed
#### Debugging
Philipp Hörist's avatar
Philipp Hörist committed

Execute gajim with --verbose

Philipp Hörist's avatar
Philipp Hörist committed
#### Links
Philipp Hörist's avatar
Philipp Hörist committed

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



That is all, **enjoy**!

André's avatar
André committed
(C) 2003-2019
Philipp Hörist's avatar
Philipp Hörist committed
The Gajim Team
[https://gajim.org](https://gajim.org)


André's avatar
André committed
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.