Gajim

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 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:

  • 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:

Replace username by either your Disroot username, or by the username you have already created.

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”.

Plugins

We 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. 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.

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

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.

  • 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.

Click on the three vertical dots next to the attach file icon and choose History. You can navigate through history by date.