diff options
author | Parker <contact@pkrm.dev> | 2025-04-03 22:33:36 -0500 |
---|---|---|
committer | Parker <contact@pkrm.dev> | 2025-04-03 22:33:36 -0500 |
commit | 7ac5a8c0169d67f26db6a14f6a7c10fb8ed570a3 (patch) | |
tree | 41013df7df853004d3d9c19afd983c076be6c694 | |
parent | 75febd6cb2ecec29b6e562bc9f39239d98d8e184 (diff) |
Update info
-rw-r--r-- | README.md | 60 |
1 files changed, 58 insertions, 2 deletions
@@ -1,3 +1,59 @@ -# disarchive +<h1 align="center"> + DisArchive<br> +</h1> -Archive message history of Discord channels
\ No newline at end of file +<h3 align="center"> + Discord message archiver +</h3> + +<p align="center"> + <a href="https://github.com/Rapptz/discord.py/"> + <img src="https://img.shields.io/badge/discord-py-blue.svg" alt="discord.py"> + </a> + <a href="https://github.com/psf/black"> + <img src="https://img.shields.io/badge/code%20style-black-000000.svg" alt="Code Style: Black"> + </a> + <a href="https://makeapullrequest.com"> + <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg"> + </a> +</p> + +## Overview + +A *very* simple tool to archive messages and attachments from Discord channels. Downloads all message attachments as well as the message content and data into a SQLite/MySQL/PostgreSQL database. + +## Self-host +To run DisArchive, follow the steps below. + +1. Install Python 3 and Pip +2. Clone this repository +3. Install the requirements with `pip install -r requirements.txt` +4. Configure the `config.yaml` file with required information (more below) +5. Run `bot.py` + +## Configuration + +> [!NOTE] +> If a configuration option is labeled as optional, do not just use an empty value for that field, remove the field entirely from the config file. + +### BOT_INFO | REQUIRED +Field | Description | Requirement +--- | --- | --- +TOKEN | The token for your bot. Create a bot at [discord.com/developers](https://discord.com/developers) | **REQUIRED** - *message content intent is REQUIRED* +BOT_COLOR | `HEX CODE`: Color that will be used for message embeds | **OPTIONAL** + +### SQLITE | OPTIONAL +Field | Description | Requirement +--- | --- | --- +NAME | `STRING`: Name of the SQLite database file | **OPTIONAL** - *Default: `disarchive.db`* + +### MYSQL / POSTGRESQL | OPTIONAL +Field | Description | Requirement +--- | --- | --- +NAME | `STRING`: Name of the MySQL/PostgreSQL database | **OPTIONAL** - *Default: `disarchive`* +HOST | `STRING`: Hostname of the MySQL/PostgreSQL server | **OPTION** - *Default: `localhost`* +PORT | `INT`: Port of the MySQL/PostgreSQL server | **OPTIONAL** - *Default: `3306` for MySQL, `5432` for PostgreSQL* +USER | `STRING`: Username for the MySQL/PostgreSQL server | **REQUIRED** +PASSWORD | `STRING`: Password for the MySQL/PostgreSQL server | **REQUIRED** + +<br> |