A simple wrapper combining pbcopy & pbpaste in a single command.
npm install pb.sh
``text`
__
____ / /_
/ __ \/ __ \
/ /_/ / /_/ /
/ .___/_.___/
/_/
A tiny wrapper combining pbcopy & pbpaste in a single command.
Copy to or paste from the macOS / OS X clipboard / pasteboards. With no
input, pb prints the current contents of the clipboard to stdout using thepbpaste command. When input is passed via stdin or an argument, pb acts aspbcopy
a wrapper for , which in the simplest case means that it replaces thepb
clipboard contents with the input. also includes a pb --clear flag
to easily clear the macOS clipboard.
`bashsave the string "Example text." to the clipboard
> pb "Example text."
Installation
$3
To install with Homebrew:
`bash
brew install xwmx/taps/pb
`$3
To install with npm:
`bash
npm install -g pb.sh
`$3
To install with bpkg:
`bash
bpkg install xwmx/pb
`$3
To install manually, simply add the
pb script to your $PATH. If
you already have a ~/bin directory, you can use the following command:`bash
curl -L https://raw.github.com/xwmx/pb/master/pb \
-o ~/bin/pb && chmod +x ~/bin/pb
`Usage
`text
Usage:
pb [-pboard {general | ruler | find | font}] [-Prefer {txt | rtf | ps}]
pb [-pboard {general | ruler | find | font}]
pb --clear
pb --version
pb -h | --helpOptions:
--clear Clear the contents of all pasteboards.
-pboard Specify the pasteboard to copy to or paste from.
Default: general
-Prefer Specify what type of data to look for in the pasteboard first.
--version Print the current program version.
-h --help Show this screen.
Examples:
pb "Example text." Copy data specied with an argument.
echo "Example text." | pb Copy piped data.
pb Print contents of the clipboard / pasteboard.
More information:
Run
man pbcopy or man pbpaste.
`Background and Terminology
macOS refers to the clipboard as the pasteboard. There are multiple
pasteboards, with "general" as the default that is used when no
pasteboard is specified. The "general" pasteboard is also used in
Universal Clipboard.
Clipboard / Pasteboard Developer Documentation:
- Pasteboard | Apple Developer Documentation Archive
- NSPasteboard | Apple Developer Documentation
- NSPasteboardName | Apple Developer Documentation
Tests
To run the test suite, install Bats and
run
bats test` in the project root.