Dexportiti

This is a Discord bot written in python3 that aims to export every available information about a given server. The code itself uses discord.py and python>=3.10. This is because while Discord might seem a solid foundation to store information on, it poses a singular point of failure that could disappear overnight. With that all the moments I've had over the course of years would be gone, and I cannot let that happen.

Currently the bot is capable of exporting channel information, messages, reactions, user information, threads, and more mostly unimportant stuff. There is also a WIP bare-bones HTML/CSS/JS webUI that aims to recreate the server and show the exported information in a more pleasant way.

Running locally

installing requirements

To install the required python3 libraries run:

pip3 install -r requirements.txt

So far, this is solely discord.py.

running the bot

After that running the bot can be done by invoking:

python3 main.py

However, the code expects a settings.bin and a config.json file present. The latter consist of the following:

{
  "token" : "BOT-TOKEN-GOES-HERE",
  "archive-command" : "ARCHIVING-COMMAND",
  "admin-required" : true/false,
  "save-assets" : true/false
}

Whereas:

• "token" is the bot token the code will try to use. If you have no Discord application and/or don't know what that would be, you should refer to the Discord developer portal's Documentation.
• "archive-command" is the exact string that the bot will look for when it receives a message
• "admin-required" is whether the message sender must be admin, in order to start archiving. If true, it is required, and vice-versa.
• "save-assets" is whether or not to download discord assets and attachments to a local folder

Upon archival the bot will first create directory structure that will look like the following

<guild-id>
├── assets
├── attachments
└── emojis

Local webUI

Currently there is a bare-bones webUI that parses the locally saved data and displays it in your browser.

running the webUI

Any webserver that can serve documents and files from the root directory of this repository should serve, however for convenience the development is done with Python's SimpleHTTPServer. To run after the export, do

python3 -m http.server 8080

The 8080 part is the port it will be running on, if it interferes with other locally running web services, it can be replaced.

To visit the webpage hosting the archive, visit http://localhost:8080. Or alternatively, the desired port number after the colons.

Current capabilities (WIP)

• export of messages
  • sender
  • send/edit times
  • sender
  • replies
  • attachments
  • system messages
• export of users
  • account name discriminator
  • nickname
  • account creation date
  • account profile picture
  • user flags
  • member status
• export of channels
  • channel description
  • channel settings
  • voice
  • text
    • channel threads
    • channel messages
    • pins
• export of guild
  • name
  • banner + logo
  • settings
  • channels
  • categories
  • audit log (partial)
  • emojis
  • roles
• local export
  • JSON export
    • human readable
    • machine optimized
  • locally save asssets
    • attachments
    • profile pictures
    • emojis
    • stickers