Purgecord allows you to bulk delete messages in a Discord channel that contain specific words or phrases. It's designed to make message management easier by automating the deletion process.
- Bulk delete messages containing specific keywords in any channel or DM.
- Targeted deletion by channel ID.
- User authentication with a Discord token for secure access.
- Rate limit handling to ensure efficient API usage.
- Detailed logging of successful and failed deletions.
- Open Discord in your web browser and press
F12
to access the Developer Tools. - Navigate to the Network tab in the Developer Tools.
- Perform an action on Discord (e.g., send a message or open DMs) to capture a network request.
- Locate a request and click on it. In the Request Headers section, find the
Authorization
key and copy its value. This is your account token.
Important: Keep your token private, as it provides full access to your Discord account.
-
Clone this repository to your local machine:
git clone <repository_url> cd <repository_directory>
-
Install the required dependencies:
npm install
-
Create a
.env
file in the root directory and add your Discord token:TOKEN="YOUR_DISCORD_TOKEN"
-
Start the application:
node .
The tool will guide you through entering the specific word or phrase to delete and the channel/server ID.
After starting the application, you will be prompted to:
- What word would you like to bulk delete messages with?: Specify the word or phrase you'd like to search for and delete.
- In which channel would you like to bulk delete messages? (Enter channel ID): Provide the ID of the specific channel where you want to bulk delete messages.
The application will then scan for messages and begin deletion, handling rate limits to avoid overwhelming Discord's API.
- Token privacy: Your token is stored locally in the
.env
file and is never exposed publicly. Ensure you do not commit this file to version control.
If you have ideas to improve this tool or find any issues, feel free to submit a pull request or open an issue!
This project is licensed under the MIT License. See the LICENSE file for details.