Selfbot for Matrix to allow cross client custom emojis and commands
Go to file
deadcade 1eaffb9393 Mutual rooms command 2022-08-30 16:00:06 +02:00
data Mutual rooms command 2022-08-30 16:00:06 +02:00
LICENSE Initial commit 2022-04-08 14:30:21 +00:00 Add translation to README 2022-08-27 16:31:37 +02:00 Mutual rooms command 2022-08-30 16:00:06 +02:00
requirements.txt Add libretranslatepy to requirements 2022-08-27 15:28:33 +02:00

DEADCADE's Matrix Selfbot

GitHub Repo stars


  • Install the required dependencies (pip install -r requirements.txt) Requires libolm setup
  • Configure settings and credentials in data/settings.json and data/credentials.json
  • Make sure the prefix is set to something that other bots aren't using
  • Run the bot (python3 (Starting the bot may take a couple minutes, depending on homeserver speed)


! is used here as a template prefix. This should be changed due to it being a common prefix and likely used by other bots. It is possible you might accidentally send a command to more than one bot.

  • !help: Guide on how to use commands
  • !ping: Ping the selfbot, or as the user behind the selfbot, ping a host.
  • !roll: Roll a dice
  • !xkcd: Get an xkcd and post it in chat
  • !shrug: Add ¯\_(ツ)_/¯ to the end of your message
  • !emoji_size: Set the default size for custom emojis
  • !emoji_list: Get a list of available emojis


Commands activated by users that aren't from the user itself are ratelimited, with a default of 1 command every 10 seconds. Commands activated by the user running the bot are not ratelimited.

Custom emojis

To use custom emojis, they must be added to the bot. Put any square image in the data/emojis/ directory. The image has to be square due to the resizing method used. Any image type that can be opened by Pillow, the Python image library, is supported. The name of the file is used as the name of the emoji. For example, the file kekw.png can be used as a custom emoji by typing :kekw: in chat. The bot does not need to reload for new emojis to be added.

To set a different size for a single emoji, use the syntax :emoji:size:. For example, :kekw:64: will put a 64x64 version of kekw.png in chat

To set the default size for emojis, use the emoji_size command.


By default, some kaomojis are added to data/textreplace.json. This json file contains a map of text the user types, and text to replace to. The text to be replaced has to be inside semicolons.

  • Example config: {"glasses": "(⌐■_■)"}
  • Example usage: ;glasses; which gets replaced with (⌐■_■)

Automatic translation

If libretranslatepy is installed (the bindings module, not libretranslate itself), reacting to a message with either a US or UK flag will attempt to translate that message to English.

  • libretranslatepy currently has a small issue, causing it to stop working on self hosted instances. Add method="GET" to line 63 in to fix.
  • If autodetecting languages does not work, react with the flag of the language you want to translate from.

Encrypted rooms

By default, the bot's session is not verified. Verification is required to view and participate in encrypted rooms. To verify it's session, any other verified client with the "Manually verify by text" feature can be used. Element Android (and possibly iOS) is the only client I have found to support manual verification by choice instead of defaulting to verifying by emoji.

Messages sent by selfbot

Any messages sent by this selfbot, like responses to commands, will include (SelfBot) (and if linked, the source code) at the end of the message. This is to help room moderators quickly identify why exactly a user account is responding automatically, and will hopefully give the user running the selfbot a chance to disable it in a specific room before being removed by moderators. This does not affect edited messages.

Support room

The support room can be found here. It is recommended to keep testing in this room or another private room, as it is unencrypted and does not clutter other rooms.