{"id":15116893,"url":"https://github.com/mehmetkahya0/temp-mail","last_synced_at":"2025-07-11T14:08:56.093Z","repository":{"id":228094103,"uuid":"773143774","full_name":"mehmetkahya0/temp-mail","owner":"mehmetkahya0","description":"TempMail is a simple web application that allows you to generate temporary email addresses and view the emails received by these addresses.","archived":false,"fork":false,"pushed_at":"2025-04-20T13:14:56.000Z","size":154,"stargazers_count":333,"open_issues_count":0,"forks_count":62,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-20T14:27:23.806Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"https://mehmetkahya0.github.io/temp-mail/","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mehmetkahya0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-03-16T21:42:21.000Z","updated_at":"2025-04-20T13:14:59.000Z","dependencies_parsed_at":"2024-03-17T04:46:51.990Z","dependency_job_id":"a68d0969-dde9-4041-a55d-089b98af097f","html_url":"https://github.com/mehmetkahya0/temp-mail","commit_stats":null,"previous_names":["mehmetkahya0/temp-mail"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetkahya0%2Ftemp-mail","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetkahya0%2Ftemp-mail/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetkahya0%2Ftemp-mail/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mehmetkahya0%2Ftemp-mail/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mehmetkahya0","download_url":"https://codeload.github.com/mehmetkahya0/temp-mail/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254535829,"owners_count":22087399,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2024-09-26T01:45:22.770Z","updated_at":"2025-05-16T13:07:18.113Z","avatar_url":"https://github.com/mehmetkahya0.png","language":"CSS","funding_links":[],"categories":["Mail"],"sub_categories":["Other"],"readme":"# TempMail V2 - Secure \u0026 Disposable Email Service 📧\n\n\u003cdiv align=\"center\"\u003e\n  \n  ![TempMail V2 Banner](images/banner.png)\n\n  [![GitHub Stars](https://img.shields.io/github/stars/mehmetkahya0/temp-mail?style=for-the-badge\u0026logo=github\u0026color=yellow)](https://github.com/mehmetkahya0/temp-mail/stargazers)\n  [![GitHub Forks](https://img.shields.io/github/forks/mehmetkahya0/temp-mail?style=for-the-badge\u0026logo=github\u0026color=orange)](https://github.com/mehmetkahya0/temp-mail/network/members)\n  [![GitHub Issues](https://img.shields.io/github/issues/mehmetkahya0/temp-mail?style=for-the-badge\u0026logo=github\u0026color=red)](https://github.com/mehmetkahya0/temp-mail/issues)\n  [![GitHub License](https://img.shields.io/github/license/mehmetkahya0/temp-mail?style=for-the-badge\u0026logo=github\u0026color=blue)](https://github.com/mehmetkahya0/temp-mail/blob/main/LICENSE)\n  [![Website Status](https://img.shields.io/website?style=for-the-badge\u0026url=https%3A%2F%2Fmehmetkahya0.github.io%2Ftemp-mail%2F\u0026logo=googlechrome\u0026color=green)](https://mehmetkahya0.github.io/temp-mail/)\n\n  **Protect your privacy with instant disposable email addresses**\n\n  [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)\n\u003c/div\u003e\n\n\n\n\n\n\u003e [!IMPORTANT]  \n\u003e 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.\n\u003e\n\u003e PLEASE READ THE LICENSE\n\n\n\n## 🎯 Overview\n\n\n### 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. \n\nTempMail 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.\n\n\u003cdiv align=\"center\"\u003e\n\n  ![Visitors](https://api.visitorbadge.io/api/visitors?path=https%3A%2F%2Fgithub.com%2Fmehmetkahya0%2Ftemp-mail\u0026label=VISITORS\u0026labelColor=%23d9e3f0\u0026countColor=%23263759)\n\n\u003c/div\u003e\n\n## ✨ Features\n\n\u003cdiv align=\"center\"\u003e\n  \n  ![TempMail V2 Features](images/header.png)\n  \n\u003c/div\u003e\n\n- ⚡ **Instant Email Generation**: Create disposable emails with a single click\n- 🔄 **Auto-Refresh Capability**: Keep your inbox updated automatically at customizable intervals\n- 🔍 **Advanced Search**: Filter emails quickly by sender, subject, or content\n- 🌓 **Light \u0026 Dark Themes**: Choose your preferred visual experience with theme persistence\n- 📱 **Responsive Design**: Seamless experience across desktop, tablet, and mobile devices\n- 🔒 **Privacy Focused**: No registration or personal information required\n- 🚫 **Spam Protection**: Keep your primary inbox clean from unwanted communications\n- 📎 **Attachment Support**: View and download email attachments securely\n\n## 🚀 Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n  \n  ![HTML5](https://img.shields.io/badge/html5-%23E34F26.svg?style=for-the-badge\u0026logo=html5\u0026logoColor=white)\n  ![CSS3](https://img.shields.io/badge/css3-%231572B6.svg?style=for-the-badge\u0026logo=css3\u0026logoColor=white)\n  ![JavaScript](https://img.shields.io/badge/javascript-%23323330.svg?style=for-the-badge\u0026logo=javascript\u0026logoColor=%23F7DF1E)\n  ![Font Awesome](https://img.shields.io/badge/font%20awesome-%23339AF0.svg?style=for-the-badge\u0026logo=font-awesome\u0026logoColor=white)\n  ![Responsive Design](https://img.shields.io/badge/responsive-%23FF6C37.svg?style=for-the-badge\u0026logo=amp\u0026logoColor=white)\n  \n\u003c/div\u003e\n\n- **Frontend**: HTML5, CSS3 with custom variables for theming, JavaScript (ES6 Modules)\n- **Icons \u0026 UI**: Font Awesome 6.0, custom animations\n- **APIs**: [Guerrilla Mail API](https://www.guerrillamail.com/) for email operations\n- **Storage**: LocalStorage for user preferences and session management\n\n## 🖥️ Live Demo\n\nExperience TempMail V2 in action:\n\n\u003cdiv align=\"center\"\u003e\n  \n  [![Live Demo](https://img.shields.io/badge/LIVE%20DEMO-Visit%20TempMail%20V2-%233B82F6?style=for-the-badge\u0026logo=googlechrome\u0026logoColor=white)](https://mehmetkahya0.github.io/temp-mail/)\n  \n\u003c/div\u003e\n\n## 📊 Star History\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://star-history.com/#mehmetkahya0/temp-mail\u0026Date\"\u003e\n    \u003cpicture\u003e\n      \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://api.star-history.com/svg?repos=mehmetkahya0/temp-mail\u0026type=Date\u0026theme=dark\" /\u003e\n      \u003csource media=\"(prefers-color-scheme: light)\" srcset=\"https://api.star-history.com/svg?repos=mehmetkahya0/temp-mail\u0026type=Date\" /\u003e\n      \u003cimg alt=\"Star History Chart\" src=\"https://api.star-history.com/svg?repos=mehmetkahya0/temp-mail\u0026type=Date\" /\u003e\n    \u003c/picture\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\n## 🛠️ Installation \u0026 Setup\n\n### Prerequisites\n\n- A modern web browser\n- Optional: Node.js and NPM if using Live Server\n\n### Quick Start\n\n1. **Clone the repository**\n   ```bash\n   git clone https://github.com/mehmetkahya0/temp-mail.git\n   ```\n\n2. **Navigate to the project directory**\n   ```bash\n   cd temp-mail\n   ```\n\n3. **Launch with your preferred method:**\n\n   **Option 1:** Open index.html directly in your browser\n   \n   **Option 2:** Use a local development server\n   \n   If you have Node.js installed:\n   ```bash\n   # Install Live Server globally\n   npm install -g live-server\n   \n   # Start the server\n   live-server\n   ```\n\n4. **Access the application**\n   \n   Open your browser and navigate to:\n   - `http://127.0.0.1:8080` (if using Live Server)\n   - or directly via the file:// protocol if opening index.html\n\n## 📱 Usage Guide\n\n### Creating a Temporary Email\n\n1. When you first load the application, a random email address is automatically generated\n2. Click the **\"New Address\"** button to generate a different disposable email\n3. Use the **copy button** to easily copy the email address to your clipboard\n\n### Managing Your Inbox\n\n1. Click **\"Load Mail\"** to manually fetch new messages (or enable auto-refresh)\n2. Use the search field to filter messages by sender, subject, or content\n3. Click the **eye icon** on any email to view its complete contents\n4. Remove unwanted emails with the **trash icon**\n\n### Customizing Your Experience\n\n1. **Toggle between light and dark mode** using the switch in the top-right corner\n2. Enable **\"Auto-refresh\"** and select your preferred interval (10s, 30s, or 1m)\n3. Access privacy policy and important information via the footer links\n\n## 📂 Project Structure\n\n```\ntemp-mail/\n├── css/\n│   └── style.css              # Main stylesheet with theming and responsive design\n├── js/\n│   ├── api.js                 # API interactions and email functionality\n│   ├── config.js              # Configuration and constants\n│   └── theme.js               # Theme switching functionality\n├── images/\n│   ├── banner.png             # Project banner image\n│   ├── header.png             # Header image\n│   └── temp-mail-icon.png     # Application icon\n├── privacy/\n│   ├── privacy.css            # Privacy page styling\n│   └── privacy.html           # Privacy policy content\n├── index.html                 # Main application entry point\n├── manifest.json              # PWA manifest file\n├── robots.txt                 # Search engine directives\n├── sitemap.xml                # Site structure for search engines\n├── LICENSE                    # MIT license with commercial restrictions\n└── README.md                  # Project documentation\n```\n\n## ⚙️ Core Components\n\n### Email Generation System\n\nTempMail 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.\n\n```javascript\n// Email generation example (simplified)\nconst randomStr = Math.random().toString(36).substring(2, 8);\nconst domain = CONFIG.DOMAINS[Math.floor(Math.random() * CONFIG.DOMAINS.length)];\n// Result: randomStr@domain\n```\n\n### Theme Engine\n\nThe application features a sophisticated theming system using CSS variables and JavaScript. User preferences are stored in localStorage for persistence across sessions:\n\n```javascript\n// Theme switching\nif (darkMode) {\n    document.documentElement.setAttribute('data-theme', 'dark');\n    localStorage.setItem('theme', 'dark');\n} else {\n    document.documentElement.setAttribute('data-theme', 'light');\n    localStorage.setItem('theme', 'light');\n}\n```\n\n### Inbox Management\n\nThe inbox system provides real-time updates, efficient search capabilities, and intuitive email management:\n\n- Auto-refresh with configurable intervals\n- Full-text search across all email fields\n- Modal-based email viewing with attachment support\n- One-click email deletion\n\n## 🔧 Customization Options\n\nTempMail V2 is highly customizable to suit your needs:\n\n1. **API Provider**\n   - Modify `CONFIG.API_BASE` in `js/config.js` to use a different email API provider\n\n2. **Available Domains**\n   - Edit the `DOMAINS` array in `js/config.js` to add or remove email domains\n\n3. **UI Theming**\n   - Customize the look and feel by modifying CSS variables in `css/style.css`\n\n4. **Auto-Refresh Intervals**\n   - Add or modify refresh intervals in the HTML select options and handle them in JavaScript\n\n## 🤝 Contributing\n\nContributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\nSee the [open issues](https://github.com/mehmetkahya0/temp-mail/issues) for a list of proposed features and known issues.\n\n## 📜 License\n\nThis project is licensed under the Special License with specific commercial restrictions - see the [LICENSE](LICENSE) file for details.\n\n**Important:** While you can use this project for personal and educational purposes, commercial use requires explicit permission from the project author.\n\n## 👤 Author\n\n\u003cdiv align=\"center\"\u003e\n  \u003ca href=\"https://github.com/mehmetkahya0\"\u003e\n    \u003cimg src=\"https://github.com/mehmetkahya0.png\" width=\"100px;\" alt=\"Mehmet Kahya\" style=\"border-radius:50%\"/\u003e\n    \u003cbr /\u003e\n    \u003cb\u003eMehmet Kahya\u003c/b\u003e\n  \u003c/a\u003e\n\u003c/div\u003e\n\u003cbr /\u003e\n\u003cdiv align=\"center\"\u003e\n  \n  [![GitHub](https://img.shields.io/badge/github-%23121011.svg?style=for-the-badge\u0026logo=github\u0026logoColor=white)](https://github.com/mehmetkahya0)\n  [![LinkedIn](https://img.shields.io/badge/linkedin-%230077B5.svg?style=for-the-badge\u0026logo=linkedin\u0026logoColor=white)](https://linkedin.com/in/mehmet-kahya-0861a4286)\n  [![Email](https://img.shields.io/badge/Email-D14836?style=for-the-badge\u0026logo=gmail\u0026logoColor=white)](mailto:mehmetkahyakas5@gmail.com)\n  \n\u003c/div\u003e\n\n## 👏 Acknowledgments\n\n- [Guerrilla Mail](https://www.guerrillamail.com/) for their robust temporary email API\n- [Font Awesome](https://fontawesome.com/) for their comprehensive icon library\n- All contributors who have helped improve this project\n\n---\n\n\u003cdiv align=\"center\"\u003e\n  \n  ⚠️ **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.\n  \n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehmetkahya0%2Ftemp-mail","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmehmetkahya0%2Ftemp-mail","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmehmetkahya0%2Ftemp-mail/lists"}