DiscorDManager

A Docker-based wrapper tool for Discord Chat Exporter that helps manage and export Discord DMs efficiently.

Key Features:

• Batch processing with automatic resume support for interrupted exports
• Intelligent export status tracking (skips already-exported DMs)
• Configurable batch sizes with warnings for large batches (>40)
• Safe rate limiting with random delays
• DM state management (save/restore open DMs)
• Dry run mode for testing

Quick Start

Prerequisites

• Docker and Docker Compose installed
• Discord data package (download from Discord settings)
• Discord authorization token

Setup

1. Clone and navigate to repository:

git clone <repository-url>
cd discordmanager

2. Place your Discord data package:

Download your Discord data package from Discord settings, then:

Option A: Use default location (recommended)

# Extract your Discord data package to ./data/package/
# The folder should contain: messages/, account/, servers/, etc.

Option B: Custom location Edit docker-compose.yml to set your custom path:

volumes:
  - /path/to/your/discord-data-package:/data/package

Note: The data package needs write access for tracking DM state (id-history.json).

3. Build and run (first time):

./scripts/rebuild.sh
# This will build the image and test it

4. Launch the interactive menu:

./scripts/launch.sh

The setup wizard will:

• Verify your data package location (prompts if not found)
• Verify your Discord user ID matches the data package
• Request your Discord authorization token
• Allow you to proceed even if IDs don't match (with warning)

Usage

Quick start (recommended):

./scripts/launch.sh    # Interactive menu

Export specific users by username:

docker compose run --rm discordmanager -s username1 username2 "user three"

Export by user ID:

docker compose run --rm discordmanager -u 123456789 987654321

Export all DMs:

docker compose run --rm discordmanager --all

Show help:

docker compose run --rm discordmanager --help

Show examples:

docker compose run --rm discordmanager --examples

Scripts

Convenient scripts in the scripts/ folder:

• ./scripts/launch.sh - Launch interactive menu (auto-builds if needed)
• ./scripts/rebuild.sh - Clean rebuild from scratch
• ./scripts/clean.sh - Remove all containers and images
• ./scripts/stop.sh - Stop running containers

CLI Options

Options:
  -s, --username <username...>    Export DMs for specific Discord username(s)
                                  Multiple usernames can be space-separated
                                  Quote usernames with spaces: "User Name"
  -u, --user-id <id...>          Export DMs for specific Discord user ID(s)
  -a, --all                      Export all DMs (default behavior)
  -h, --help                     Show this help message
      --examples                 Show usage examples

Note: Only 1-on-1 DMs (type 1) are supported. Group DMs are not exported.

Output

Exported chat files appear in ./export/ directory on your host machine.

Configuration

All paths are managed by Docker volumes. Configuration menu (interactive mode) allows you to adjust:

• Dry run mode
• Batch size
• API delays
• Rate limits
• Suppress menu errors

Authentication credentials are stored in ./config/.env.

Troubleshooting

Rebuild Container from Scratch

If you encounter issues, rebuild the container:

# Remove containers and images
docker compose down
docker rmi discordmanager:latest

# Rebuild without cache
docker compose build --no-cache

# Test
docker compose run --rm discordmanager --help

Complete Docker Cleanup

If problems persist:

# Remove all stopped containers and dangling images
docker system prune -a

# Rebuild
docker compose build

Project Structure

discordmanager/
├── src/               # Source code
├── config/            # Configuration files (mounted)
├── export/            # Exported DMs (mounted)
├── logs/              # Application logs (mounted)
├── Dockerfile         # Docker image definition
└── docker-compose.yml # Docker Compose configuration

License

MIT