A collection of system hardening and generally-useful scripts for Linux systems. Targets Artix, works on any distro. Some inits require disabling the included boot parameter hardening, otherwise they won't boot (systemd)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

342 lines
13 KiB

#!/usr/bin/env sh
# by Siddharth Dushantha 2020
# Dependencies: jq, curl, w3m
# By default 'tmpmail' uses 'w3m' as it's web browser to render
# the HTML of the email
# If the value is set to 'true' tmpmail will convert the HTML email
# to raw text and send that to stdout
# Everything related to 'tmpmail' will be stored in /tmp/tmpmail
# so that the old emails and email addresses get cleared after
# restarting the computer
# TMPMAIL_EMAIL_ADDRESS is where we store the temporary email address
# that gets generated. This prevents the user from providing
# the email address everytime they run tmpmail
# tmpmail.html is where the email gets stored.
# Even though the file ends with a .html extension, the raw text version of
# the email will also be stored in this file so that w3m and other browsers
# are able to open this file
# Default 1secmail API URL
usage() {
# Using 'cat << EOF' we can easily output a multiline text. This is much
# better than using 'echo' for each line or using '\n' to create a new line.
cat <<EOF
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 (default: w3m) that is used to render the HTML of
the email
-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.
Show version
generate_email_address() {
# There are 2 ways which this function is called in this script.
# [1] The user wants to generate a new email and runs 'tmpmail --generate'
# [2] The user runs 'tmpmail' to check the inbox , but /tmp/tmpmail/email_address
# is empty or nonexistant. Therefore a new email gets automatically
# generated before showing the inbox. But of course the inbox will
# be empty as the newly generated email address has not been
# sent any emails.
# When the function 'generate_email_address()' is called with the arguement
# 'true', it means that the function was called because the user
# ran 'tmpmail --generate'.
# We need this variable so we can know whether or not we need to show the user
# what the email was. <-- More about this can be found further down in this function.
# This variable lets generate_email_address know if the user has provided a custom
# email address which they want to use. CUSTOM is set to false if $2 has no value.
# Generate a random email address.
# This function is called whenever the user wants to generate a new email
# address by running 'tmpmail --generate' or when the user runs 'tmpmail'
# but /tmp/tmpmail/email_address is empty or nonexistent.
# We create a random username by taking the first 10 lines from /dev/random
# and delete all the characters which are *not* lower case letters from A to Z.
# So charcters such as dashes, periods, underscore, and numbers are all deleted,
# giving us a text which only contains lower case letters form A to Z. We then take
# the first 10 characters, which will be the username of the email address
USERNAME=$(head /dev/urandom | LC_ALL=C tr -dc "[:alnum:]" | cut -c1-11 | tr "[:upper:]" "[:lower:]")
USERNAME_BLACK_LIST="- abuse\n- webmaster\n- contact\n- postmaster\n- hostmaster\n- admin"
DOMAINS="1secmail.com 1secmail.net 1secmail.org esiix.com wwjmp.com"
# Randomly pick one of the domains mentiond above.
DOMAIN=$(printf "%b" "$DOMAINS" | tr " " "\n" | randomize | tail -1)
# If the user provided a custom email address then use that email address
if [ "$CUSTOM" != false ]; then
# Check if the user is using username in the email address which appears
# in the black list.
if printf %b "$EMAIL_ADDRESS" | grep -Eq "$USERNAME_BLACK_LIST_REGEX"; then
print_error "For security reasons, that username cannot be used. Here are the blacklisted usernames:\n$USERNAME_BLACK_LIST"
# Do a regex check to see if the email address provided by the user is a
# valid email address
if ! printf %b "$EMAIL_ADDRESS" | grep -Eq "$VALID_EMAIL_ADDRESS_REGEX"; then
print_error "Provided email is invalid. Must match $VALID_EMAIL_ADDRESS_REGEX"
# Save the generated email address to the $TMPMAIL_EMAIL_ADDRESS file
# so that it can be whenever 'tmpmail' is run
# If this function was called because the user wanted to generate a new
# email address, show them the email address
[ "$EXTERNALLY" = true ] && cat "$TMPMAIL_EMAIL_ADDRESS" && printf "\n"
get_email_address() {
# This function is only called once and that is when this script
# get executed. The output of this function gets stored in $EMAIL_ADDRESS
# If the file that contains the email address is empty,
# that means we do not have an email address, so generate one.
[ ! -s "$TMPMAIL_EMAIL_ADDRESS" ] && generate_email_address
# Output the email address by getting the first line of $TMPMAIL_EMAIL
list_emails() {
# List all the received emails in a nicely formatted order
# Fetch the email data using 1secmail's API
DATA=$(curl -sL "$TMPMAIL_API_URL?action=getMessages&login=$USERNAME&domain=$DOMAIN")
# Using 'jq' we get the length of the JSON data. From this we can determine whether or not
# the email address has gotten any emails
DATA_LENGTH=$(printf %s "$DATA" | jq length)
# We are showing what email address is currently being used
# in case the user has forgotten what the email address was.
printf "[ Inbox for %s ]\n\n" "$EMAIL_ADDRESS"
# If the length of the data we got is 0, that means the email address
# has not received any emails yet.
[ "$DATA_LENGTH" -eq 0 ] && echo "No new mail" && exit
# This is where we store all of our emails, which is then
# displayed using 'column'
# Go through each mail that has been received
while [ $index -le "${DATA_LENGTH}" ]; do
# Since arrays in JSON data start at 0, we must subtract
# the value of $index by 1 so that we dont miss one of the
# emails in the array
MAIL_DATA=$(printf %s "$DATA" | jq -r ".[$index-1]")
ID=$(printf %s "$MAIL_DATA" | jq -r ".id")
FROM=$(printf %s "$MAIL_DATA" | jq -r ".from")
SUBJECT=$(printf %s "$MAIL_DATA" | jq -r ".subject")
# The '||' are used as a divideder for 'column'. 'column' will use this divider as
# a point of reference to create the division. By default 'column' uses a blank space
# but that would not work in our case as the email subject could have multiple white spaces
# and 'column' would split the words that are seperated by white space, in different columns.
index=$((index + 1))
# Show the emails cleanly
printf "%b" "$INBOX" | column -t -s "||"
randomize() {
# We could use 'shuf' and 'sort -R' but they are not a part of POSIX
awk 'BEGIN {srand();} {print rand(), $0}' | \
sort -n -k1 | cut -d' ' -f2
view_email() {
# View an email by providing it's ID
# The first argument provided to this function will be the ID of the email
# that has been received
DATA=$(curl -sL "${TMPMAIL_API_URL}?action=readMessage&login=$USERNAME&domain=$DOMAIN&id=$EMAIL_ID")
# After the data is retrieved using the API, we have to check if we got any emails.
# Luckly 1secmail's API is not complicated and returns 'Message not found' as plain text
# if our email address as not received any emails.
# If we received the error message from the API just quit because there is nothing to do
[ "$DATA" = "Message not found" ] && print_error "Message not found"
# We pass the $DATA to 'jq' which extracts the values
FROM=$(printf %s "$DATA" | jq -r ".from")
SUBJECT=$(printf %s "$DATA" | jq -r ".subject")
HTML_BODY=$(printf %s "$DATA" | jq -r ".htmlBody")
ATTACHMENTS=$(printf %s "$DATA" | jq -r ".attachments | length")
# If you get an email that is in pure text, the .htmlBody field will be empty and
# we will need to get the content from .textBody instead
[ -z "$HTML_BODY" ] && HTML_BODY="<pre>$(printf %s "$DATA" | jq -r ".textBody")</pre>"
# Create the HTML with all the information that is relevant and then
# assigning that HTML to the variable HTML_MAIL. This is the best method
# to create a multiline variable
<pre><b>To: </b>$EMAIL_ADDRESS
<b>From: </b>$FROM
<b>Subject: </b>$SUBJECT</pre>
if [ ! "$ATTACHMENTS" = "0" ]; then
while [ "$index" -le "$ATTACHMENTS" ]; do
FILENAME=$(printf %s "$DATA" | jq -r ".attachments | .[$index-1] | .filename")
HTML_LINK="<a href=$LINK download=$FILENAME>$FILENAME</a><br>"
if [ "$RAW_TEXT" = true ]; then
# The actual url is way too long and does not look so nice in STDOUT.
# Therefore we will shortening it using is.gd so that it looks nicer.
LINK=$(curl -s -F"url=$LINK" "https://is.gd/create.php?format=simple")
index=$((index + 1))
# If the '--text' flag is used, then use 'w3m' to convert the HTML of
# the email to pure text by removing all the HTML tags
[ "$RAW_TEXT" = true ] && /parsec/bin/psec-w3m -dump "$TMPMAIL_HTML_EMAIL" && exit
# Open up the HTML file using $BROWSER. By default,
# this will be 'w3m'.
view_recent_email() {
# View the most recent email.
# This is done by listing all the received email like you
# normally see on the terminal when running 'tmpmail'.
# We then grab the ID of the most recent
# email, which the first line.
MAIL_ID=$(list_emails | head -3 | tail -1 | cut -d' ' -f 1)
view_email "$MAIL_ID"
print_error() {
# Print error message
# The first argument provided to this function will be the error message.
# Script will exit after printing the error message.
printf "%b\n" "Error: $1" >&2
exit 1
main() {
# Iterate of the array of dependencies and check if the user has them installed.
# We are checking if $BROWSER is installed instead of checking for 'w3m'. By doing
# this, it allows the user to not have to install 'w3m' if they are using another
# browser to view the HTML
for dependency in jq $BROWSER curl; do
if ! command -v "$dependency" >/dev/null 2>&1; then
print_error "Could not find '$dependency', is it installed?"
# Create the $TMPMAIL_DIR directory and dont throw any errors
# if it already exists
mkdir -p "$TMPMAIL_DIR"
# Get the email address and save the value to the EMAIL_ADDRESS variable
# ${VAR#PATTERN} Removes shortest match of pattern from start of a string.
# In this case, it takes the EMAIL_ADDRESS and removed everything after
# the '@' symbol which gives us the username.
# ${VAR%PATTERN} Remove shortest match of pattern from end of a string.
# In this case, it takes the EMAIL_ADDRESS and removes everything until the
# period '.' which gives us the domain
# If no arguments are provided just the emails
[ $# -eq 0 ] && list_emails && exit
while [ "$1" ]; do
case "$1" in
--help | -h) usage && exit ;;
--generate | -g) generate_email_address true "$2" && exit ;;
--browser | -b) BROWSER="$2" ;;
--text | -t) RAW_TEXT=true ;;
--version) echo "$VERSION" && exit ;;
--recent | -r) view_recent_email && exit ;;
# If the user provides number as an argument,
# assume its the ID of an email and try getting
# the email that belongs to the ID
view_email "$1" && exit
-*) print_error "option '$1' does not exist" ;;
main "$@"