<p align="center">
<a href="https://github.com/Jo0X01/TempMail-Generator">
<img src="https://raw.githubusercontent.com/Jo0X01/TempMail-Generator/refs/heads/main/TempMailGenerator.ico" alt="Temp Mail Generator" width="300" height="250">
</a>
</p>
<p align="center">
<a href="https://pypi.org/project/TempMailGenerator/">
<img src="https://img.shields.io/badge/-PyPi-blue.svg?logo=pypi&labelColor=555555&style=for-the-badge" alt="PyPi">
</a>
<a href="https://github.com/Jo0X01/TempMail-Generator">
<img src="https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge" alt="License: MIT">
</a>
</p>
# Temp Mail Generator
A lightweight **temporary email generator** built with Flask (Python) and a modern frontend. It allows you to quickly generate disposable email addresses, view incoming messages, and refresh your inbox automatically.
---
## Demo
You can try the live demo here:
**[View Demo on GitHub](https://htmlpreview.github.io/?https://github.com/Jo0X01/TempMail-Generator/blob/main/TempMailGenerator/index.html)**
---
## Features
- **Generate temporary emails** with one click
- **Read incoming messages** in a modern inbox interface
- Automatic inbox refresh every 10 seconds
- Copy email to clipboard
- Frontend with animated gradient UI
- Multiple API key fallback for reliability
- CLI support with `temp-mail` command after installation
---
## Prerequisites
- Python 3.0+
- pip (Python package manager)
- A [RapidAPI](https://rapidapi.com/) account with access to [Temp Mail 44 API](https://rapidapi.com/calvinloveland335703-0p6BxLYIH8f/api/temp-mail44)
---
## Installation
### From PyPI
```bash
pip install TempMailGenerator
```
or
```bash
pip3 install TempMailGenerator
```
### From Source
```bash
git clone https://github.com/Jo0X01/TempMail-Generator.git
cd TempMail-Generator
pip install -r requirements.txt
```
---
## Configuration
To edit your API keys and endpoints:
```bash
temp-mail --config
```
*(or `python main.py --config` if running from source)*
---
## Usage
### Start the server (recommended way)
```bash
python -m TempMailGenerator
```
### OR
```bash
temp-mail
```
### With custom options
```bash
temp-mail --host 0.0.0.0 --port 8080 --no-browser
```
### From source code
```bash
python main.py
```
---
## API Endpoints
### `GET /`
Serves the frontend interface (`./index.html`).
### `GET /generate`
Generates a new temporary email.
Example Response:
```json
{
"email": "example@domain.com",
"token": "hash_token"
}
```
### `GET /inbox?tk=<token>`
Fetches inbox messages for the generated email.
Example Response:
```json
{
"messages": [
{
"id": "msg123",
"from": "sender@example.com",
"subject": "Welcome!",
"body_text": "Hello World",
"created_at": "2025-09-04T10:00:00Z"
}
]
}
```
---
## License
This project is licensed under the **MIT License**.
Raw data
{
"_id": null,
"home_page": "https://github.com/jo0x01/TempMail-Generator",
"name": "TempMailGenerator",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.1",
"maintainer_email": null,
"keywords": "tempmail, tmail, email, mail, temporary-email, disposable-mail",
"author": "JoOx01",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/d4/65/16e001390d855af7924604a5d8abfefa3f325ab4f0d2891d5958799e0eb8/tempmailgenerator-1.0.7.tar.gz",
"platform": null,
"description": "<p align=\"center\">\r\n <a href=\"https://github.com/Jo0X01/TempMail-Generator\">\r\n <img src=\"https://raw.githubusercontent.com/Jo0X01/TempMail-Generator/refs/heads/main/TempMailGenerator.ico\" alt=\"Temp Mail Generator\" width=\"300\" height=\"250\">\r\n </a>\r\n</p>\r\n<p align=\"center\">\r\n <a href=\"https://pypi.org/project/TempMailGenerator/\">\r\n <img src=\"https://img.shields.io/badge/-PyPi-blue.svg?logo=pypi&labelColor=555555&style=for-the-badge\" alt=\"PyPi\">\r\n </a>\r\n <a href=\"https://github.com/Jo0X01/TempMail-Generator\">\r\n <img src=\"https://img.shields.io/badge/license-MIT-blue.svg?style=for-the-badge\" alt=\"License: MIT\">\r\n </a>\r\n</p>\r\n\r\n\r\n# Temp Mail Generator\r\n\r\nA lightweight **temporary email generator** built with Flask (Python) and a modern frontend. It allows you to quickly generate disposable email addresses, view incoming messages, and refresh your inbox automatically.\r\n\r\n---\r\n\r\n## Demo\r\n\r\nYou can try the live demo here: \r\n**[View Demo on GitHub](https://htmlpreview.github.io/?https://github.com/Jo0X01/TempMail-Generator/blob/main/TempMailGenerator/index.html)**\r\n\r\n---\r\n\r\n## Features\r\n\r\n- **Generate temporary emails** with one click\r\n- **Read incoming messages** in a modern inbox interface\r\n- Automatic inbox refresh every 10 seconds\r\n- Copy email to clipboard\r\n- Frontend with animated gradient UI\r\n- Multiple API key fallback for reliability\r\n- CLI support with `temp-mail` command after installation\r\n\r\n---\r\n\r\n## Prerequisites\r\n\r\n- Python 3.0+\r\n- pip (Python package manager)\r\n- A [RapidAPI](https://rapidapi.com/) account with access to [Temp Mail 44 API](https://rapidapi.com/calvinloveland335703-0p6BxLYIH8f/api/temp-mail44)\r\n\r\n---\r\n\r\n## Installation\r\n\r\n### From PyPI\r\n```bash\r\npip install TempMailGenerator\r\n```\r\n\r\nor\r\n\r\n```bash\r\npip3 install TempMailGenerator\r\n```\r\n\r\n### From Source\r\n```bash\r\ngit clone https://github.com/Jo0X01/TempMail-Generator.git\r\ncd TempMail-Generator\r\npip install -r requirements.txt\r\n```\r\n\r\n---\r\n\r\n## Configuration\r\n\r\nTo edit your API keys and endpoints:\r\n```bash\r\ntemp-mail --config\r\n```\r\n*(or `python main.py --config` if running from source)*\r\n\r\n---\r\n\r\n## Usage\r\n\r\n### Start the server (recommended way)\r\n\r\n```bash\r\npython -m TempMailGenerator\r\n```\r\n\r\n### OR\r\n\r\n```bash\r\ntemp-mail\r\n```\r\n\r\n### With custom options\r\n```bash\r\ntemp-mail --host 0.0.0.0 --port 8080 --no-browser\r\n```\r\n\r\n### From source code\r\n```bash\r\npython main.py\r\n```\r\n\r\n---\r\n\r\n## API Endpoints\r\n\r\n### `GET /`\r\nServes the frontend interface (`./index.html`).\r\n\r\n### `GET /generate`\r\nGenerates a new temporary email.\r\n\r\nExample Response:\r\n```json\r\n{\r\n \"email\": \"example@domain.com\",\r\n \"token\": \"hash_token\"\r\n}\r\n```\r\n\r\n### `GET /inbox?tk=<token>`\r\nFetches inbox messages for the generated email.\r\n\r\nExample Response:\r\n```json\r\n{\r\n \"messages\": [\r\n {\r\n \"id\": \"msg123\",\r\n \"from\": \"sender@example.com\",\r\n \"subject\": \"Welcome!\",\r\n \"body_text\": \"Hello World\",\r\n \"created_at\": \"2025-09-04T10:00:00Z\"\r\n }\r\n ]\r\n}\r\n```\r\n\r\n---\r\n\r\n## License\r\n\r\nThis project is licensed under the **MIT License**.\r\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A lightweight temporary email generator built with Flask (Python) and a modern frontend. It allows you to quickly generate disposable email addresses, view incoming messages, and refresh your inbox automatically.",
"version": "1.0.7",
"project_urls": {
"Homepage": "https://github.com/jo0x01/TempMail-Generator"
},
"split_keywords": [
"tempmail",
" tmail",
" email",
" mail",
" temporary-email",
" disposable-mail"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "4a1601dc4836162214bacd1e589779e0474d1c4826b06c417579aea5dfe7ef84",
"md5": "74b0f3ac275dcba4988ae4e79106d23d",
"sha256": "657521cc5644164792f6043929dc0e9d668eeb3b12f938bcfc530dd62e40d81a"
},
"downloads": -1,
"filename": "tempmailgenerator-1.0.7-py3-none-any.whl",
"has_sig": false,
"md5_digest": "74b0f3ac275dcba4988ae4e79106d23d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.1",
"size": 11777,
"upload_time": "2025-09-07T15:19:11",
"upload_time_iso_8601": "2025-09-07T15:19:11.952060Z",
"url": "https://files.pythonhosted.org/packages/4a/16/01dc4836162214bacd1e589779e0474d1c4826b06c417579aea5dfe7ef84/tempmailgenerator-1.0.7-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d46516e001390d855af7924604a5d8abfefa3f325ab4f0d2891d5958799e0eb8",
"md5": "45d99879c3c9e6cec213fe9fa30dba46",
"sha256": "9e2be3fad43435b4fee3002fdd7cf24e4c78b3ae0029abbc6ea6a25173e40db7"
},
"downloads": -1,
"filename": "tempmailgenerator-1.0.7.tar.gz",
"has_sig": false,
"md5_digest": "45d99879c3c9e6cec213fe9fa30dba46",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.1",
"size": 12268,
"upload_time": "2025-09-07T15:19:13",
"upload_time_iso_8601": "2025-09-07T15:19:13.051639Z",
"url": "https://files.pythonhosted.org/packages/d4/65/16e001390d855af7924604a5d8abfefa3f325ab4f0d2891d5958799e0eb8/tempmailgenerator-1.0.7.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-07 15:19:13",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "jo0x01",
"github_project": "TempMail-Generator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "flask",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "requests",
"specs": [
[
">=",
"2.28.0"
]
]
}
],
"lcname": "tempmailgenerator"
}
JSON
