aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorParker <contact@pkrm.dev>2025-04-03 22:33:36 -0500
committerParker <contact@pkrm.dev>2025-04-03 22:33:36 -0500
commit7ac5a8c0169d67f26db6a14f6a7c10fb8ed570a3 (patch)
tree41013df7df853004d3d9c19afd983c076be6c694
parent75febd6cb2ecec29b6e562bc9f39239d98d8e184 (diff)
Update info
-rw-r--r--README.md60
1 files changed, 58 insertions, 2 deletions
diff --git a/README.md b/README.md
index 51ee517..8a64151 100644
--- a/README.md
+++ b/README.md
@@ -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>