gist/irc/matterbridge/matterbridge-example.toml

[general]
# @ makes MXIDs look better, Telegram needs it separately,
# probably just confuses networks without RELAYMSG and at least Kiwi pings
# on @nick. Labels can be shorter than protocol names (more descriptive in
# case of IRC and are ircCamelCase for benefit of IRC bots)
RemoteNickFormat = "@{NOPINGNICK}/{LABEL}: "
IgnoreFailureOnStart = true
MessageSplit = true
MediaDownloadPath = "/var/www/html/matterbridge"
MediaServerDownload = "https://etro.mikaela.info/matterbridge"
MediaDownloadSize = 20000000
MediaDownloadBlacklist = [".html$", ".htm$"]
replacemessages = [["@room", "@rööm"], ["@online", "@önline"]]
EditSuffix = " ✏️"
MessageClipped = "…"
UseLocalAvatar = ["irc"]

# This refers to https://ergo.chat/about
[irc.localergo]
Nick = "T4"
# Normal client would specify @freeformClientID, but with matterbridge that
# could result to flood from integrated bouncer
NickServNick = "T4"
NickServPassword = ""
Server = "localhost:6667"
UseTLS = false
UseSASL = true
Label = "ircEtro"
Charset = "utf8"
# sends join/quit/part from the integrated bouncer
IgnoreNicks = "HistServ"
RunCommands = ["OPER T4 MI-ne-DIRAS-do-AL-vin", "MODE T4 -iw+BET"]
# Requires the bot to be chanop, spoofs sender
UseRelayMsg = true
RemoteNickFormat = "{NICK}/{LABEL}"

[irc.freenode]
Nick = "T4"
NickServNick = "T4"
NickServPassword = ""
Server = "chat.ipv6.freenode.net:6697"
UseTLS = true
UseSASL = true
SkipTLSVerify = false
Label = "ircFn"
Charset = "utf8"
RunCommands = ["MODE T4 -iw+gQR"]

[irc.liberachat]
Nick = "T4"
NickServNick = "T4"
NickServPassword = ""
Server = "irc.libera.chat:6697"
UseTLS = true
UseSASL = true
SkipTLSVerify = false
Label = "ircLc"
Charset = "utf8"
RunCommands = ["MODE T4 -iw+gQR"]

[matrix.matrixexample]
Server = "https://matrix.example.org"
MxID = "@yournick.matterbridge:example.org"
# Above the clear cache & reload button. DON'T LOG OUT or it will be invalid.
# If leaked, login and remove the session from "Infosec & Privacy"
Token = "MEOW-MEOW_CHOCO-CHOW"
# Otherwise collision risk with UseUserName=true
NoHomeServerSuffix = false
# The Matrix logo "[m]" easens hitting up Discord maximum length so it's
# better to only have a single char label with the full MXID
Label = "m"
# Use Matrix ID instead of display name to avoid messages getting lost due
# to Ergo and Matterbridge disagreeing on invalid characters (e.g. LGBT* flag)
# https://github.com/ergochat/ergo/issues/1441
UseUserName = true
# Send everything as is, don't "cleverly" convert into HTML/Markdown which
# would break #channels (-> markdown h1 tag), mathematical equatons etc.
# The IRC equivalent would be `StripMarkdown`, but I consider it as
# more harmful than good
HTMLDisable = true

[mattermost.mattermostexample]
Server = "mattermost.example.org:443"
Team = "awesometeam"
Token = "abcdef123456"
PrefixMessagesWithNick = true
Label = "Mm"
# mattermost.example.org is presumably behind a remote proxy that
# suppresses non standards headers and thus breaks usual version check?
# https://github.com/42wim/matterbridge/wiki/Settings#skipversioncheck
SkipVersionCheck = true

[discord.discordexample]
Token = "nope"
Server = "123456789"
# When these are True, pinging from other platforms breaks
UseUsername = false
UseDiscriminator = false
Label = "D"
# Discord has webhooks so trailing space isn't required. Looks same as Ergo except has avatar
RemoteNickFormat = "{NICK}/{LABEL}"
# Allow mentioning users and roles, not everyone etc.
AllowMention = ["user", "role"]

[telegram.telegrambot]
Token = "nopenopenope"
Label = "T"
QuoteLengthLimit = 60
MediaConvertWebPToPNG = false
# Convert .tgs.webp (animated stickers) to webp
#MediaConvertTgs="webp"
# https://github.com/telegramdesktop/tdesktop/issues/6959 + Matrix homeservers become clickable links polluting links
RemoteNickFormat = "<code>@{NICK}/{LABEL}</code>: "
MessageFormat = "HTMLNick"
DisableWebPagePreview = true

[xmpp.example]
Server = "example.net:5222"
Jid = "matterbridge@example.net"
Password = "nonono"
Muc = "conference.example.net"
Nick = "M"
Label = "xmpp"

[[gateway]]
name = "redactedchanone"
enable = false

[[gateway.inout]]
account = "irc.freenode"
channel = "#redactedchanone"

[[gateway.inout]]
account = "irc.liberachat"
channel = "#redactedchanone"

[[gateway]]
name = "secretchan"
enable = true

[[gateway.inout]]
account = "irc.freenode"
channel = "##secretchan+"

[[gateway.inout]]
account = "irc.liberachat"
channel = "##secretchan+"

[[gateway.inout]]
account = "irc.localergo"
channel = "#secretchan+"

[[gateway]]
name = "test"
enable = "true"

[[gateway.inout]]
account = "irc.localergo"
channel = "#test"

[[gateway.inout]]
account = "irc.liberachat"
channel = "#test"

[[gateway.inout]]
account = "irc.freenode"
channel = "#test"

[[gateway.inout]]
account = "discord.discordexample"
# Get it by enabling developer mode from Discord settings and
# right-clicking the channel name
channel = "ID:121212123124618"
[gateway.inout.options]
WebhookURL = "https://discordapp.com/api/webhooks/..."

[[gateway.inout]]
account = "telegram.telegrambot"
# Get it by adding the bot to a group runtime and /chatId
channel = "-1001199999999"

[[gateway.inout]]
account = "mattermost.mattermostexample"
channel = "test"

[[gateway.inout]]
account = "matrix.matrixexample"
# Invite the bot account to a room and it will accept invite on start,
# alternatively use a room alias (but the server it refers to will need
# to be online). If using internal ID, remember to update it when
# performing /upgraderoom
channel = "!roomInternalIDFromAdvancedRoomSettings:example.org"

[[gateway.inout]]
account = "xmpp.example"
channel = "test"