PRIVATEBIN(1)

🦋 PRIVATEBIN(1) — the manual page, but make it cute 🦋

okay so this is the man page for privatebin, section 1 of the Privatebin Manual, and it's literally the bestie you needed for managing PrivateBin pastes right from your shell. no cap 💖

✨ NAME ✨

privatebin — manage privatebin pastes with a simple shell command 💅

✨ SYNOPSIS ✨

privatebin [-h | --help] [-v | --version] [--bin=<name>]
           [--config=<filename>] [--header=<key=value>]
           [--output=<format>] [--proxy=<url>]
           <command> [<args>]

✨ DESCRIPTION ✨

A minimalist, open source command line interface for PrivateBin instances. that's it, that's the whole vibe 🫶

---

✨ OPTIONS ✨

• -h, --help — show the help message. when you're lost, this is your emotional support flag 🥺
• -v, –version — prints the privatebin cli version. gotta know which era you're in ✨
• -b, --bin <name> — the privatebin instance name. pick your fave ✨
• -c, --config <path> — the path of the configuration file. when you don't set it, the CLI goes hunting through HOME/.config/privatebin/config.json, then XDG_CONFIG_HOME/privatebin/config.json, then the platform-native user configuration directory, and finally the directories listed in $XDG_CONFIG_DIRS (peep privatebin.conf(5) for the full deets). it's giving scavenger hunt 🔍
• -H, --header <key=value> — the extra HTTP header fields to include in the request sent. custom headers? iconic 👑
• -o, --output <format> — the output format can be "" or "json" (default ""). choose your fighter 💅
• --proxy <url> — proxy URL to use for requests. supports HTTP, HTTPS, and SOCKS5 schemes (e.g. socks5://127.0.0.1:9050 for TOR 🧅). this flag overrides the proxy value from the configuration file and the HTTP_PROXY, HTTPS_PROXY, and ALL_PROXY environment variables. main character energy fr fr

✨ COMMANDS ✨

• privatebin-create(1) — create a paste ✍️
• privatebin-show(1) — show a paste 👀

✨ EXIT STATUS ✨

the privatebin utility exits 0 on success, and >0 if an error occurs. zero means slay, anything bigger means 😭

✨ EXAMPLES ✨

create a paste on the default privatebin instance:

$ cat example.txt | privatebin create

create a paste through a SOCKS5 proxy (e.g. TOR):

$ cat example.txt | privatebin --proxy socks5://127.0.0.1:9050 create

---

✨ ENVIRONMENT ✨

• XDG_CONFIG_HOME — user-specific configuration directory. when it's set, the CLI searches this directory for privatebin/config.json (after checking $HOME/.config). see privatebin.conf(5) for the full search order. order matters, bestie 🎀
• XDG_CONFIG_DIRS — colon-separated list of system-wide configuration directories. defaults to /etc/xdg when not set. each directory is searched for privatebin/config.json.
• HTTP_PROXY, HTTPS_PROXY, ALL_PROXY — when no --proxy flag is provided and no proxy configuration value is set, the standard proxy environment variables are honored. so they're like the backup dancers 🕺
• NO_PROXY — a comma-separated list of host names or IP addresses for which the proxy should not be used. the "not today" list 🙈

✨ SEE ALSO ✨

• privatebin.conf(5)

✨ AUTHORS ✨

Bryan Frimin. 💜

---

and that's the whole page, bestie!! shoutout to version 2.2.1, dated Feb 15, 2026 — go forth and paste responsibly, mwah 😘💖🌸