Skip to content

janthmueller/delete-me-discord

Repository files navigation

Delete Me Discord

PyPI Latest Release Pepy Total Downloads GitHub License

Delete Me Discord is a CLI for deleting your own Discord messages and reactions with explicit filters and retention rules. The installed command 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.

It is built around a cautious workflow:

  • discover targets first
  • preview one explicit target with dmd clean --include-ids <channel_id> --dry-run
  • only then execute

Installation

Python installs require Python 3.10 or newer.

pipx install delete-me-discord

Other install paths:

  • pip install delete-me-discord
  • prebuilt binaries from the latest release
  • nix run github:janthmueller/delete-me-discord -- --help

More install details: Installation docs

Quick Start

Authenticate once:

dmd login

Discover targets:

dmd list guilds
dmd list channels

Preview one channel safely:

dmd clean --include-ids <channel_id> --dry-run

Then rerun without --dry-run when the plan looks right.

Alternative auth for one shell:

export DISCORD_TOKEN=<your_token>

If you need token extraction steps, use this guide.

Documentation

See the documentation for installation, first-run guidance, rolling retention, and the full CLI reference.

Contributing

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

License

Licensed under the MIT License.

About

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

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages