How 42wim/matterbridge works
Matterbridge is a configurable chat-protocol bridge: operators configure accounts and channels, then messages and supported events pass from one platform adapter through gateway routing to other configured adapters. The repository also documents file handling, edits/deletes, threading, spoofing, private groups, multiple gateways, and an API for third-party integrations. The sampled handlers show adapters submitting normalized messages to the gateway; gateway routing is present in the tree, but its full dispatch logic was not sampled, so adapter-to-gateway routing links are documented at a high level.
Main entry points: gateway.go Gateway router · matterbridge.go Application entry · gateway/handlers.go Gateway handlers · discord/handlers.go Discord adapter
Components 20
Application setup
- Application entry
matterbridge.go - Configuration
bridge/config/config.go
Message routing
- Gateway router
gateway/gateway.go - Gateway handlers
gateway/handlers.go - Channel matching
gateway/samechannel/samechannel.go - Media storage
gateway/handlers.go
Protocol adapters
- Discord adapter
bridge/discord/handlers.go - IRC adapter
bridge/irc/handlers.go - Matrix adapter
bridge/matrix/matrix.go - Mattermost adapter
bridge/mattermost/handlers.go - Teams adapter
bridge/msteams/handler.go - Mumble adapter
bridge/mumble/handlers.go - Slack adapter
bridge/slack/handlers.go - Telegram adapter
bridge/telegram/handlers.go - WhatsApp adapter
bridge/whatsapp/handlers.go - WhatsApp multi
bridge/whatsappmulti/handlers.go - XMPP adapter
bridge/xmpp/handler.go
API integrations
- Bridge API
bridge/api/api.go
Other components
- Operator
- Third-party clients
Connections 30
- Operator → Application entry: starts
README.md - Application entry → Configuration: loads
matterbridge.go - Application entry → Gateway router: creates
matterbridge.go - Gateway router → Gateway handlers: delegates
- Gateway router → Channel matching: routes via
- Gateway handlers → Media storage: uploads files
gateway/handlers.go - Discord adapter → Gateway router: submits messages
- IRC adapter → Gateway router: submits messages
- Matrix adapter → Gateway router: submits messages
- Mattermost adapter → Gateway router: submits messages
- Teams adapter → Gateway router: submits messages
- Mumble adapter → Gateway router: submits messages
- Slack adapter → Gateway router: submits messages
- Telegram adapter → Gateway router: submits messages
- WhatsApp adapter → Gateway router: submits messages
- WhatsApp multi → Gateway router: submits messages
- XMPP adapter → Gateway router: submits messages
- Gateway router → Discord adapter: dispatches messages
- Gateway router → IRC adapter: dispatches messages
- Gateway router → Matrix adapter: dispatches messages
- Gateway router → Mattermost adapter: dispatches messages
- Gateway router → Teams adapter: dispatches messages
- Gateway router → Mumble adapter: dispatches messages
- Gateway router → Slack adapter: dispatches messages
- Gateway router → Telegram adapter: dispatches messages
- Gateway router → WhatsApp adapter: dispatches messages
- Gateway router → WhatsApp multi: dispatches messages
- Gateway router → XMPP adapter: dispatches messages
- Third-party clients → Bridge API: integrates via
README.md - Bridge API → Gateway router: uses bridge
bridge/api/api.go