Discord bridge

The Discord bridge installed by us is powered by mautrix-discord.

• Full documentation
• Source code
• Support

Usage¶

This page shows you how to set up the Discord bridge using Cinny client app (available as an add-on component), so that you can receive and send messages between Discord and Matrix rooms.

Invite the bot to a management room¶

First, please start a chat with @discordbot:your-server.com to create a management room. You can do so by inviting the bot to a room like below.

Make sure to replace your-server.com with your actual “base domain”. Setting your-server.com or example.com does not work on your server!

When the bot joins to the created room, it sends a confirmation message to the room as below.

If the introduction messages are visible, bots joined the management room and works as expected.

Authentication¶

To bridge Discord between Matrix, you need to authenticate the bridge’s bot for Discord.

There are several ways for conducting authentication, and the simplest one is to log in with a QR code. Please follow the steps below to do so.

1. Send login-qr to the bridge bot
2. Open the Discord app on your phone
3. Point your phone at the image sent by the bot to capture the code (see official docs)
4. After scanning the code, you’ll need to approve the login on the mobile app

The QR code will be displayed on the room as below:

If the bot returns an error message that “CAPTCHAs are currently not supported - use token login instead”, you will need to proceed to log in with a token, as mautrix-discord does not support solving CAPTCHAs on user’s behalf.

To proceed with token login, send the login-token command to the bot as instructed. As it requires to extract a token from your web browser, please consult the manual on this page for details.

After a successful login, the bridge will create portals for some recent DMs. You may uninstall the Discord app from your mobile phone after that.

Useful commands¶

If you send a message help to the room, available commands are output as a message like below:

Here is a couple of useful commands:

• guild status to see the list of guilds
• guilds bridge GUILD_ID --entire bridge a guild