Gajim: version v1.1
If the howto reffers to an older software version than the provided by Disroot,
or the one you're using in your device, there could be missing features or small parts of the information that may have changed.
how-to documentation is a community driven procces. We try to keep it as updated as we can.
|Gajim is multi-platform (runs on most operating systems) messaging application.|
To setup Disroot chat on Gajim, follow these easy steps:
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.
Start Gajim. You will be greeted with a welcome message like this:
Next, fill in the information needed:
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.
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”.
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:
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.
Here is what Gajim now looks like:
To write/send message to contact or into a room, use the sending message box:
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.
Room are also called group conversations or MUC (Multiple Chat Users).
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:
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:
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 and choose Invite to and choose the room you want to invite him/her in.
When you want to leave a room, you need to disconnect fro do so there is two ways:
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.
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.
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. Clck on Browse.
You can also chat with someone in private, in a 1:1 discussion with only the two of you participating.
Click on Accounts and choose Add contact.
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.
Simply double-click on the contact name in your contacts list.
To remove a contact, right-click on his/her name in your contact list. Choose Manage contact then Remove
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:
Click on OK when you're done.
Be careful as everyone will be allowed to see what you set in your profile.
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: firstname.lastname@example.org or check the gitlab repo