https://github.com/mehmetkahya0/temp-mail
TempMail is a simple web application that allows you to generate temporary email addresses and view the emails received by these addresses.
https://github.com/mehmetkahya0/temp-mail
ai algorithms api api-client api-rest api-server ascii chatgpt cursor github github-config html mail nodejs query temp temp-email temp-mail temp-mail-api temp-mail-website
Last synced: about 1 month ago
JSON representation
TempMail is a simple web application that allows you to generate temporary email addresses and view the emails received by these addresses.
- Host: GitHub
- URL: https://github.com/mehmetkahya0/temp-mail
- Owner: mehmetkahya0
- License: other
- Created: 2024-03-16T21:42:21.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-04-20T13:14:56.000Z (about 2 months ago)
- Last Synced: 2025-04-20T14:27:23.806Z (about 2 months ago)
- Topics: ai, algorithms, api, api-client, api-rest, api-server, ascii, chatgpt, cursor, github, github-config, html, mail, nodejs, query, temp, temp-email, temp-mail, temp-mail-api, temp-mail-website
- Language: CSS
- Homepage: https://mehmetkahya0.github.io/temp-mail/
- Size: 150 KB
- Stars: 333
- Watchers: 4
- Forks: 62
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/mehmetkahya0/temp-mail - Disposable emails (Mail / Other)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/mehmetkahya0/temp-mail - Disposable emails (Jump To / Mail)
README
# TempMail V2 - Secure & Disposable Email Service 📧
[](https://github.com/mehmetkahya0/temp-mail/stargazers)
[](https://github.com/mehmetkahya0/temp-mail/network/members)
[](https://github.com/mehmetkahya0/temp-mail/issues)
[](https://github.com/mehmetkahya0/temp-mail/blob/main/LICENSE)
[](https://mehmetkahya0.github.io/temp-mail/)
**Protect your privacy with instant disposable email addresses**
[Live Demo](https://mehmetkahya0.github.io/temp-mail/) | [Report Bug](https://github.com/mehmetkahya0/temp-mail/issues) | [Request Feature](https://github.com/mehmetkahya0/temp-mail/issues)
> [!IMPORTANT]
> ALL CODE FOR THIS WEBSITE IS COPYRIGHTED. YOU CANNOT USE THESE CODES AND OPEN ANOTHER WEBSITE IN THE SAME WAY. IT IS BEING TRACKED WITH VARIOUS TOOLS AND IF IT IS OPENED, A DMCA VIOLATION WILL BE SENT WITH MY LAWYER. SCANS ARE CARRIED OUT REGULARLY WITH VARIOUS TOOLS.
>
> PLEASE READ THE LICENSE
## 🎯 Overview
### I had 330+ stars and 25.000+ visitors on this project before, but for some reason I had to make the repo private. As of April 23, 2025, I made it public again and all the stars are gone.
TempMail V2 is a cutting-edge temporary email solution designed for privacy-conscious users. Generate disposable email addresses instantly to protect your primary inbox from spam, tracking, and unwanted communications. Built with modern web technologies, TempMail V2 offers a sleek, responsive interface with powerful features like real-time inbox updates, dark mode, and seamless email management.
## ✨ Features
- ⚡ **Instant Email Generation**: Create disposable emails with a single click
- 🔄 **Auto-Refresh Capability**: Keep your inbox updated automatically at customizable intervals
- 🔍 **Advanced Search**: Filter emails quickly by sender, subject, or content
- 🌓 **Light & Dark Themes**: Choose your preferred visual experience with theme persistence
- 📱 **Responsive Design**: Seamless experience across desktop, tablet, and mobile devices
- 🔒 **Privacy Focused**: No registration or personal information required
- 🚫 **Spam Protection**: Keep your primary inbox clean from unwanted communications
- 📎 **Attachment Support**: View and download email attachments securely
## 🚀 Tech Stack
- **Frontend**: HTML5, CSS3 with custom variables for theming, JavaScript (ES6 Modules)
- **Icons & UI**: Font Awesome 6.0, custom animations
- **APIs**: [Guerrilla Mail API](https://www.guerrillamail.com/) for email operations
- **Storage**: LocalStorage for user preferences and session management
## 🖥️ Live Demo
Experience TempMail V2 in action:
[](https://mehmetkahya0.github.io/temp-mail/)
## 📊 Star History
## 🛠️ Installation & Setup
### Prerequisites
- A modern web browser
- Optional: Node.js and NPM if using Live Server
### Quick Start
1. **Clone the repository**
```bash
git clone https://github.com/mehmetkahya0/temp-mail.git
```
2. **Navigate to the project directory**
```bash
cd temp-mail
```
3. **Launch with your preferred method:**
**Option 1:** Open index.html directly in your browser
**Option 2:** Use a local development server
If you have Node.js installed:
```bash
# Install Live Server globally
npm install -g live-server
# Start the server
live-server
```
4. **Access the application**
Open your browser and navigate to:
- `http://127.0.0.1:8080` (if using Live Server)
- or directly via the file:// protocol if opening index.html
## 📱 Usage Guide
### Creating a Temporary Email
1. When you first load the application, a random email address is automatically generated
2. Click the **"New Address"** button to generate a different disposable email
3. Use the **copy button** to easily copy the email address to your clipboard
### Managing Your Inbox
1. Click **"Load Mail"** to manually fetch new messages (or enable auto-refresh)
2. Use the search field to filter messages by sender, subject, or content
3. Click the **eye icon** on any email to view its complete contents
4. Remove unwanted emails with the **trash icon**
### Customizing Your Experience
1. **Toggle between light and dark mode** using the switch in the top-right corner
2. Enable **"Auto-refresh"** and select your preferred interval (10s, 30s, or 1m)
3. Access privacy policy and important information via the footer links
## 📂 Project Structure
```
temp-mail/
├── css/
│ └── style.css # Main stylesheet with theming and responsive design
├── js/
│ ├── api.js # API interactions and email functionality
│ ├── config.js # Configuration and constants
│ └── theme.js # Theme switching functionality
├── images/
│ ├── banner.png # Project banner image
│ ├── header.png # Header image
│ └── temp-mail-icon.png # Application icon
├── privacy/
│ ├── privacy.css # Privacy page styling
│ └── privacy.html # Privacy policy content
├── index.html # Main application entry point
├── manifest.json # PWA manifest file
├── robots.txt # Search engine directives
├── sitemap.xml # Site structure for search engines
├── LICENSE # MIT license with commercial restrictions
└── README.md # Project documentation
```
## ⚙️ Core Components
### Email Generation System
TempMail V2 uses a secure pseudorandom generation system to create unique email addresses. The system leverages the Guerrilla Mail API, ensuring high deliverability and compatibility with most services.
```javascript
// Email generation example (simplified)
const randomStr = Math.random().toString(36).substring(2, 8);
const domain = CONFIG.DOMAINS[Math.floor(Math.random() * CONFIG.DOMAINS.length)];
// Result: randomStr@domain
```
### Theme Engine
The application features a sophisticated theming system using CSS variables and JavaScript. User preferences are stored in localStorage for persistence across sessions:
```javascript
// Theme switching
if (darkMode) {
document.documentElement.setAttribute('data-theme', 'dark');
localStorage.setItem('theme', 'dark');
} else {
document.documentElement.setAttribute('data-theme', 'light');
localStorage.setItem('theme', 'light');
}
```
### Inbox Management
The inbox system provides real-time updates, efficient search capabilities, and intuitive email management:
- Auto-refresh with configurable intervals
- Full-text search across all email fields
- Modal-based email viewing with attachment support
- One-click email deletion
## 🔧 Customization Options
TempMail V2 is highly customizable to suit your needs:
1. **API Provider**
- Modify `CONFIG.API_BASE` in `js/config.js` to use a different email API provider
2. **Available Domains**
- Edit the `DOMAINS` array in `js/config.js` to add or remove email domains
3. **UI Theming**
- Customize the look and feel by modifying CSS variables in `css/style.css`
4. **Auto-Refresh Intervals**
- Add or modify refresh intervals in the HTML select options and handle them in JavaScript
## 🤝 Contributing
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.
1. Fork the Project
2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)
3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to the Branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request
See the [open issues](https://github.com/mehmetkahya0/temp-mail/issues) for a list of proposed features and known issues.
## 📜 License
This project is licensed under the Special License with specific commercial restrictions - see the [LICENSE](LICENSE) file for details.
**Important:** While you can use this project for personal and educational purposes, commercial use requires explicit permission from the project author.
## 👤 Author
[](https://github.com/mehmetkahya0)
[](https://linkedin.com/in/mehmet-kahya-0861a4286)
[](mailto:[email protected])
## 👏 Acknowledgments
- [Guerrilla Mail](https://www.guerrillamail.com/) for their robust temporary email API
- [Font Awesome](https://fontawesome.com/) for their comprehensive icon library
- All contributors who have helped improve this project
---
⚠️ **Disclaimer:** This project is purely for educational purposes. We do not allow illegal activities to be performed using this project and are not responsible for any incidents that may occur. Use it legally and responsibly.
