Description

This role configures matterbridge chat bridging software.

Details

The software runs as a docker container from 42wim/matterbridge.

The configuration file template is in templates/matterbridge.yaml.j2.

Configuration

matterbridge_bridges:
  status:
    bridge:
      Nick: 'bridge.stateofus.eth'
      Token: '0x04abcXYZ...'
      RemoteNickFormat: '**{NICK}**@*{PROTOCOL}*: '

  discord:
    status-pub:
      Token: 'super-secret-token'
      Server: 'Status Community'
      RemoteNickFormat: '{NICK}@{PROTOCOL}'

matterbridge_gateways:
  - { status: "tech",   discord: [{ srv: "status-pub", ch: "tech" }] }
  - { status: "music",  discord: [{ srv: "status-pub", ch: "music" }] }
  - { status: "movies", discord: [{ srv: "status-pub", ch: "movies" }] }

You can also provide environment variables to the container:

matterbridge_cont_env:
  SUPER_SECRET_CREDENTIAL: 'hunter2'

API

To use the Matterbridge API it must be enabled with matterbridge_api_enabled: true. Currently only a single API (called api) is supported.

It can be used in a gateway like this:

- { discord: [{ srv: "vac", ch: "waku" }], api: ["api"]}

The API is running on port 4242 by default (matterbridge_api_port). More info about the API can be found on the Matterbridge wiki.

Known Issues

If your bridge is posting in a Discord channel but doesn't receive mesages from it you might have to adjust the channel-level permissions to give the bot message read rights.

Links

• https://github.com/42wim/matterbridge/blob/master/matterbridge.toml.sample
• https://github.com/42wim/matterbridge/wiki/How-to-create-your-config
• https://github.com/42wim/matterbridge/wiki/Settings
• https://notes.status.im/s/slack-bridge-bot-setup