it'll make your pasteboard awesome!
First thing to know about using CutBox yourself is that you'll need to compile it. If you need an out of the box solution, and you want new features that you don't want to add yourself, please move along to the next clipboard history app.
If you think compiling your own apps is a fun thing to do, keep reading. My project goals are now:
- Make this easy for you to compile on your own Mac.
My other goal is to only attract users who want to use CutBox in a plain-text / developer setting, any non-text pasteboard items are not in the scope of CutBox.
CutBox keeps your pasteboard cut/copy history and lets you paste anything back to your current app by searching for items.
What does it do? Let's you search from your pasteboard history....
- Make items favorite
- Select and paste multiple items as one
Download / install...
CutBox is Free OpenSource software. It isn't available via Apple's AppStore. or possible to download and install a CutBox.app. This is thanks to Apple's poorly thought through (or deliberately toxic to Open Source apps?) Gatekeeper / Notarization policy.
Any text you copy on MacOS is saved to CutBox's history.
CutBox Search is activated using a global hotkey:
Cmd + Shift + V
(This can be customized in preferences.)
Searching and pasting
When you activate CutBox you can search for anything copied, just type what you're searching for or navigate with the arrow keys (or mouse/trackpad).
Press Enter and the selected item will paste into your current app.
You can exit without pasting, just press Esc.
If fuzzy matching isn't specific enough for you, regexp matching is also available.
Press Cmd + s to toggle through search modes, fuzzy match, regexp/i or regexp.
Would you like to know more?
I'm moving more help and information to the project wiki, read more...
If you find a bug, click here to tell me what happened.
If you'd like to contribute to CutBox development, especially if you find bugs you'd like to fix, please follow the guidelines below.
- Pull requests should be covered by tests (Quick/Nimble or XCUITest)
- Code must pass the quality checks as used by Codacy
Compilation setup / tooling
The following tools were used to build CutBox. You will need them:
ruby- Used by cocoapods
npm/node- Used by
XCode Version 11.6 (11E708)
semver- Semantic version manager
npm install -g semver
gsort- GNU sort
brew install coreutils
Also, since assuming assumptions isn't great, to be clear you're going to be building on MacOS compatible with XCode 11.6 which has the following installed:
PListBuddy(You should beable to find it at
Clone and setup dependencies
Get the CutBox source via git:
git clone --recurse-submodules email@example.com:CutBox/CutBox
Once cloned, move to the cloned folder:
To build CutBox.app:
There's a Gitter channel if you have problems getting up and running (https://gitter.im/CutBox)
CutBox requires you to allow it access to keyboard control (it will simulate a Cmd+v to paste)
Go to System Preferences -> Security & Privacy -> Privacy -> Accessibility
Here you will need to set CutBox to allow Accessibility (unlock & check box) or it won't paste your selected clipboard item.
CutBox is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
CutBox is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.