A lightweight Python desktop application for creating temporary email addresses, receiving messages and automatically detecting verification codes.
- Address creation with 3 providers (mail.tm, Guerrilla Mail, 1secMail), with automatic provider switching if one fails ("Automatic" mode)
- Provider selector in Settings → General → "Mail provider" to choose based on your needs
- Inbox with search/filter by sender or subject
- Automatic verification code detection, with a customizable pattern (regular expression) from Settings
- Local message history per address, independent of the live inbox
- Desktop notifications that can be toggled on/off + optional sound
- System tray icon; the app can keep running in the background when the window is closed (configurable)
- Light or dark theme
- Spanish or English language, selectable from Settings
- Export an address (and its password, if applicable) to a text file
- Configurable auto-refresh and wait intervals
- Encryption at rest for the accounts file (Fernet/AES)
- Estimated expiration notice in the address list
| Provider | Best for | Duration |
|---|---|---|
| mail.tm (recommended default) | Use for days/weeks: 2FA, password recovery, future notifications, anything that needs to arrive tomorrow or next week | Days / weeks (depending on use) |
| Guerrilla Mail | Code NOW: quick sign-up, immediate verification, "I need the code right now" | ~60 min if unused (renews on request) |
| 1secMail | Backup if the two above fail or are slow | Indefinite (not published) |
The application is available in Spanish and English. You can change the language at any time from Settings → General → Language; the change applies instantly, without restarting the application.
git clone https://github.com/da2974/Gh0stMail.git
cd Gh0stMail
pip install -r requirements.txtWindows:
pythonw main.pyLinux / macOS:
python3 main.py| File/Folder | Description |
|---|---|
main.py |
Main window and interface logic |
dialogo_ajustes.py |
Settings modal window |
gestor_proveedores.py |
Provider selection and automatic failover (3 providers) |
proveedores/ |
Implementations for mail.tm, Guerrilla Mail and 1secMail |
tareas.py |
Network operations in threads (QThread) |
configuracion.py / almacenamiento.py |
JSON persistence (accounts encrypted with Fernet) |
notificaciones.py |
Desktop notifications via system tray (+ sound) |
utilidades.py |
Code detection, HTML→text, date formatting, expiration |
idiomas.py |
Interface text in Spanish and English |
tema_claro.qss / tema_oscuro.qss |
Stylesheets |
Contributions are welcome. If you'd like to propose a change:
- Fork the repository
- Create a branch for your change (
git checkout -b my-improvement) - Commit your changes
- Open a Pull Request
If you find it useful, you can buy me a coffee:
This project is licensed under the MIT License — see the LICENSE file for details.