<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/TempMail-Generator/">
<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/TempMail_Generator/templates/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 TempMail-Generator
```
or
```bash
pip3 install TempMail-Generator
```
### 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)*
### Note
* by defualt if u add api keys via python code or via cli
* it will store them in temp_user_path/config.json
---
## Usage
### Start the server (recommended way)
```bash
python -m TempMail_Generator
```
### 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
```
## Python Code
```bash
from TempMail_Generator import TempMailGenerator
mail = TempMailGenerator()
# to configure the api
api_list = ["api_key_1","api_key_2"]
mail.add_api(api_list)
# just create temp mail
temp_mail = mail.generate()
# read inbox of created temp mail
json_inbox = temp_mail.read_inbox()
# start server
mail.start_server(True,"127.0.0.1",5555)
```
---
## License
This project is licensed under the **MIT License**.
Raw data
{
"_id": null,
"home_page": "https://github.com/jo0x01/TempMail-Generator",
"name": "TempMail-Generator",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.1",
"maintainer_email": null,
"keywords": "tempmail, tmail, email, mail, temporary-email, disposable-mail",
"author": "Jo0x01",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/2e/6a/e848144901bc393bebbdd9424b82ee95d9899c5bbe5cea850f0a0742fd7d/tempmail_generator-1.0.2.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/TempMail-Generator/\">\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/TempMail_Generator/templates/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 TempMail-Generator\r\n```\r\n\r\nor\r\n\r\n```bash\r\npip3 install TempMail-Generator\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### Note\r\n* by defualt if u add api keys via python code or via cli\r\n* it will store them in temp_user_path/config.json\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 TempMail_Generator\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## Python Code\r\n\r\n```bash\r\n\r\nfrom TempMail_Generator import TempMailGenerator\r\nmail = TempMailGenerator()\r\n\r\n# to configure the api\r\napi_list = [\"api_key_1\",\"api_key_2\"]\r\nmail.add_api(api_list) \r\n\r\n# just create temp mail\r\ntemp_mail = mail.generate()\r\n# read inbox of created temp mail\r\njson_inbox = temp_mail.read_inbox()\r\n\r\n# start server\r\nmail.start_server(True,\"127.0.0.1\",5555)\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.2",
"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": "fbeddf141776645f225e7ba2fab054f062c433d39c409e02497be939e7eab66d",
"md5": "2d55b788e431b27e2de5bdc52b271e8e",
"sha256": "d995bbf66de26870ce75e3949f9f18b9ae916d5103a47a97a50249bcca3d33e0"
},
"downloads": -1,
"filename": "tempmail_generator-1.0.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2d55b788e431b27e2de5bdc52b271e8e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.1",
"size": 7897,
"upload_time": "2025-09-08T23:22:06",
"upload_time_iso_8601": "2025-09-08T23:22:06.791883Z",
"url": "https://files.pythonhosted.org/packages/fb/ed/df141776645f225e7ba2fab054f062c433d39c409e02497be939e7eab66d/tempmail_generator-1.0.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2e6ae848144901bc393bebbdd9424b82ee95d9899c5bbe5cea850f0a0742fd7d",
"md5": "2e0c97f188d9c5d7110638d19f3a2763",
"sha256": "5aaf678434eb9b304d9bd1e8711365a92870008d22a77b0dde371b3303964ebe"
},
"downloads": -1,
"filename": "tempmail_generator-1.0.2.tar.gz",
"has_sig": false,
"md5_digest": "2e0c97f188d9c5d7110638d19f3a2763",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.1",
"size": 6503,
"upload_time": "2025-09-08T23:22:07",
"upload_time_iso_8601": "2025-09-08T23:22:07.938165Z",
"url": "https://files.pythonhosted.org/packages/2e/6a/e848144901bc393bebbdd9424b82ee95d9899c5bbe5cea850f0a0742fd7d/tempmail_generator-1.0.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-09-08 23:22:07",
"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": "tempmail-generator"
}
JSON
