temp mail

TempMail is a simple web application that allows you to generate temporary email addresses and view the emails received by these addresses.

334
63
CSS

TempMail V2 - Secure & Disposable Email Service πŸ“§

TempMail V2 Banner

GitHub Stars
GitHub Forks
GitHub Issues
GitHub License
Website Status

Protect your privacy with instant disposable email addresses

Live Demo | Report Bug | Request Feature

[!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.

Visitors

✨ Features

TempMail V2 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

HTML5
CSS3
JavaScript
Font Awesome
Responsive Design

  • Frontend: HTML5, CSS3 with custom variables for theming, JavaScript (ES6 Modules)
  • Icons & UI: Font Awesome 6.0, custom animations
  • APIs: Guerrilla Mail API for email operations
  • Storage: LocalStorage for user preferences and session management

πŸ–₯️ Live Demo

Experience TempMail V2 in action:

Live Demo

πŸ“Š Star History

πŸ› οΈ Installation & Setup

Prerequisites

  • A modern web browser
  • Optional: Node.js and NPM if using Live Server

Quick Start

  1. Clone the repository

    git clone https://github.com/mehmetkahya0/temp-mail.git
    
  2. Navigate to the project directory

    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:

    # 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.

// 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:

// 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 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 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


GitHub
LinkedIn
Email

πŸ‘ Acknowledgments

  • Guerrilla Mail for their robust temporary email API
  • Font Awesome 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.