{"id":27900474,"url":"https://github.com/zebbern/cli-temp-mails","last_synced_at":"2025-06-18T20:34:27.755Z","repository":{"id":291417188,"uuid":"977216329","full_name":"zebbern/cli-temp-mails","owner":"zebbern","description":"A CLI tool that creates/shows the inbox from 5 different temp-mail services","archived":false,"fork":false,"pushed_at":"2025-05-05T01:11:24.000Z","size":16,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-16T06:55:03.897Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zebbern.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,"zenodo":null}},"created_at":"2025-05-03T17:29:01.000Z","updated_at":"2025-05-17T19:51:48.000Z","dependencies_parsed_at":"2025-05-05T20:16:48.007Z","dependency_job_id":"5f11b9c6-d3bf-497a-91ec-daa76ea0c525","html_url":"https://github.com/zebbern/cli-temp-mails","commit_stats":null,"previous_names":["zebbern/cli-temp-mails"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/zebbern/cli-temp-mails","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fcli-temp-mails","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fcli-temp-mails/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fcli-temp-mails/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fcli-temp-mails/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zebbern","download_url":"https://codeload.github.com/zebbern/cli-temp-mails/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zebbern%2Fcli-temp-mails/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260629617,"owners_count":23038959,"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":[],"created_at":"2025-05-05T20:16:44.663Z","updated_at":"2025-06-18T20:34:22.741Z","avatar_url":"https://github.com/zebbern.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch2 align=\"center\"\u003eTempMail Watcher\u003c/h2\u003e \n\n\u003cdiv align=\"center\"\u003e\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)\n[![Python Version](https://img.shields.io/badge/python-3.7%2B-blue)](https://www.python.org/downloads/)\n[![Code Style: Black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n\n\u003c/div\u003e\n\n\u003e A professional CLI utility for managing temporary email inboxes in real-time. Polls your chosen service and displays incoming messages with rich formatting.\n\n![temp watcher](https://github.com/user-attachments/assets/c016d682-ede9-4619-853a-3ed90df97cae)\n\n## Features\n\n- **Multiple Service Support** - Works with GuerrillaMail, mail.tm, tempmail.lol, mail.gw, and dropmail.me\n- **Rich Terminal UI** - Beautiful, colorful display with clear message formatting\n- **Message History** - Save and review past messages\n- **Configuration System** - Save your preferences between sessions\n- **Cross-Platform** - Works on Windows, macOS, and Linux\n\n## Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/zebbern/tempmail-watcher.git\ncd tempmail-watcher\n\n# Install dependencies\npip install -r requirements.txt\n\n# Make the script executable (Unix-like systems)\nchmod +x tempmail.py\n```\n\n## Usage\n\n### Basic Usage\n\n```bash\n# Launch with interactive menu\npython tempmail.py\n\n# Specify a provider directly\npython tempmail.py mail.tm\n\n# Change polling interval (seconds)\npython tempmail.py --poll 10 guerrillamail\n```\n\n### Advanced Options\n\n```bash\n# Use rush mode for tempmail.lol (faster address generation)\npython tempmail.py tempmail.lol --rush\n\n# Use plain text display mode\npython tempmail.py --display plain\n\n# Don't save messages to history\npython tempmail.py --no-save\n\n# View help information\npython tempmail.py --help\n```\n\n## Supported Providers\n\n| Provider | Features | Notes |\n|----------|----------|-------|\n| mail.tm | Full body text, HTML support | Fast, reliable |\n| mail.gw | Full body text, HTML support | Alternative to mail.tm |\n| GuerrillaMail | Text \u0026 HTML, attachments | Well-established service |\n| tempmail.lol | Basic text messages | Fast with rush option |\n| dropmail.me | Text \u0026 HTML messages | GraphQL API |\n\n## Configuration\n\nTempMail Watcher saves your preferences in `~/.config/tempmail-watcher/config.json`. Settings include:\n\n- Default provider\n- Polling interval\n- Display mode (rich/plain)\n- Message history options\n\n## History \u0026 Message Export\n\nReceived messages are saved to `~/.config/tempmail-watcher/history.json`.\n\n---\n\n\u003cp align=\"center\"\u003e\n  Developed with ❤️ by \u003ca href=\"https://github.com/zebbern\"\u003ezebbern\u003c/a\u003e\n\u003c/p\u003e\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fcli-temp-mails","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzebbern%2Fcli-temp-mails","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzebbern%2Fcli-temp-mails/lists"}