delete-me-discord 1.9.0

Tool to mass delete your Discord messages and reactions with filters and retention controls.

Delete Me Discord

Delete Me Discord is a command-line tool for deleting your own Discord messages and reactions with explicit filters and retention controls.

The installed CLI is available as delete-me-discord and the shorter alias dmd.

⚠️ Using automated tools on Discord may violate Discord’s Terms of Service. Use at your own risk.

What It Does

• Deletes your own messages in DMs and guild text channels.
• Optionally deletes your own reactions too.
• Lets you scope runs by channel, guild, or parent/category ID.
• Supports dry-run previews before making changes.
• Supports rolling cleanup with time- and count-based preservation.
• Can operate in a buffered per-channel mode for clearer timing output in manual runs.

Installation

Choose one:

• Python installs require Python 3.10 or newer.
• pipx install delete-me-discord
• pip install delete-me-discord
• Download a prebuilt binary from the latest release
• nix run github:janthmueller/delete-me-discord -- --help

More installation details: Installation docs

Quick Start

Export your token first:

export DISCORD_TOKEN=<your_token>

You can obtain your token using this guide.

Then discover targets safely:

dmd --list-guilds
dmd --list-channels

Preview a full wipe of one channel before executing it:

dmd --include-ids <channel_id> --delete-reactions --preserve-n 0 --preserve-last 0 --dry-run

Drop --dry-run only after the plan looks right.

If you want to share logs or screenshots, add --redact-sensitive. For example, --redact-sensitive 0 4 keeps only the last 4 characters of IDs while fully hiding names and local paths.

Common Use Cases

Full channel cleanup:

dmd --include-ids <channel_id> --delete-reactions --preserve-n 0 --preserve-last 0 --dry-run

Rolling retention:

dmd --preserve-last "weeks=2" --preserve-n 20 --fetch-max-age "weeks=2,days=1" --preserve-cache --dry-run

Documentation

The full documentation lives at:

• janthmueller.github.io/delete-me-discord

Useful entry points:

• First Run
• Full Channel Cleanup
• Rolling Retention
• CLI Options
• Log Output

For GitHub Actions usage, see the example workflow repo:

• delete-me-discord-workflow

Contributing

Contributions are welcome. Open an issue or pull request with improvements or bug fixes.

License

This project is licensed under the MIT License. You are free to use, modify, and distribute this software as per the terms of the license.