Discord Mirror

Make your account behave like a bot and mirror messages from a server to another (through webhooks).

Showcase

Original message (from server A):

Mirrored message (to server B):

Main Features

• Replace mentions and other content before mirroring a message.
• Disguise mirrored messages as the original author or use a custom webhook profile.
• Allow mirroring only messages containing specific keywords.
• Prevent specific users and roles from being mirrored.
• Support mirroring as many channels as you want to as many webhooks as you want.

How To Use

1. Install NodeJS.
2. Clone this repository.
3. Enter to the repository folder.
4. Run npm install to install the dependencies.
5. Run npm run compile to compile the bot.
6. Configure config.yml.
7. Run npm start to start the bot.

Configuration guide

Each option in config.yml is either self explanatory or has a comment above describing it:

# Token of the personal Discord account that will mirror messages.
# Learn how to find your account token here: https://www.androidauthority.com/get-discord-token-3149920/
token: "insert_your_token_here"

# Status of the account that will mirror messages.
# Available options: online, offline, idle, dnd.
#
# Note that you should not be logged into the account
# when the bot starts for this option to take effect.
status: "online"

# Message sent in the console when a message is mirrored.
# You can set this to "" to disable it.
logMessage: "[%date%] Mirrored @%author%'s message from %server% #%channel%."

mirrors:
   # The following contains a mirror with its options.
   # Every option inside the mirror is optional and can be removed from this file if not necessary.
   1:
      # You can find the ID of a channel by enabling the Developer mode in your
      # Discord account settings, then Right-Click -> Copy ID on the desired channel.
      # NOTE: You can also mirror categories and forums by using their IDs.
      channelIds:
         - "insert_channel_id_to_mirror_here"
      # Webhooks are used to send mirrored messages to specific channels.
      # You can create a webhook for a channel with: Edit channel -> Integrations -> Webhooks -> New webook.
      webhookUrls:
         - "insert_destination_webhook_url_here"
      ignoredUserIds:
         - "insert_user_id_not_to_mirror_here"
      ignoredRoleIds:
         - "insert_role_id_not_to_mirror_here"
      # Requirements that a message must meet to be mirrored.
      requirements:
         minEmbedsCount: 0
         minContentLength: 0
         minAttachmentsCount: 0
      options:
         # Whether to use the custom webhook profile picture and name to mirror messages.
         useWebhookProfile: false
         # Whether to remove attachments before mirroring a message.
         removeAttachments: false
         # Whether to mirror messages coming from bots.
         mirrorMessagesFromBots: true
         # Whether to mirror messages that are replies to other messages.
         mirrorReplyMessages: true
         # Whether to mirror messages when they are edited.
         mirrorMessagesOnEdit: false
      # Replacements to perform before mirroring a message.
      # The where: option is used to specify which part of a message
      # should be replaced. The available options are:
      #
      # everywhere, message_content, embed_author, embed_author_url,
      # embed_author_icon_url, embed_title, embed_description, embed_url,
      # embed_field_name, embed_field_value, embed_image_url, embed_thumbnail_url
      # embed_footer, embed_footer_icon_url, embed_color.
      replacements:
         1:
            replace: "insert_text_to_replace_here"
            with: "insert_replaced_text_here"
            where: "everywhere"
         # To replace mentions of @roles, @users or #channels, you have to replace their ids:
         # 2:
         #    replace: "insert_role_id_to_replace_here"
         #    with: "insert_replaced_role_id_here"
         #    where: "everywhere"
         #
         # To replace everything with a specific text, you can use the wildcard (*):
         # 3:
         #    replace: "*"
         #    with: "this_text_will_replace_everything"
         #    where: "everywhere"
      # Filter allows you to only mirror messages that contain or do not contain specific keywords.
      filter:
         # "whitelist": only mirror messages that contain at least one of the keywords.
         # "blacklist": only mirror messages that do not contain any of the keywords.
         # "none": do not filter messages.
         type: "none"
         keywords:
            - "insert_keyword_here"
         # The where option is used to specify where the filter should be applied.
         # The available options are: message, post_tag.
         where: "message"
   # You can create as many mirrors as you want, so that different
   # channels can be mirrored to different webhooks. For example:
   # 2:
   #   channelIds:
   #     - "insert_channel_id_to_mirror_here"
   #   webhookUrls:
   #     - "insert_destionation_webhook_url_here"

Docker Setup

If you wish to setup and use the bot via Docker, follow this steps:

1. Install Docker.
2. Clone this repository.
3. Enter the repository folder.
4. Configure config.yml (must be done before step 5).
5. Run docker build -t discord-mirror-bot . to build the Docker image.
6. Run docker run -d discord-mirror-bot to run the Docker image (this starts a container with your bot running inside it).

Disclaimer

Note that using a Discord self bot is against the Discord TOS, and i take no responsibility for any consequences that may arise from using it.