Skip to content

TempMail is a Python-based GUI program that provides temporary email addresses and inbox management. It uses the mail.tm API to create disposable email accounts.

License

Notifications You must be signed in to change notification settings

AliJ-Official/TempMail

Repository files navigation

TempMail is a Python-based GUI program designed to provide users with temporary email addresses and inbox management. Built with simplicity and anonymity in mind, it leverages the mail.tm API to create disposable email accounts, making it perfect for signing up on websites or services without revealing your personal email.


✨ Key Features

  • Disposable Email Addresses – Instantly generate temporary email addresses for anonymous use.
  • Inbox Management – View and read emails in your temporary inbox with ease.
  • Real-Time Notifications – Get notified when a new email arrives. Click the notification to bring the program window to the top.
  • Email Ready Notification – Receive a notification when your temporary email is ready. Click it to copy the email address to your clipboard instantly.
  • Real-Time Connectivity Monitoring – Stay informed about your internet connection status.
  • Theme Support – Switch between light and dark themes for a personalized experience.

📸 Screenshots


📂 Project Structure

📂 TempMail/
├── 📂 Icons/             # Contains all UI icons and images
├── 📂 Modules/           
│   ├── 📄 __init__.py     # Python import modules manager
│   ├── 📄 TempMail_API.py # Handles application backend 
│   └── 📄 CoreB.py        # Core functionality module
├── 📂 Screenshots         # Contains UI Screenshots
├── 📄 AutoInstaller.bat   # AutoInstaller script for Windows
├── 📄 HomePage.html       # HomePage HTML file for UI
├── 📄 LICENSE  
├── 📄 README.md           # Project documentation
├── 📄 requirements.txt    # Lists all required dependencies
└── 📄 TempMail.py          # GUI application script

🛠️ Installation

🔹 Download the Release (Recommended)

  1. Visit the Releases page of this repository.
  2. Download the latest version of the program: TempMail_3.0.0_x64_Setup.exe
  3. Run the setup and follow the on-screen instructions to install the program.
  4. Once installed, you can launch the program from the Start Menu or Desktop shortcut.

🔹 Automatic Installation (For Developers)

  1. Clone the repository using this command:

    git clone https://github.com/AliJ-Official/TempMail.git
  • If you don't have git installed on your system, you can download the zip file from this link and follow the steps below.
  1. Navigate to the TempMail directory.

  2. Ensure you have an active internet connection and run the AutoInstaller.bat script.

  3. Follow the on-screen instructions to select your Python version and complete the installation.

  4. You can run the program immediately or launch it manually later.


🔹 Manual Installation (For Developers)

  1. Clone the repository using this command:

    git clone https://github.com/AliJ-Official/TempMail.git
  • If you don't have git installed on your system, you can download the zip file from this link and follow the steps below.
  1. Navigate to the TempMail directory.

  2. Open powershell or cmd in the TempMail directory.

  3. Create and activate a Virtual Environment (recommended):

    # Create a Virtual Environment
    python -m venv .venv
    
    # Activate it
    .venv/Scripts/activate.bat
  4. Install the required dependencies:

    pip install -r requirements.txt
  5. Run the program using:

    python TempMail.py
  6. To deactivate the Virtual Environment:

    deactivate
  • Alternatively, you can run the program without activating the Virtual Environment:
    .venv/Scripts/python.exe TempMail.py

🤝 Contributing

We welcome contributions! If you'd like to contribute to TempMail, follow these steps:

  1. Fork the repository.
  2. Create a new branch for your feature or bug fix.
  3. Commit your changes.
  4. Push your branch and open a pull request.

Please ensure your code follows the project's style and includes appropriate documentation.


🙏 Acknowledgments

This project includes code from CoreB, licensed under the MIT License.
CoreB is a lightweight and efficient concurrency management library that provides threading controllers, task execution, and queue management.
In this program, CoreB is used for managing background tasks, ensuring smooth and efficient asynchronous execution.


📜 License

TempMail is licensed under the MIT License. See the LICENSE file for more details.


Thank you for using TempMail! If you encounter any issues or have suggestions for improvement, feel free to open an issue or contribute to the project.