Blquinn/Clipboard

✨🚀 Clipboard is the power tool that saves you time and effort. 🏖️🌴

Before, you've always had to think about where exactly you want to move things, which multiplied your mental workload and made many scenarios totally impractical.

Now, have a powerful clipboard to use anywhere in the terminal, just like a GUI!

Easy. Friendly to newbies and power users.
Breezy. Zero configuration needed to use.
Beautiful. Breaks the rules to look pretty.
Unified. Functions exactly the same everywhere.
Compatible. Works on anything that supports C++20.
Scriptable. Embed it right into your own programs.
Universal. Supports English, Spanish, Portuguese, and Turkish.
Integrated. Connects with many native GUI clipboards.
Tiny. Mere tens of kilobytes in size.
FOSS. 100% free and open-source.

All Except Windows

curl -sSL https://github.com/Slackadays/Clipboard/raw/main/src/install.sh | sh

Windows (run as Administrator)

(Invoke-WebRequest -UseBasicParsing https://github.com/Slackadays/Clipboard/raw/main/src/install.ps1).Content | powershell

Premade Builds

You can also download Clipboard directly from GitHub Actions.

Install Manually

Get the latest release instead by adding --branch 0.3.1 right after git clone.... Change the system installation prefix by adding -DCMAKE_INSTALL_PREFIX=/custom/prefix to cmake ...

git clone https://github.com/Slackadays/Clipboard 
cd Clipboard/build
cmake -DCMAKE_BUILD_TYPE=MinSizeRel ..
cmake --build .
cmake --install .

Uninstall

Remove all the files in install_manifest.txt. If you're not using Windows, you can also do xargs rm < install_manifest.txt.

You can substitute cb for clipboard in all commands, and add a number to the end of the action to choose which clipboard you want to use (the default is 0), or _ to use a persistent clipboard.

Cut clipboard ([--]cut|[-]ct)[(num)|_(id)] (file) [files]

Show Contents clipboard ([--]show|[-]sh)[(num)|_(id)]

Clear Contents clipboard ([--]clear|[-]clr)[(num)|_(id)]

Show Help Message clipboard (-h|[--]help)

Examples

cb copy foo.txt launchcodes.doc
clipboard cut1 MyDirectory
cb cp800 bar.conf AnotherDirectory baz.txt

Environment Variables

CI Set this to anything to make Clipboard overwrite existing items without a user prompt when pasting. This variable is intended for Continuous Integration scripts where a live human is not present to make decisions.

CLIPBOARD_TMPDIR Set this to the directory that only Clipboard will use to hold the items you cut or copy into a temporary directory.

CLIPBOARD_PERSISTDIR Set this to the directory that only Clipboard will use to hold the items you cut or copy into a persistent directory.

CLIPBOARD_ALWAYS_PERSIST Set this to anything to make Clipboard always use persistent clipboards.

CLIPBOARD_NOGUI Set this to anything to disable integration with GUI clipboards.

CLIPBOARD_SILENT Set this to anything to disable progress and confirmation messages from Clipboard.

FORCE_COLOR Set this to anything to make Clipboard always show color regardless of what you set NO_COLOR to.

NO_COLOR Set this to anything to make Clipboard not show any colors.

Flags

--clipboard (clipboard), -c (clipboard) Add this to choose which clipboard you want to use.

--fast-copy, -fc Add this to use links when copying, cutting, or pasting. If you modify the items that you used with this flag, then the items you paste will have the same changes.

Go to the Clipboard Wiki for more information, ask your questions in Clipboard Discussions, or join our Discord group!

Thank you to all the contributors who have helped make Clipboard great.

Blquinn / Clipboard