Discord Helper

A Python-based automation tool for Discord that enables mass messaging and user validation through Excel file integration. Built with security features including token encryption and network optimization.

Features

• Mass Messaging: Send bulk messages to Discord users via Excel file integration
• User Validation: Verify Discord user information and channel IDs
• Token Management: Secure token storage with multiple encryption options
• Excel Integration: Process user data from Excel spreadsheets
• Network Optimization: Built-in network fixes for improved connectivity

Security Features

• Password Encryption: High security option with PBKDF2 key derivation
• Passwordless Encryption: Average security using Fernet encryption
• No Encryption: Option for local-only usage
• Secure Token Storage: Encrypted token files with validation

Requirements

Install the required dependencies using:

pip install -r requirements.txt

Required Packages

• requests - HTTP requests for Discord API
• pandas - Excel file processing
• cryptography - Token encryption
• openpyxl - Excel file reading (implied dependency)

Installation

1. Clone or download the repository
2. Install dependencies: pip install -r requirements.txt
3. Run the application: python main.py

Usage

First Run Setup

1. Encryption Setup: Choose your preferred security method

   • Password encryption (recommended)
   • Passwordless encryption
   • No encryption

2. Token Registration: Login with your Discord credentials to generate and store tokens securely

Main Features

Mass Messaging

1. Select option [1] from the main menu
2. Provide Excel file with Discord usernames to message
3. The tool uses the master file (configured in settings) for username-to-channel ID mapping
4. Review the user list and confirm to send messages

User Validation

1. Select option [2] from the main menu
2. Provide Excel file with Discord users and channel IDs
3. The tool validates each user and displays their information

Configuration

Access the configuration menu [8] to:

• Set default correspondence file path
• Modify encryption settings
• Update application preferences

File Structure

Discord-Helper/
├── main.py              # Main application entry point
├── token_manager.py     # Discord token management
├── encryption.py        # Token encryption utilities
├── mass_message.py      # Bulk messaging functionality
├── id_validation.py     # User validation tools
├── id_grabber.py        # Excel data processing
├── network_fix.py       # Network optimization
├── config.json          # Application configuration
├── tokens/              # Encrypted token storage
└── requirements.txt     # Python dependencies

Excel File Format

Your Excel files should contain the following columns:

User List File

• discord_user: Discord usernames

Master/Correspondence File

• discord_user: Discord usernames
• channel_id: Discord channel IDs (DM channel IDs)

Configuration

The application creates a config.json file with the following structure:

{
    "version": "1.0.0",
    "master_file": "path/to/dhMaster.xlsx",
    "encryption": "password"
}

Security Notes

• Tokens are stored encrypted in the tokens/ directory
• Password-based encryption uses PBKDF2 with SHA-256 and 100,000 iterations
• Sensitive files are automatically excluded via .gitignore
• Network connections are optimized to prevent proxy/IPv6 issues

Troubleshooting

Common Issues

1. Missing Packages: The application will automatically detect and prompt for missing dependencies
2. Network Issues: Built-in network fixes handle most connectivity problems
3. Token Validation: Invalid tokens are automatically detected and can be updated
4. Excel Format: Ensure your Excel files have the correct column names

Error Messages

• [ERROR] Missing package: Run pip install -r requirements.txt
• [WARNING] Invalid JSON format: Check your token files for corruption
• ❌ Not a DM channel: Verify your channel IDs are for direct messages

Contributing

This tool is designed for educational and legitimate automation purposes. Please ensure compliance with Discord's Terms of Service when using this application.

Version History

• v1.0.0: Initial release with core functionality

Author

Created by not.thatguy

Disclaimer

This tool is for educational purposes. Users are responsible for complying with Discord's Terms of Service and applicable laws. Use responsibly and respect others' privacy and consent.