Metadata-Version: 2.4
Name: delete-me-discord
Version: 1.9.0
Summary: Tool to mass delete your Discord messages and reactions with filters and retention controls.
Author-email: "Jan T. Müller" <mail@jantmueller.com>
License: MIT
Project-URL: homepage, https://github.com/janthmueller/delete-me-discord
Project-URL: documentation, https://janthmueller.github.io/delete-me-discord/
Project-URL: source, https://github.com/janthmueller/delete-me-discord
Project-URL: tracker, https://github.com/janthmueller/delete-me-discord/issues
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.0.0
Requires-Dist: rich<15,>=13
Dynamic: license-file

# Delete Me Discord
[![PyPI Latest Release](https://img.shields.io/pypi/v/delete-me-discord.svg)](https://pypi.org/project/delete-me-discord/)
[![Pepy Total Downloads](https://img.shields.io/pepy/dt/delete-me-discord)](https://pepy.tech/project/delete-me-discord)
[![GitHub License](https://img.shields.io/github/license/janthmueller/delete-me-discord)](https://github.com/janthmueller/delete-me-discord/blob/main/LICENSE)

**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](https://discord.com/terms). 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](https://github.com/janthmueller/delete-me-discord/releases/latest)
- `nix run github:janthmueller/delete-me-discord -- --help`

More installation details: [Installation docs](https://janthmueller.github.io/delete-me-discord/getting-started/installation/)

## Quick Start

Export your token first:

```bash
export DISCORD_TOKEN=<your_token>
```

You can obtain your token using [this guide](https://github.com/victornpb/undiscord/wiki/authToken).

Then discover targets safely:

```bash
dmd --list-guilds
dmd --list-channels
```

Preview a full wipe of one channel before executing it:

```bash
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:

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

Rolling retention:

```bash
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](https://janthmueller.github.io/delete-me-discord/)

Useful entry points:

- [First Run](https://janthmueller.github.io/delete-me-discord/getting-started/first-run/)
- [Full Channel Cleanup](https://janthmueller.github.io/delete-me-discord/guides/full-channel-cleanup/)
- [Rolling Retention](https://janthmueller.github.io/delete-me-discord/guides/rolling-retention/)
- [CLI Options](https://janthmueller.github.io/delete-me-discord/reference/cli-options/)
- [Log Output](https://janthmueller.github.io/delete-me-discord/reference/log-output/)

For GitHub Actions usage, see the example workflow repo:

- [delete-me-discord-workflow](https://github.com/janthmueller/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](LICENSE). You are free to use, modify, and distribute this software as per the terms of the license.
