Skip to content

Bridges

MindRoom uses mautrix bridges to connect external messaging platforms to Matrix. Bridges run as appservices alongside Synapse, creating ghost users for external contacts and relaying messages bidirectionally.

Available Bridges

Bridge Platform Mode Status
Telegram Telegram Puppet (login as yourself) Available
Slack Slack - Planned
Email IMAP/SMTP - Planned

How Bridges Work

Each bridge registers as a Matrix Application Service with Synapse. The bridge:

  1. Creates ghost users on Matrix for external contacts
  2. Creates Matrix rooms for external chats
  3. Relays messages between the external platform and Matrix in real time

In puppet mode, you log into your real account on the external platform. Your messages appear as coming from you on both sides, not from a bot.

Adding a New Bridge

  1. Create a config directory: telegram-bridge/, slack-bridge/, etc.
  2. Add the bridge service to compose.yaml
  3. Generate a registration file and mount it into Synapse
  4. Add the registration path to homeserver.yaml under app_service_config_files
  5. Restart Synapse and start the bridge