Commit e61f46a3 authored by muppeth's avatar muppeth

Merge branch 'gajim2' into 'master'

Gajim2

See merge request !59
parents 5eea7922 9efd4535
---
title: Gajim
published: true
visible: true
taxonomy:
category:
- docs
---
Gajim is multi-platform (runs on most operating systems) messaging application.
To setup disroot chat on Gajim, follow those easy steps:
## Install Gajim
If you use windows/macos check [Gajim's website](https://gajim.org/downloads.php) and download a version for you.
If you are a linux user, check your package repository and get it. (check for some additional plugins while you're at it.)
## Fire it up
You will be greeted with a welcome message like this:
![](en/01_creation.png)
- If you want to use your Disroot account then choose **"I already have an acccount I want to use"**.
- If you want to create a new account, choose **"I want to register for a new account"**
## Setup account
Next fill in the information needed:
![](en/02_creation.png)
Replace **username** by either your Disroot username, or by the username you have already created.
![](en/03_creation.png)
Click on **Finish**.
**All your contacts are synced between all the clients, so you can use disroot chat on all the devices at the same time.**
## Single window
Instead of having several windows (for contacts, for conversations, etc.), you can have a single window for everything.
Go to the **Preferences**. It depends on either you’re using Windows or Linux.
You may find it at the top bar menu. Or you may have to right-click on the Gajim icon in the app list.
In the **Preferences** window, in **Chat Appearance**, change the **Window behavior** to **“Single window for everything”**.
![](en/04_windows.png)
## Plugins
We also need to set up a few plugins.
Depending of your OS, you may have to install them first. [See that page](https://dev.gajim.org/gajim/gajim-plugins)
Then, in the same place you found the **Preferences**, you should find **Plugins**. We need two plugins:
- OMEMO
- URL image preview
So go to the **Available** tab and check those two plugins. Click on **Install/Upgrade** when you’re done.
![](en/05_plugins.png)
Then, go to the **Installed** tab. Check the plugins to make them active. Then close the windows.
![](en/06_plugins.png)
## Join a room
Room are also called group conversations or MUC (Multiple Chat Users).
To join one, click on **Accounts**, then on **Join Group Chat**.
There, some group conversations may appear. If not, click again on **Join Group Chat**.
![](en/07_join.png)
- **Nickname**: you can set whatever you want, it doesn't have to be your username!
- **Room**: the name of the room you want to join. If the room doesn't exist, it will then be created, and you will be its admin.
- **Server**: enter **chat.disroot.org**
- **Password**: useful only if the room you're trying to join is password protected.
- **Bookmark**: very useful, it allows to remember room you joined, so that you can easily and quickly find them again. And it allows also to keep them from one device to another one!
- **Autojoin**: if enabled, then on startup, Gajim will automatically open the room.
## History
As soon as you close Gajim, the rooms are cleaned of messages that you've already read.
However, you can still read a group conversation history.
![](en/08_history.png)
Click on the **three vertical dots** next to the attach file icon and choose **History**.
You can navigate through history by date.
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment