Skip to content
/ graim Public

matrix <=> discord moderation with the power of matrix-appservice-discord

Notifications You must be signed in to change notification settings

luphoria/graim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

5b056dc · Apr 18, 2023
May 6, 2022
May 17, 2022
Apr 18, 2023
Apr 26, 2022
Apr 28, 2022
Apr 21, 2022
Apr 21, 2022
Jun 5, 2022
May 17, 2022
Apr 17, 2023
Apr 18, 2023
Jun 12, 2022
Apr 21, 2022
Apr 21, 2022

Repository files navigation

graim

matrix <=> discord moderation with the power of matrix-appservice-discord

Social

graim's website is viewable at gra.im. You can join the graim Matrix space as well as the Discord server. *the main matrix room is @ #general:gra.im

Configure/Install

Check out the configuration guide.

TODOs

  • Bug fixing
  • Better guides

Features

  • moderation syncs across rooms
  • Kick, ban + unban
  • Mute
  • Strike system
  • Automatically attribute moderation history to graimdb
  • Discord moderators may use whosent to discover what matrix user is behind a Discord message
  • Userinfo command
  • Database management commands (add/remove user, add/remove moderator)

How

graim is built with the intention of being Matrix-first. There are a few reasons for this:

  • Discord API sucks
  • Discord webhooks have incredibly little data attributed to them
  • I <3 Matrix

Every Discord user, via matrix-appservice-discord, is given its own user (i.e. @_discord_<discord_id>:matrix.org. So, graim listens for commands only from Matrix users - because Discord users are Matrix users by proxy. Simply tie a server to a group of rooms, then tie each Matrix user to a Discord account packaged in one "graim user" :D

Credits

The bot itself - luphoria

Any other contributors

Built with major help from turt2live/matrix-bot-sdk-bot-template by Travis Ralston

Uses the dependencies:

Special thanks: