printme

TUI print manager for Linux.

Demo

---

Requirements

You need CUPS and fzf installed and running:

Fedora / RHEL:

sudo dnf install cups fzf
sudo systemctl enable --now cups

Ubuntu / Debian:

sudo apt install cups fzf
sudo systemctl enable --now cups

Arch:

sudo pacman -S cups fzf
sudo systemctl enable --now cups

HP printer? Also install hplip:

# Fedora
sudo dnf install hplip

# Ubuntu
sudo apt install hplip

# Arch
sudo pacman -S hplip

Your printer also needs to be added to CUPS before using this script. If you haven't done that yet, open http://localhost:631 in a browser and add it from there, or check your distro's documentation.

---

Install

git clone https://github.com/jdias2019/printme.git
cd printme
chmod +x printme.sh

Then add it to your PATH:

# option 1 - ~/.local/bin (no sudo needed - best option)
mkdir -p ~/.local/bin
cp printme.sh ~/.local/bin/printme

# option 2 - /usr/local/bin
sudo cp printme.sh /usr/local/bin/printme

Make sure ~/.local/bin is in your PATH. Add this to your ~/.bashrc or ~/.zshrc if it isn't:

export PATH="$HOME/.local/bin:$PATH"

Then reload your shell:

source ~/.zshrc

---

Usage

printme                        # interactive TUI (you should run this, preferably, in the directory where the files you want to print are located)
printme file.pdf               # print a specific file
printme file1.pdf file2.pdf    # print multiple files
printme --help                 # show help (-h works too)

Note: Avoid naming it print — that's a built-in bash command and it won't work. You can rename the binary to whatever you prefer, e.g. cp printme.sh ~/.local/bin/myprint.

---

Troubleshooting

"No printers found" CUPS is either not running or no printer is configured yet.

sudo systemctl start cups
# then open http://localhost:631 to add your printer

"Something went wrong. Job not sent." Your printer might not support the option you selected. Run the script again and choose "Skip" for those options.

---