matterbridge is a solution to connect users on different platforms/protocols, allowing them to chat in the best conditions possible. Despite the name, Mattermost isn't required to run matterbridge.

Many features are available, but not all of them are supported on all protocols:

• Bridge many rooms from supported protocols
• Message threads/topics, and replies
• Attachments, file uploads, and inline images
• Transparent bridging with spoofed usernames and avatars
• Private groups

The complete and up-to-date list of supported protocols is in docs/protocols/. Additionally, we have an API for 3rd party integration if you'd like to add a custom bridge without implementing it in this codebase.

Get matterbridge up-and-running in a few minutes in 3 simple steps:

• Setting up matterbridge (see docs/compiling.md for compiling from source)
• Configuring matterbridge
• Running matterbridge (CLI or as a systemd service)

See docs/ folder in this repository.

You are welcome to submit pull requests, report bugs and request new features. matterbridge is a volunteer-run project and you are expected to behave with respect for the maintainers and other users. In particular, harassment and hate speech are not welcome.

For more development guidelines, see docs/development/.

This project is licensed under the GNU AGPLv3 license since after commit 20988f6446c6ad3ea416044712e634d3ed85ee53. It was relicensed following discussion in commmunity/#10. Apart from the obvious advantages of copyleft to promote innovation and cooperation, in very practical terms, we had to use either GPL or AGPL to include the whatsappmulti bridge in official builds and deprecate the broken legacy whatsapp bridge. When contributing to matterbridge development, you agree that your contributions will be published under that license.

Commits up-to 20988f6446c6ad3ea416044712e634d3ed85ee53 remain available under the looser Apache License 2.0.

Questions or want to test on your favorite platform? Join us on:

• federated networks: Jabber/XMPP, Matrix
• non-free centralized networks: Discord, Keybase, Slack, Telegram, Twitch
• self-hostable centralized networks: IRC, Mattermost, Rocket.Chat, Zulip

• jwflory/ansible-role-matterbridge (Ansible role to simplify deploying Matterbridge)
• matterbridge autoconfig
• matterbridge config viewer
• matterbridge-heroku
• mattermost-plugin - Run matterbridge as a plugin in mattermost
• isla (Bot for Discord-Telegram groups used alongside matterbridge)

Matterbridge wouldn't exist without amazing libraries, without @42wim who started the project, and without the 100+ contributors who participated in this adventure. See docs/credits.md for more complete credits.