Skip to content

πŸš€ Generate temporary emails instantly with smart verification code extraction. Perfect for testing, privacy protection, and automated workflows. Real-time monitoring included.

License

Notifications You must be signed in to change notification settings

A-z-exe/temp-mail-generator

Repository files navigation

πŸ“§ Temp Mail Generator

License: MIT Python Mail.tm API Status GitHub Repo stars GitHub forks

Temporary email generator with headless/browser modes for testing and privacy.
A powerful Python tool for generating temporary email addresses using the Mail.tm API.
Perfect for testing, verification, and protecting your privacy online.


✨ Features

  • πŸš€ Instant Email Creation: Generate temporary email addresses in seconds
  • πŸ” Smart Code Detection: Automatically extracts verification codes from incoming emails
  • πŸ’Ύ Auto-Save: Saves verification codes and account information automatically
  • 🌐 Browser Integration: Optional web interface access
  • 🎨 Colorful Interface: Beautiful colored terminal output
  • ⚑ Real-time Monitoring: Continuously checks for new messages

⚑ Quick Start

# 1. Clone and install
git clone https://github.com/A-z-exe/temp-mail-generator.git
cd temp-mail-generator && pip install -r requirements.txt

# 2. Run the tool
python temp-mail-no-browser.py

# 3. Use the generated email for verification
# 4. Codes will be automatically saved to codes.txt

πŸ› οΈ Installation

  1. Clone the repository:

    git clone https://github.com/A-z-exe/temp-mail-generator.git
    cd temp-mail-generator
  2. Install required dependencies:

    pip install -r requirements.txt

πŸ“‹ Requirements

  • Python 3.6+
  • requests
  • colorama

πŸš€ Usage

Run the script:

python temp-mail-no-browser.py

What the tool does:

  1. Creates a temporary email using Mail.tm API
  2. Displays the email address for you to use
  3. Monitors incoming messages for verification codes
  4. Extracts codes automatically using smart pattern matching
  5. Saves everything to local files for easy access

Output Files:

  • codes.txt - Contains extracted verification codes
  • account_info.json - Stores account details and tokens

🎯 Use Cases

  • Account Verification: Use for signing up on websites
  • Testing: Perfect for developers testing email functionality
  • Privacy Protection: Avoid using your real email for one-time registrations
  • Automation: Integrate into automated testing workflows

πŸ†š Why Choose This Tool?

Feature This Tool Others
Auto Code Extraction βœ… ❌
Real-time Monitoring βœ… ❌
Browser Integration βœ… ❌
Colorful Interface βœ… ❌
JSON Export βœ… ❌
Free & Open Source βœ… ❌

πŸ“Έ Sample Output

πŸ”‘ Verification code found: ABC123
πŸ“§ New message: Your verification code from GitHub  
βœ… Email checking complete.
[+] Email created: temp123@mail.tm
[βœ“] Code ABC123 saved to codes.txt

πŸ”§ Troubleshooting

Q: No codes are being detected

  • Check if emails contain verification codes
  • Try manually entering the code when prompted

Q: Connection errors

  • Check your internet connection
  • Mail.tm API might be temporarily down

Q: Browser doesn't open

  • Make sure you have a default browser set
  • Try accessing https://mail.tm/ manually

πŸ”§ Configuration

The tool uses these default settings:

  • Password: Masoud@123 (for all generated accounts)
  • Monitoring Time: 60 seconds
  • Check Interval: 5 seconds

You can modify these in the script as needed.

πŸ“± Code Extraction Patterns

The tool automatically detects verification codes using multiple patterns:

  • verification code is XXXXXX
  • code is XXXXXX
  • verification code: XXXXXX
  • Standalone 6-character alphanumeric codes

🌐 Web Interface

The tool can optionally open the Mail.tm web interface in your browser, allowing you to:

  • View emails with full formatting
  • Read messages manually
  • Access advanced email features

⚠️ Important Notes

  • Temporary emails are automatically deleted after a period of inactivity
  • Don't use for important accounts - these emails are not permanent
  • The tool is for legitimate purposes only
  • Respect the terms of service of websites you're testing

🀝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ‘¨β€πŸ’» Author

AmirHossein Zarei

πŸ™ Acknowledgments

  • Thanks to Mail.tm for providing the free temporary email API
  • Built with Python and love ❀️

πŸ“Š Statistics

Python License Maintenance


⭐ If you find this tool useful, please give it a star! ⭐

Releases

No releases published

Packages

No packages published

Languages