Gajim is multi-platform (runs on most operating systems) messaging application.

To setup Disroot chat on Gajim, follow these easy steps:

Installing Gajim

Gajim is available in most package repositories of the most widely used distros. If it's not your case, or you are a MS Windows user, you can check the Gajim's website and download the version you're looking for.

First start

Start Gajim. You will be greeted with a welcome message like this:

• If you want to use your Disroot account then choose "I already have an account I want to use".
• If you want to create a new account, choose "I want to register for a new account"

Creating or adding an account

Next, fill in the information needed:

• Jabber ID: replace username by either your Disroot username, or the username you have already created on any XMPP server. And for the @ part, choose your server name: it is disroot.org if your use your Disroot account. Remember that your XMPP account will look like this: username_@_disroot.org
• Password: either your Disroot password, or the password you have already set on any XMPP server.
• Click on Forward.

• Click on Finish.

All your contacts and rooms are synced between all the clients, so you can use Disroot chat on all your different devices at the same time.

Organize Gajim in a single window

Instead of having several windows (for contacts, for conversations, etc.), you can have a single window for everything.

Go to the Preferences. 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 General, then Chat Appearance, change the Window behavior to “Single window for everything”.

Plugins

You also need to set up a few plugins. Depending of your OS, you may have to install them first. See that page

Then, in the same place you found the Preferences, you should find Plugins.

You need two plugins:

• OMEMO
• URL image preview (Maybe you'll need to install the Plugin Installer first, which you can find here to download. After the download you can install it by clicking the button Install from zip in the Plugins window, to get the Available tab)

So go to the Available tab and check those two plugins. Click on Install/Upgrade when you’re done.

Then, go to the Installed tab. Check the plugins to make them active. Then close the windows.

User Interface

Here is what Gajim now looks like:

1. This is the room discussion window: there you can see everyone's messages in the current room. Here the user is in the howto@chat.disroot.org room.
2. That is where you can type a message, send files, etc.
3. This is the list of participants of this current room. Only online participants are listed.
4. This is the list of the user's contacts and connected room (Groupchats)
5. Here, the user can switch between opened rooms.

Sending and editing messages

To write/send message to contact or into a room, use the sending message box:

1. You write your message there. Note: Shift + Enter will allow you to add a line break.
2. You can add a smiley.
3. In Gajim you have some format options. But they don't work in other clients. So if you set a text in bold, they won't be seen as bold in other clients.
4. You can join/send any kind of files. The upload limit is currently of 10MB with Disroot XMPP server.
5. You can change the encryption of the message from Disable to OMEMO (not in open groupchats).

Just press the Enter key when you want to send your message.

You can only edit your last sent message in Gajim. To do so, enter the edit message box, press ctrl and the up arrow on your keyboard.

Note that a pencil appears next to the modified message.

Rooms

Entering or creating a room

Room are also called group conversations or MUC (Multiple User Chats).

To join one, click on Accounts (top-left corner), then on Join Group Chat. There, some group conversations may appear (the ones you have already joined in the past).

If the room you want to join doesn't appear, click again on Join Group Chat. Click also on Join Group Chat if you want to create your own room. This window will happen:

• 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 be created, and you will be its admin/owner.
• Server: enter chat.disroot.org if you want to join or create a room on Disroot XMPP server. But you can choose another XMPP server if you want.
• Password: useful only if the room you're trying to join is password protected.
• Bookmark: it allows to remember rooms you have 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 join/open the room.

Room creation options

When you create your room, you may want to configure it. Click on three dots in the send message box: and choose Manage Room and then Configure room.

There are a lot of features! Some of the important ones are:

• Persistent: if the room is not set to be persistent, it will be deleted automatically when the last participant disconnects from it.
• Include room information in public list: uncheck this box if you don't want your room to be listed.
• Only allow members to join: if you want your room to be members-only. Then, you can add members a little further, in this section:

You can also invite a contact in a members-only room: this contact then become a member of this room. Right click on the contact you want to invite, choose Invite to and choose the room you want to invite him/her in.

Leaving a room

When you want to leave a room, you need to disconnect. To do so there are two ways:

1. If the room is opened, click on the three dots in the send message box and choose Diconnect.
2. In the list of your room on the left panel, right click on the desired room, and choose Diconnect.

Bookmarking a room

You can bookmark rooms in order to join them in later easily and to keep them from one client to another.

When you first join a room or create on, you get this box:

If you later want to bookmark or unbookmark a room, click on three dots in the send message box: and choose Bookmark.

Room history

As soon as you close Gajim, the rooms windows are cleaned of messages that you've already read. However, you can still access the group conversation history.

Click on the three vertical dots in the send message box and choose History. You can navigate through history by date.

Finding a public room

You can search for public rooms on XMPP servers. Click on Accounts, then Discover Services.

In Address you can choose any public XMPP server. For example, add disroot.org to find a public room on Disroot XMPP server. Click on Go.

Then, search the Conference section and choose something that looks like room server. Click on Browse.

Direct chat: 1 to 1 conversation

You can also chat with someone in private, in a 1:1 discussion with only the two of you participating.

Adding a contact

Click on Accounts and choose Add contact.

1. Jabber ID: the XMPP address of the the contact you want to add. If this contact his on Disroot, his/her XMPP address is like this: username@disroot.org
2. Nickname: it can be different of the address.
3. Group: you can create groups to organize your contact.
4. Allow contact to view my status: if checked, that means your contact will be warned you're online/offline.
5. This is the message your contact will receive. You can change it.
6. Add

When you click on Add, a message is send to the person. When the person accepts your subscription, the he/she is added in your contact list.

Talking to a contact

Simply double-click on the contact name in your contacts list.

Removing a contact

To remove a contact, right-click on his/her name in your contact list. Choose Manage contact then Remove

Personnal details

You can change your personal details, your avatar, etc. Cick on Accounts then Profile. There are a lot of options there. Probably the two most important ones are:

• Avatar: Click on the avatar to change it.
• Nickname: if you want to change your default nickname. By default this is your Disroot username.

Click on OK when you're done.

Be careful as everyone will be allowed to see what you set in your profile.

Final note on Gajim

We have just presented what we think to be the most important features to start using your XMPP account on Gajim. But Gajim is full of features, so explore them!

If you have any question regarding the use of Gajim, join the gajim XMPP room: gajim@conference.gajim.org or check the gitlab repo