https://github.com/zebbern/cli-temp-mails
A CLI tool that creates/shows the inbox from 5 different temp-mail services
https://github.com/zebbern/cli-temp-mails
Last synced: 12 months ago
JSON representation
A CLI tool that creates/shows the inbox from 5 different temp-mail services
- Host: GitHub
- URL: https://github.com/zebbern/cli-temp-mails
- Owner: zebbern
- License: mit
- Created: 2025-05-03T17:29:01.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-05-05T01:11:24.000Z (about 1 year ago)
- Last Synced: 2025-06-16T06:55:03.897Z (12 months ago)
- Language: Python
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
TempMail Watcher
[](https://opensource.org/licenses/MIT)
[](https://www.python.org/downloads/)
[](https://github.com/psf/black)
> A professional CLI utility for managing temporary email inboxes in real-time. Polls your chosen service and displays incoming messages with rich formatting.
## Features
- **Multiple Service Support** - Works with GuerrillaMail, mail.tm, tempmail.lol, mail.gw, and dropmail.me
- **Rich Terminal UI** - Beautiful, colorful display with clear message formatting
- **Message History** - Save and review past messages
- **Configuration System** - Save your preferences between sessions
- **Cross-Platform** - Works on Windows, macOS, and Linux
## Installation
```bash
# Clone the repository
git clone https://github.com/zebbern/tempmail-watcher.git
cd tempmail-watcher
# Install dependencies
pip install -r requirements.txt
# Make the script executable (Unix-like systems)
chmod +x tempmail.py
```
## Usage
### Basic Usage
```bash
# Launch with interactive menu
python tempmail.py
# Specify a provider directly
python tempmail.py mail.tm
# Change polling interval (seconds)
python tempmail.py --poll 10 guerrillamail
```
### Advanced Options
```bash
# Use rush mode for tempmail.lol (faster address generation)
python tempmail.py tempmail.lol --rush
# Use plain text display mode
python tempmail.py --display plain
# Don't save messages to history
python tempmail.py --no-save
# View help information
python tempmail.py --help
```
## Supported Providers
| Provider | Features | Notes |
|----------|----------|-------|
| mail.tm | Full body text, HTML support | Fast, reliable |
| mail.gw | Full body text, HTML support | Alternative to mail.tm |
| GuerrillaMail | Text & HTML, attachments | Well-established service |
| tempmail.lol | Basic text messages | Fast with rush option |
| dropmail.me | Text & HTML messages | GraphQL API |
## Configuration
TempMail Watcher saves your preferences in `~/.config/tempmail-watcher/config.json`. Settings include:
- Default provider
- Polling interval
- Display mode (rich/plain)
- Message history options
## History & Message Export
Received messages are saved to `~/.config/tempmail-watcher/history.json`.
---
Developed with ❤️ by zebbern