|email@example.com ecb18f926d Fix: go mod||1 week ago|
|.github||8 months ago|
|bridge||1 week ago|
|dstate||1 week ago|
|irc||1 week ago|
|.gitignore||2 years ago|
|LICENSE.md||2 weeks ago|
|Makefile||11 months ago|
|README.md||1 week ago|
|config.yml||4 months ago|
|go.mod||1 week ago|
|go.sum||1 week ago|
|main.go||1 week ago|
Is this being maintained? Who knows? You sure do ask a lot of questions. matterbridge by 42wim.
IRC -> Discordside of things work as you would expect it to: messages on IRC send to Discord as the bot user, as per usual.
Discord -> IRCside of things is a little different. On connect, this bot will join the server with the
~d, and spawn additional connections for each online person in the Discord.
(not a full list)
<you> Alex: yes, that's fineon IRC.
:somename:. Discord emoji shows up like that on IRC.
/me) on IRC.
Things to keep in mind in terms of functionality:
It's built with configuration in mind, but may need a little bit of tweaking for it to work for you:
separatorconfig options. The default options require custom modifications to the IRC server.
WEBIRCto give Discord users on IRC a distinct hostname. See here.
The binary takes three flags:
--config filename.yaml: to pass along a configuration file containing things like passwords and channel options
--simple: to only spawn one connection (the listener will send across messages from Discord) instead of a connection per online Discord user
--debug: provide this flag to print extra debug info. Setting this flag to false (or not providing this flag) will take the value from the config file instead
--insecure: used to skip TLS verification (false = use value from settings)
--no-tls: turns off TLS
The config file is a yaml formatted file with the following fields:
||Yes||The URL for the API to use to tell Discord what Avatar to use for a User when the user's avatar cannot be found at Discord already.|
||Yes||No||The bot user token|
||No||Yes||Filters messages from Discord to IRC when they match.|
||No||Yes||Filters messages from IRC to Discord when they match.|
||Yes||No||IRC server address|
||Yes||No||Used as a reference when PMing from Discord to IRC. Try to use short, simple one-word names like
||No||No||a dict with irc channel as key (prefixed with
||No||No||the Discord guild (server) id|
||Yes||Yes||password for connecting to the IRC server|
||Yes||appended to each Discord user's nickname when they are connected to IRC. If set to
||Yes||used in fallback situations. If set to
|fallback name** will be like
||The name of the irc listener|
||Sometimes||Yes||A list of Discord IDs to not relay to IRC|
||Yes||A list of Discord IDs to relay to IRC.
||No||username of discord account being puppeted||Yes||username to connect to irc with|
||No||Yes||optional, but recommended for regular (non-simple) usage. this must be obtained by the IRC sysops|
||Yes||Yes||list of commands for the listener IRC connection to execute (right before joining channels)|
||Yes||Yes||list of commands for each Puppet IRC connection to execute (right before joining channels)|
||Yes||false||Yes||TLS will skip verification (but still uses TLS)|
||Yes||false||Yes||turns off TLS|
||No||86400 (24 hours)||Yes||time in seconds for a discord user to be offline before it's puppet disconnects from irc|
||No||false||yes||displays JOIN, PART, QUIT, KICK on discord|
||No||30||yes||Maximum allowed nick length|
||No||Yes||A list of IRC users identified by hostmask to not relay to Discord, uses matching syntax as in glob|
||Yes||0||Yes||How many connections to IRC (including our listener) to spawn (limit of 0 or less means unlimited)|
The filename.yaml file is continuously read from and many changes will automatically update on the bridge. This means you can add or remove channels without restarting the bot.
An example configuration file can be seen in
config.yml. Those marked as
requires restart definitely
require restart, but others may not currently be configured to automatically update.
This bot needs permissions to manage webhooks as it creates webhooks on the go.
NEW IN 2020
Make sure you also give the bot application these intents too:
config.yml file to your needs. Then launch
docker build -t go-discord-irc . in the repository root
folder. And then
docker run -d go-discord-irc to run the bot in background.
A Makefile is provided to make getting started easier.
To build a binary run
make build this will produce a binary of
go-discord-irc in the root dir.
To build and run the binary run
make run, this will use the
config.yaml and start in debug.
To Execute tests run
Dependencies will be updated and installed with all the above commands or by running