PBEasy | PrivateBin Helper Dialog Script

Blog post from: Mon, 13 Apr 2026

I created a PrivatePasteBin Helper tool PBEasy (ppb, for short) based on pbcli for easy use of Pastes and Comments/Replies without the need to remember the Link (paste/key).

You can add Pastes to your favorite PrivateBin, or make comments to it for the first time using the 'ppb' tool, which automatically adds the new paste to the cache.

There is also a Profanity XMPP client (cli) plugin for easy integration with the /ppb command. Profanity MUST run inside a TMUX session to open the interactive mode window.

#PrivateBin #PasteBin #paste #CLI #tools

The PBEasy PrivateBin CLI helper

The PBEasy tool (or 'ppb' for short) is a PrivateBin helper tool, which caches used pastes for easy access, and shows a list of comments on a paste (if enabled) as a dialog with preview. You can reply to a comment or create a new comment with your favorite $EDITOR.

If you install the Profanity Plugin, you can directly reply to a paste from within Profanity. <TAB> is enabled to scroll through URLs. Usage: '/ppb [url]' or '/ppb' in the console window for interactive choose of a paste.

I won't show the installation instructions here, because you can have a look at the PBEasy Repository for instructions.

Features

Interactive use of the ppb command, when used without parameters and pipe
Create new PrivateBin pastes from files or stdin. These are automatically added to a local cache for easy access.
Upload attachments (images, files) with optional comments. Also automatically added to the cache.
Interactive comment/reply selection using dialog.
Reply to nested comments with preview and editing.
Clipboard integration: Automatically copies resulting URLs using xclip.
Uses your $EDITOR for editing comments and replies.
Customizable defaults via a config file.

Dependencies:

pbcli, jq, dialog, xclip,
'fold', 'mktemp', 'diff', 'cat', 'tee' (coreutils),
A text editor set in your $EDITOR environment variable (eg. nvim, vim, nano)

Short Usage:

ppb [-i] | [-u <FILE>|-c <URL>] [-d|-D] [-f <FORMAT>] [-s <HOST URL>] [-n <NAME>] | [-h]

[-i]: Create default configuration file
[-u <FILE>]: Upload file as an attachment. Images will be shown.
[-c <URL>]: Comment or reply to a comment of the Paste
[-d| -D]: Enable/Disable comments on a paste
[-s <HOST URL>]: Specify PrivateBin Host (default: https://pb.envs.net/)
[-n <NAME>]: Specify NAME for Paste URL to better find in list of pastes
[-h]: Show help

Use Issue Tracker

If you have any problems with ppb, use one of the Issue trackers:

License

This script is licensed under the GPL-3.0-only license. See LICENSE for details.

Final Words

I hope, that at least some people use these scripts, including the Profanity plugin and find it useful. Its a good help if you're often using PrivateBin paste bins from the command line. So please try it out.

Best wishes,
~dan

[Back to blog index] | [Homepage] | [To The Top]