TempMail is a Python-based application for generating temporary email addresses and receiving messages. It utilizes the mail.tm API to create disposable email accounts and fetch messages. The app features an intuitive CustomTkinter-powered graphical user interface (GUI) with theme switching and connection status monitoring.
- Temporary Email Generation – Create disposable email addresses for anonymous use.
- Inbox Management – View and read messages in your temporary inbox.
- Connection Status Monitoring – Monitor internet connectivity in real-time.
- Theme Switching – Toggle between dark and light UI themes.
Ensure the following are installed:
Python 3.10-3.12.7 (Python 3.13+ is not supported)
PillowrequestsCTkListboxtkinterwebcustomtkinter
Dependencies are listed in requirements.txt.
-
Clone the repository:
git clone https://github.com/AliJ-Programming/TempMail.git
-
Open CMD in TempMail directory.
-
Ensure an internet connection & Run the installation script:
Auto_Installer.bat
-
Select the Python version and wait for the installation to complete. You can activate the Virtual Environment immediately or manually later.
-
Activate the Virtual Environment:
.venv/Scripts/activate.bat
-
Run the program:
python TempMail.py
-
Alternatively, run the program without activating the Virtual Environment:
.venv/Scripts/python.exe TempMail.py
-
To deactivate the Virtual Environment:
deactivate
-
Clone the repository:
git clone https://github.com/AliJ-Programming/TempMail.git
-
Open CMD in TempMail directory.
-
Create and activate a Virtual Environment (recommended):
python -m venv .venv .venv/Scripts/activate.bat
-
Install dependencies:
pip install -r requirements.txt
-
Run the program:
python TempMail.py
-
Alternatively, run the program without activating the Virtual Environment:
.venv/Scripts/python.exe TempMail.py
-
To deactivate the Virtual Environment:
deactivate
- A temporary email address is generated and displayed upon launch.
- Regenerate a new email by clicking the refresh icon.
- Copy the email address using the copy button.
- Click an email in the inbox to view its contents.
- Generate Email – Automatically created at startup or upon request.
- Check Inbox – Inbox updates automatically.
- Open Messages – Click an email to view its full content.
- Regenerate Email – Generate a new email at any time.
- Theme Switcher – Toggle between Dark and Light UI themes.
- Internet Connection Monitoring – Displays online/offline status.
- Requires Internet – A stable connection is necessary for email generation and message retrieval.
- Third-Party Dependency – Relies on the mail.tm API, subject to its availability.
📂 TempMail
├── 📂 Icons/ # UI icons and images
├── 📂 Modules/ # Helper classes and modules
│ ├── 📄__init__.py # Python import modules manager
│ ├── 📄 UserAgents.py # User-agent handling module
│ └── 📄 Core.py # Core functionality module
├── 📄 Auto_Installer.bat # Auto-installer for Windows
├── 📄 Index.html # HTML file used in the UI
├── 📄 README.md # Project documentation
├── 📄 requirements.txt # Required dependencies
└── 📄 TempMail.py # Main application script
Want to contribute? Follow these steps:
- Fork the repository.
- Create a new branch for your feature or fix.
- Make your changes and commit them.
- Open a pull request.
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.
This project is licensed under the MIT License. See the LICENSE file for details.
Thanks for using TempMail! If you encounter issues or have suggestions, feel free to open an issue or contribute.