Bash Cards: User Instructions

01 // What Are Bash Cards

Bash Cards are physical or digital QR codes that contain locked-in Bash scripts. Each card performs a specific function—system checks, network scans, install routines, or simulations. They are scanner-operated, keyboard-free tools for Linux environments.

02 // How To Use

Print a card using the Bash Card Creator
Use a 4×6 thermal shipping label printer and thermal paper
Launch a QR scanner from your Linux terminal (e.g. zbarcam)
Scan the card; the encoded script runs instantly

sample card QR

03 // Script Encoding

Each Bash Card QR is compiled from a script using the following compression and embedding method:

#!/bin/bash
[ $# -ne 1 ] && echo "Usage: $0 filename.sh" && exit 1
in="$1"
out="QR$(basename "$in")"
b64=$(gzip -c "$in" | base64 -w0)
echo 'bash -c "$(echo '$b64' | base64 -d | gunzip)"' > "$out"
echo "Created: $out"

04 // Decompile a Card

If you'd like to inspect or modify a card's script, scan the QR into a file, then extract it:

grep -oP '"\$\(echo .*?\)"' QRcard | \
sed -E 's/.*echo (.*) \| base64 -d \| gunzip.*/\1/' | \
base64 -d | gunzip > unpacked.sh

This will extract the original script to unpacked.sh for editing or review.

05 // Card Suits

♥ Hearts: Beginner Linux operations
♦ Diamonds: Package and config utilities
♣ Clubs: Network tools and monitors
♠ Spades: Security, scanning, reconnaissance

06 // Output Preview

$ ./ace-of-hearts.sh
[+] Checking system...
[+] Memory OK
[+] Storage OK
[+] CPU Temp Normal
[✔] Ready

07 // Print Cards

Use a 4×6 thermal shipping label printer. Bash Cards are designed to fit perfectly on thermal paper. This enables fast, inkless printing of durable cards for field or mobile use. Click "Print Card" to generate a printable QR sheet.

08 // Make & Save Cards

On the site, you can generate new cards using the Bash Card Creator. Choose suit, rank, enter script or prompt, preview it, then save it to your homepage for future access and printing.

09 // Bash ID Badge

The ID Badge is a special card that installs dependencies and registers your user name. Scan it first. It sets up your environment so all other cards can run cleanly and identify your instance.

10 // Tips

Scan in good lighting
Use high contrast QR cards
Have network access if the script pulls dependencies
Some cards require sudo

11 // More

View all decks and generate custom cards at studio.wizard.shoes