{"id":23387578,"url":"https://github.com/janthmueller/delete-me-discord","last_synced_at":"2026-05-01T10:00:53.147Z","repository":{"id":268473441,"uuid":"903925731","full_name":"janthmueller/delete-me-discord","owner":"janthmueller","description":"Tool to mass delete your Discord messages and reactions with filters and retention controls.","archived":false,"fork":false,"pushed_at":"2026-04-26T10:05:08.000Z","size":245,"stargazers_count":6,"open_issues_count":1,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-04-26T12:04:55.888Z","etag":null,"topics":["delete","delete-messages","discord","discord-api","discord-automation","python-3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/janthmueller.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-12-15T22:42:16.000Z","updated_at":"2026-04-26T10:05:12.000Z","dependencies_parsed_at":"2026-04-26T12:01:03.960Z","dependency_job_id":null,"html_url":"https://github.com/janthmueller/delete-me-discord","commit_stats":null,"previous_names":["janthmueller/delete-me-discord"],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/janthmueller/delete-me-discord","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janthmueller%2Fdelete-me-discord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janthmueller%2Fdelete-me-discord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janthmueller%2Fdelete-me-discord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janthmueller%2Fdelete-me-discord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/janthmueller","download_url":"https://codeload.github.com/janthmueller/delete-me-discord/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/janthmueller%2Fdelete-me-discord/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32492594,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["delete","delete-messages","discord","discord-api","discord-automation","python-3"],"created_at":"2024-12-22T01:58:47.000Z","updated_at":"2026-05-01T10:00:53.126Z","avatar_url":"https://github.com/janthmueller.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Delete Me Discord\n[![PyPI Latest Release](https://img.shields.io/pypi/v/delete-me-discord.svg)](https://pypi.org/project/delete-me-discord/)\n[![Pepy Total Downloads](https://img.shields.io/pepy/dt/delete-me-discord)](https://pepy.tech/project/delete-me-discord)\n[![GitHub License](https://img.shields.io/github/license/janthmueller/delete-me-discord)](https://github.com/janthmueller/delete-me-discord/blob/main/LICENSE)\n\n**Delete Me Discord** is a command-line tool for deleting your own Discord messages and reactions with explicit filters and retention controls.\n\n\u003e ⚠️ Using automated tools on Discord may violate Discord’s [Terms of Service](https://discord.com/terms). Use at your own risk.\n\n## What It Does\n\n- Deletes your own messages in DMs and guild text channels.\n- Optionally deletes your own reactions too.\n- Lets you scope runs by channel, guild, or parent/category ID.\n- Supports dry-run previews before making changes.\n- Supports rolling cleanup with time- and count-based preservation.\n- Can operate in a buffered per-channel mode for clearer timing output in manual runs.\n\n## Installation\n\nChoose one:\n\n- Python installs require Python 3.10 or newer.\n- `pipx install delete-me-discord`\n- `pip install delete-me-discord`\n- Download a prebuilt binary from the [latest release](https://github.com/janthmueller/delete-me-discord/releases/latest)\n\n## Quick Start\n\nExport your token first:\n\n```bash\nexport DISCORD_TOKEN=\u003cyour_token\u003e\n```\n\nYou can obtain your token using [this guide](https://github.com/victornpb/undiscord/wiki/authToken).\n\nThen discover targets safely:\n\n```bash\ndelete-me-discord --list-guilds\ndelete-me-discord --list-channels\n```\n\nPreview a full wipe of one channel before executing it:\n\n```bash\ndelete-me-discord --include-ids \u003cchannel_id\u003e --delete-reactions --preserve-n 0 --preserve-last 0 --dry-run\n```\n\nDrop `--dry-run` only after the plan looks right.\n\nIf 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.\n\n## Common Use Cases\n\nFull channel cleanup:\n\n```bash\ndelete-me-discord --include-ids \u003cchannel_id\u003e --delete-reactions --preserve-n 0 --preserve-last 0 --dry-run\n```\n\nRolling retention:\n\n```bash\ndelete-me-discord --preserve-last \"weeks=2\" --preserve-n 20 --fetch-max-age \"weeks=2,days=1\" --preserve-cache --dry-run\n```\n\n## Documentation\n\nThe full documentation lives at:\n\n- [janthmueller.github.io/delete-me-discord](https://janthmueller.github.io/delete-me-discord/)\n\nUseful entry points:\n\n- [First Run](https://janthmueller.github.io/delete-me-discord/getting-started/first-run/)\n- [Full Channel Cleanup](https://janthmueller.github.io/delete-me-discord/guides/full-channel-cleanup/)\n- [Rolling Retention](https://janthmueller.github.io/delete-me-discord/guides/rolling-retention/)\n- [CLI Options](https://janthmueller.github.io/delete-me-discord/reference/cli-options/)\n- [Log Output](https://janthmueller.github.io/delete-me-discord/reference/log-output/)\n\nFor GitHub Actions usage, see the example workflow repo:\n\n- [delete-me-discord-workflow](https://github.com/janthmueller/delete-me-discord-workflow)\n\n## Contributing\n\nContributions are welcome. Open an issue or pull request with improvements or bug fixes.\n\n## License\n\nThis 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.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanthmueller%2Fdelete-me-discord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjanthmueller%2Fdelete-me-discord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjanthmueller%2Fdelete-me-discord/lists"}