You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
eeeeeta 97ae1b36df insert attachment messages into the store as well 5 years ago
config Implement self-service bridging for users 5 years ago
docs Add some useful documentation on how to join a room 5 years ago
src insert attachment messages into the store as well 5 years ago
test COMPLETELY UNTESTED merge of -rc2 5 years ago
tools Implement self-service bridging for users 5 years ago
.gitignore probably buggy attempt to merge develop 5 years ago
.travis.yml Build first 5 years ago
LICENSE Initial commit 7 years ago Make README more confident about the stability 5 years ago
package-lock.json COMPLETELY UNTESTED merge of -rc2 5 years ago
package.json COMPLETELY UNTESTED merge of -rc2 5 years ago
screenshot.png Updated screenshot 5 years ago
tsconfig.json Update to ES2016 6 years ago
tslint.json Apply new linting rules. 6 years ago

Matrix Discord Bridge

A bridge between Matrix and Discord. Currently the bridge is in Beta and quite usable for everyday bridging, with one or two bugs cropping up.

Screenshot of Riot and Discord working together

Helping out

Build Status


PRs are graciously accepted, so please come talk to us in about any neat ideas you might have. If you are going to make a change, please merge it with the develop branch :).


You can also file bug reports/ feature requests on Github Issues which also helps a ton. Please remember to include logs. Please also be aware that this is an unoffical project worked on in my (Half-Shot) spare time.

Setting up

(These instructions were tested against Node.js v6.9.5 and the Synapse homeserver)

Setup the bridge

  • Run npm install to grab the dependencies.

  • Run npm run-script build to build the typescript.

  • Copy config/config.sample.yaml to config.yaml and edit it to reflect your setup.

    • Note that you are expected to set domain and homeserverURL to your public host name. While localhost would work, it does not resolve correctly with Webhooks/Avatars.
    domain: ""
    homeserverUrl: ""
  • Run node build/src/discordas.js -r -u "http://localhost:9005" -c config.yaml

  • Modify your HSs appservices config so that it includes the generated file.

    • e.g. On synapse, adding to app_service_config_files array in homeserver.yaml
    - "discord-registration.yaml"
    • Copy discord-registration.yaml to your Synapse's directory.

3PID Protocol Support

This bridge support searching for rooms within networks via the 3pid system used in clients like Riot. However, it requires a small manual change to your registration file. Add protocols: ["discord"] to the end and restart both your bridge and synapse. Any new servers/guilds you bridge should show up in the network list on Riot and other clients.

Setting up Discord

  • Create a new application via
  • Make sure to create a bot user. Fill in config.yaml
  • Run npm run-script getbotlink to get a authorisation link.
  • Give this link to owners of the guilds you plan to bridge.
  • Finally, you can join a room with #_discord_guildid_channelid
    • These can be taken from the url ("/$GUILDID/$CHANNELID") when you are in a channel.
    • Riot (and other clients with third party protocol support) users can directly join channels from the room directory.
  • You can use Webhooks to make messages relayed by the bridge not nested by the bot user. This will also display the avatar of the user speaking on matrix with their messages.
    • The bot should create this automatically, but if not perform the following:
      • Enable Manage Webhooks on the role added by the bot.
      • Add the _matrix Webhook for each channel you'd like to enable this feature on.

Running the Bridge

  • For the bot to appear online on Discord you need to run the bridge itself.
  • npm start


Features and Roadmap

In a vague order of what is coming up next

  • Matrix -> Discord
    • Text content
    • Image content
    • Audio/Video content
    • Typing notifs (Not supported, requires syncing)
    • User Profiles
  • Discord -> Matrix
    • Text content
    • Image content
    • Audio/Video content
    • Typing notifs
    • User Profiles
    • Presence
    • Per-guild display names.
  • Group messages
  • Third Party Lookup
    • Rooms
    • Users
  • Puppet a user's real Discord account.
    • Sending messages
    • Direct messages
    • UI for setup
  • Rooms react to Discord updates
  • Integrate Discord into existing rooms
    • Feature
    • UI
  • Manage channel from Matrix (possibly)
    • Authorise admin rights from Discord to Matrix users
    • Topic
    • Room Name
  • Provisioning API
  • Webhooks (allows for prettier messages to discord)
  • VOIP (Hard | Unlikely to be finished anytime soon)


My Matrix ID: