Skip to content
KitploitKITPLOIT
ToolsBlog
Submit
ToolsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

··Feeds·Contact·Privacy·© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
tmpmail — A temporary email right from your terminal written in POSIX sh | Kitploit
Tools/GitHubGitHub/sdushantha/tmpmail
General Purpose UtilitiesPrivacyEmail Security
GitHubsdushantha/tmpmail

tmpmail

A temporary email right from your terminal written in POSIX sh

View Repository
4.2k16484 years agoReviewed by Kitploit

Most Popular

View all →

Discover the most used tools by our community.

Explore all tools

Browse our collection of tools

View all tools →
Share

A temporary email right from your terminal written in POSIX sh


tmpmail is a command line utility written in POSIX sh that allows you to create a temporary email address and receive emails to the temporary email address. It uses 1secmail's API to receive emails.

By default w3m is used to render the HTML emails on the terminal. But if you prefer another text based web browser or would rather view the email in a GUI web browser such as Firefox, simply use the --browser argument followed by the command needed to launch the web browser of your choice.




Dependencies

  • w3m
  • curl
Download Tool
  • jq
  • xclip
  • Installation

    Install locally

    root@kitploit:~
    # Download the tmpmail file and make it executable
    $ curl -L "https://raw.githubusercontent.com/sdushantha/tmpmail/master/tmpmail" > tmpmail && chmod +x tmpmail
    
    # Then move it somewhere in your $PATH. Here is an example:
    $ mv tmpmail ~/bin/
    

    AUR

    tmpmail is available on the AUR, which is currently being maintained by Benjamin Bädorf

    root@kitploit:~
    $ yay -S tmpmail-git
    

    Pacstall (Debian/Ubuntu)

    tmpmail is available on the pacstall-programs repository, which is being currently being maintained by wizard-28

    root@kitploit:~
    $ pacstall -I tmpmail-bin
    

    Nixpkgs

    tmpmail is also available in the nix package collection (only unstable currently), which is maintained by legendofmiracles

    Either add it to your system packages, install it with nix-env or try it out in a ephemeral nix-shell nix-shell -p tmpmail

    Docker

    requirements:

    • docker
    • clone this repo
    root@kitploit:~
    $ docker build -t mail .; # Dockerfile available in source code
    $ docker run -it mail;
    

    Usage

    root@kitploit:~
    $ tmpmail --help
    tmpmail
    tmpmail -h | --version
    tmpmail -g [ADDRESS]
    tmpmail [-t | -b BROWSER] -r | ID
    
    When called with no option and no argument, tmpmail lists the messages in
    the inbox and their numeric IDs.  When called with one argument, tmpmail
    shows the email message with specified ID.
    
    -b, --browser BROWSER
            Specify BROWSER that is used to render the HTML of
            the email (default: w3m)
        --clipboard-cmd COMMAND
            Specify the COMMAND to use for copying the email address to your
            clipboard (default: xclip -selection c)
    -c, --copy
            Copy the email address to your clipboard
    -d, --domains
            Show list of available domains
    -g, --generate [ADDRESS]
            Generate a new email address, either the specified ADDRESS, or
            randomly create one
    -h, --help
            Show help
    -r, --recent
            View the most recent email message
    -t, --text
            View the email as raw text, where all the HTML tags are removed.
            Without this option, HTML is used.
    --version
            Show version
    

    Examples

    Create random email

    root@kitploit:~
    $ tmpmail --generate
    [email protected]
    

    Create custom email

    root@kitploit:~
    $ tmpmail --generate [email protected]
    [email protected]
    

    View the inbox

    root@kitploit:~
    $ tmpmail
    [ Inbox for [email protected] ]
    
    83414443   [email protected]   Test Email
    

    View the email

    root@kitploit:~
    $ tmpmail 83414443
    

    View the most recent email

    root@kitploit:~
    $ tmpmail -r
    

    View emails as pure text

    root@kitploit:~
    $ tmpmail -t 83414443
    To: [email protected]
    From: [email protected]
    Subject: Test Email
    
    Hello World
    
    [Attachments]
    https://is.gd/aBCdEf [apple.jpg]
    https://is.gd/AbCDeF [ball.jpg]
    

    Credits

    This script is heavily inspired by Mitch Weaver's 1secmail script