tezlm/mautrix-discord
1
0
Fork 0
forked from mirror/mautrix-discord
Code Pull requests Activity
A Matrix-Discord puppeting bridge
60 commits 5 branches 13 tags 1.1 MiB
Go 98.8%
PLpgSQL 0.7%
Shell 0.3%
Dockerfile 0.2%
Find a file
Sumner Evans c22c71a831
config: add example config
2022-04-01 16:38:35 -06:00
bridge Use the guild bridge setting to bridge messages. 2022-03-29 08:08:17 -05:00
config config: username template should be lowercase 2022-04-01 16:38:35 -06:00
consts Initial scaffolding 2021-11-18 01:30:50 -06:00
database database/userquery: fix selects from user table 2022-04-01 16:36:55 -06:00
globals Initial scaffolding 2021-11-18 01:30:50 -06:00
registration Add a -f option to generate registration 2021-11-19 17:15:52 -06:00
remoteauth Add (dis|re)connect commands and provision api 2022-02-22 07:56:15 -06:00
run Basic provisioning api 2022-02-22 02:51:22 -06:00
version Initial scaffolding 2021-11-18 01:30:50 -06:00
.gitignore Initial database setup including migrations 2021-12-09 05:37:41 -06:00
example-config.yaml config: add example config 2022-04-01 16:38:35 -06:00
go.mod Update our dependencies 2022-03-16 20:53:12 -05:00
go.sum Update our dependencies 2022-03-16 20:53:12 -05:00
LICENSE Add the LICENSE file. 2021-11-19 16:32:06 -06:00
main.go Start of the run command and the bridge type 2021-11-20 04:59:52 -06:00
README.md Add a README.md 2022-02-11 04:35:30 -06:00

README.md

mautrix-discord

Getting Started

To get start with this bridge you first need to create the configuration file. You can do that by running ./discord generate-config. By default this will output to config.yaml. Edit this file as necessary.

Once you're done with the configuration file you need to generate the registration for the Synapse. To do so run ./discord generate-registration. This command will update your configuration file as well where necessary.

Now that you have a registration file, be sure to add it to the app_service_config_files in the homeserver.yaml file of your Synapse install. Once you've done this, make sure to reload or restart Synapse.

You are no ready to start the bridge with ./discord

From the Matrix client of your choice, create a direct message with @discordbot:localhost adjusting if you changed these settings in the config. This will be your management room with the bot.

From the management room you can now login to Discord with the login command. This will present you with a QRCode that you can scan with the Discord mobile application to login. For more detailed instructions, see the official documentation.

You should now be able to send an receive direct messages from both one on ones and group dms. However you can't currently create the dm, so you'll have to be invited while the bridge is running.

Status

Complete:

  • Login via QRCode
  • Message sending for DMs and Group DMs
  • Message editing for text bodies only (see notes about attachments below)
  • Unicode standard reactions (add/remove)
  • Message deleting
  • Username formatting
  • User avatars

Bugged:

  • Changing the room title of a group dm in discord is sent as a message.

Incomplete:

  • Attachments; most details including the database layout and database api are done.

Not started:

  • Double Puppeting
  • Enumerating DM list
  • Mentions needs to be parsed, they currently show up as <@!<userid> in the message body.
  • Custom emoji are not yet implemented. In message emoji show up as <:text:id>.
  • Custom emoji reactions are not yet implemented.
  • Additional bot commands like logout