Discord Echobot

The purpose of this bot is to allow you to copy messages from one Discord channel to another Discord channel, even if you don't have permission to add a bot account to the guild you are copying from.

This is done by turning your own Discord account into a bot -- reading messages is done by you, copied messages are sent by a webhook.

NOTE: Using this (or any) self-bot is against Discord's Terms of Service — use at your own risk!

Requirements

To setup and run this bot, you must first install Node.js.

Setup

Download the latest release source code.
Extract the source code to a folder of your choosing.
Configure the bot by either:
- Creating a file called config.json in the extracted directory and filling it out. You can see config.example.json for an example.
- OR (You can do both but the config file will always take precedence).
- Pasting the entire config JSON (what would normally be in your file) into the environment variable ECHOBOT_CONFIG_JSON.
Open a command prompt or terminal in the extracted directory, and run npm install.

An Example of a config file

{
    "token": "mfa.yourtoken-shouldgoherejklsdfhsoiehfseihfseifbisoehfoisefise",
    "redirects": [
        {
            "sources": [
                "283746523864294373",
                "293786491642983642"
            ],
            "destinations": [
                {
                    "id": "780897979828797461",
                    "token": "AGZw.yourtoken-shouldgoherejklsdfhsoiehfseihfseifbisoehfoisefise"
                }
            ],
            "options": {
                "title": "New Copied Message",
                "richEmbed": true,
                "richEmbedColor": 30975,
                "includeSource": true,
                "removeEveryone": true,
                "removeHere": true,
                "copyRichEmbed": true,
                "copyAttachments": true,
                "accurateImage": true
            }
        }
    ],
    "filteredRedirects": [
        {
            "redirect": {
                "sources": [
                    "283746523864294373",
                    "293786491642983642"
                ],
                "destinations": [
                    {
                        "id": "129863219696239848",
                        "token": "AGZw.yourtoken-shouldgoherejklsdfhsoiehfseihfseifbisoehfoisefise"
                    }
                ],
                "options": {
                    "title": "New Copied Message",
                    "richEmbed": true,
                    "richEmbedColor": 30975,
                    "includeSource": true,
                    "removeEveryone": true,
                    "removeHere": true,
                    "copyRichEmbed": true,
                    "copyAttachments": true,
                    "accurateImage": true
                }
            },
            "words": [
                "Bot",
                "Test", 
                "Stocks"
            ],
            "ignoreQuote": true
        }
    ]
}

Options

title: Displayed at the top of each message. Optional.
- "title": "New Copied Message"
richEmbed: Whether or not to use rich embedding. Looks nicer, but has no support for displaying link metadata automatically (images, page details, etc). Users must click links instead.
- "richEmbed": true
richEmbedColor: The color for the border of the rich embed if richEmbed is true. To choose the color, get the hex value (like #0078ff) and then go to google and type "0x0078ff to decimal" -> the number you get is what you want.
- "richEmbedColor": 30975
includeSource: Whether to include a line at the top showing the nickname, guild, and channel of the author who sent the message.
- "includeSource": true
removeEveryone: Whether to remove all instances of @everyone in the messages. This prevents accidental mentioning.
- "removeEveryone": true
removeHere: Same as removeEveryone except for @here.
- "removeHere": true
copyRichEmbed: Sometimes a source message may include a rich embed of its own, with or without a normal, non-embed message. To copy to the rich embed message, this option must be true. The rich embed message will take precedence over the non-embed message. If that made no sense, juse keep this true.
- "copyRichEmbed": true
copyAttachments: When true, the attached file of a message (pdf, image, gif, etc.) will be copied into the new message.
- "copyAttachments": true
accurateImage: When true, (with copyAttachments) any link that discord automatically converts to image, will also be converted to an image

Filtered Redirects extra Options

words: Any message that will have any of these, will be redirected
ignoreQuote: Ignore messages that have quotes around it

Finding your Token

This Discord bot is called a "self-bot," meaning it runs as your personal Discord account rather than a separate bot account.

In order for this to work, you need to provide your Discord token in the config.json file. To find this token, follow these steps:

Open the Discord client on your computer.
Push Ctrl + Shift + I to open the dev tools (may be different on non-windows operating systems).
Go to the Network tab.
Go to any channel in any guild.
Click through the network requests that appear and search for the header authorization.
- You can usually ignore image requests.
Copy the value of the authorization header.
- It will look something like mfa.aasdkf--SDsdkfjhsdf_ewrh-msufeusefsbeouhue_W-34FsedFwEsr_SDFsufserF4_slhSDF432f

The token will now be on your clipboard and can be pasted into the config. Make sure there is only one set of quotation marks.

Finding Channel IDs

Redirect sources and destinations use Channel IDs, which look like large numbers. To find these, follow these steps:

Open the Discord client.
Go to User Settings.
Go to Appearance.
Scroll to the bottom and enable Developer Mode.
Close User Settings.
Right click on any channel (only text channels are supported, not voice) and select Copy ID.

The ID will now be on your clipboard and can be pasted into the config.

Run Locally

Open a command prompt or terminal in the extracted directory, and run npm start. You must have both node and npm installed.

ahmedwalid05/discord-echobot