Connect XMPP to a Matrix room

How to connect XMPP to a Matrix room

I'll make a few remarks right away:
The room must be unencrypted for
normal operation of the Bifrost bridge.
The room must have a local
address on the Matrix server (alias).

Let's take the XMPP client Psi+ as an example.
Join to the room from your XMPP account.

Right mouse button click (RMB) -> Groupchats -> Join chat
Write in the left field before the @ symbol:
#YourRoom#vern.cc
Writing in the right field after the @ symbol:
bi.vern.cc

And click Join. That is we add a Matrix room as a normal XMPP room. This is done once. We simply register our room with the Bifrost bridge, and the he add it to its list. If you have multiple accounts, then in other accounts just add the room to bookmarks
(RMB) -> Groupchats -> Manage bookmarks -> Add)
Fill fields:

• Room name MyMatrixRoom1 (so it she will be shown in the your list of bookmarks)
• Host: bi.vern.cc
• Room: #YourRoom#vern.cc
• Nickname: YourNic (it will be shown in the room)
• Password: leave blank
• Auto-join: as you like

and click OK.
It all. Enter the room trouth bookmars:
(RMB) -> Groupchats -> MyMatrixRoom1

Bridge accounts in Matrix look like this:
@_jabber_JohnHolt=40xmppserver.tld:vern.cc
Or even scarier if they are in Cyrillic 😲️ :
@_jabber_=431=440=43e=434=44f=433=430=40xmppserver.tld:vern.cc

But don't be alarmed, in the room they are displayed as you wrote in the Nickname field in the bookmarks.

Connecting to the rooms of ~Vern itself

All of the rooms in ~vern space (the ~V icon) are already connected to the bot, so they connect as normal XMPP chats, not as Matrix rooms. You can see a list of these rooms in Service discovery in the right-click drop-down menu or by clicking on the icon in the roster.

The XMPP addresses (JIDs) of the rooms are also there. For example, the main room ~vern has the address vern@muc.vern.cc. To connect to it, add a new chat room to your XMPP account:

• Right mouse button (PKM) -> Groupchats -> Join chat
• Write in the left field up to the @ symbol:

• Write in the right field after the @ symbol:

• In the Nickname field we type any other nickname, different from the one registered on the XMPP server ~vern. Under it you will be visible in the chat. For example, if your nick on the XMPP server and therefore in the Bifrost bot is jgolt, you should change it to anything else. For example, *jgolt*, JGolt, Donald, etc. Otherwise the server will answer you that there is a conflict with an already connected user.

And add the new room to the bookmarks:

Fill in the fields:

• Room name (e.g. ~vern main, so it will be shown in the list of bookmarks)
• Host: muc.vern.cc
• Room: vern
• Nicname: YourNic (it will be shown in the room)
• Password: Leave it blank
• Auto-join: as you like

Click OK. That's it. Open the list of bookmarks and go to the room:
PKM -> Groupchats -> ~vern main

If you have multiple XMPP accounts, the order in which the rooms are connected is exactly the same, since Bifrost registers the messenger with all the accounts it has.

Download this (txt in zip archive, 1,5K)

Как подключить XMPP к комнате Matrix

Сразу сделаю несколько замечаний:
Комната для нормальной работы моста
Bifrost должна быть без шифрования.
Для комнаты должен установлен локальный
адрес на Matrix сервере (alias).

Для примера используем XMPP клиент Psi+.
Присоединяемся к комнате из своего XMPP аккаунта.

• Правая кнопка мышки (ПКМ) -> Groupchats ->Join chat
• Пишем в левое поле до символа @:

• Пишем в правое поле после символа @:

и кликаем Join. То есть добавляем комнату в Matrix MyMatrixRoom1 как обычную комнату XMPP. Это делается один раз. Мы просто регистрируем нашу комнату в мосте Bifrost, и он добавляет её в свой список. Если у вас несколько аккаунтов, то в остальных аккаунтах просто добавляем комнату в закладки:
ПКМ -> Groupchats -> Manage bookmarks -> Add
Заполняем поля:

• Название комнаты MyMatrixRoom1 (так она будет показываться в списке закладок)
• Host: bi.vern.cc
• Room: #YourRoom#vern.cc
• Nickname: YourNic (он будет показываться в комнате)
• Password: оставляем пустым
• Auto-join: как вам удобно

Кликаем ОК.
Это всё. Открываем список закладок и заходим в комнату:
ПКМ -> Groupchats -> MyMatrixRoom1

Аккаунты моста в Matrix выглядят так:
@_jabber_JohnHolt=40jid.plxmppserver.tld:vern.cc
Или ещё страшнее, если они на кирилице 😲️ :
@_jabber_=431=440=43e=434=44f=433=430=40xmppserver.tld:vern.cc

Но пугаться не стоит, в комнате они отображаются так, как вы их написали в поле Nickname в закладках.

Подключение к комнатам самого ~Vern

Все комнаты в пространстве ~vern space (иконка ~V) уже подключены к боту, поэтому подключаются как обычные чаты XMPP, а не как комната Matrix. Список этих комнат можно увидеть в Service discovery в выпадающем по нажатию правой кнопки мыши меню или кликнув по иконке на панели в ростере.

Там же есть и XMPP-адреса (JID) комнат. Например, основная комната ~vern имеет адрес vern@muc.vern.cc. Для подключения к ней добавляем в XMPP аккаунт новый чат:

• Правая кнопка мышки (ПКМ) -> Groupchats ->Join chat
• Пишем в левое поле до символа @:

• Пишем в правое поле после символа @:

• В поле Nickname вписываем любой другой ник, отличный от того, который зарегистрирован на XMPP сервере ~vern. Под ним вы будете видны в чате. Например, если ваш ник на сервере XMPP, а соответственно и в боте Bifrost - jgolt, то нужно его изменить на любой другой. Например, *jgolt*, JGolt, Donald и т.д. Иначе сервер ответит ответит вам, что возник конфликт с уже подключенным пользователем.

И добавляем новую комнату в закладки:

Заполняем поля:

• Название комнаты (например, ~vern main,так она будет показываться в списке закладок)
• Host: muc.vern.cc
• Room: vern
• Nicname: YourNic (он будет показываться в комнате)
• Password: оставляем пустым
• Auto-join: как вам удобно

Кликаем ОК. Это всё. Открываем список закладок и заходим в комнату:
ПКМ -> Groupchats -> ~vern main

Если у вас несколько XMPP аккаунтов, то порядок подключения комнат точно такой же, поскольку Bifrost регистрирует мессенджер со всеми имеющимися в нём аккаунтами.