CutBox
it'll make your pasteboard awesome!
About 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....
What else...
- Make items favorite
- Select and paste multiple items as one
Anything else?
- You can send your pasted text through Javascript functions
Download / install...
You can find the latest release here: https://github.com/ocodo/CutBox/releases/latest
After downloading, open CutBox.dmg and drag CutBox.app to /Applications
To run, open /Applications (Cmd + A in Finder) and double click CutBox
Please note: Macos will give a security warning, that it was built by an unidentified developer. I'm that developer!
CutBox is Free OpenSource software. It isn't available via Apple's AppStore.
Using CutBox
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...
Bugs...
If you find a bug I'd love to hear about it, click here to tell me what happened.
Would you like CutBox to do something?
If you have an idea for a new feature please let me know here
Developers
If you'd like to contribute to CutBox development, 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
Development setup / tooling
Various tools are needed to build and release
- XCode 10.1
- Cocopods 1.6.1
- Carthage 0.32.0
Release tooling (for maintainer reference)
hub
- Github's git cli wrapperbrew install hub
semver
- Semantic version managernpm install -g semver
gsort
- GNU sortbrew install coreutils
cmark
- Markdown to HTMLbrew install cmark
sign_update
- Sparkle Update manager DSA signer for AppCast. (TODO: Upgrade signing)mustache
- Template system (gem install mustache
, or equivalent npm package)
Also, assuming assumptions are not great, you're building on MacOS compatible with XCode 10.1 which has the following installed:
git
2.20.1osascript
unexpand
PListBuddy
(You should be able to find it at/usr/libexec/PlistBuddy
)
Clone and setup dependencies
CutBox depends on Cocoapods to manage most dependencies, however it also depends on KeyHolder and Magnet (from Clipy)
To properly clone, use the --recurse-submodules
option. i.e.
git clone --recurse-submodules git@github.com:CutBox/CutBox
- Install Cocoapods:
pod install
- (run from
./CutBox/Cutbox
)
- (run from
- Bootstrap Carthage:
carthage bootstrap
- (run from
CutBox/CutBox/DependencySubmodules/KeyHolder
) - This will build the Magnet & KeyHolder frameworks.
- (run from
- XCode 10.1 should then be able to build / run / test
To keep things simple try bin/setup
It'll run these steps for you (Note it's very basic!)
There's a Gitter channel if you have problems getting up and running (https://gitter.im/CutBox)
Licence
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/.
Github
link |
Stars: 84 |
Help us keep the lights on
Dependencies
Used By
Total: 0
Releases
1.4.5 - Aug 15, 2019
- Fix signing for Mojave 10.14.6
1.4.4 - Aug 10, 2019
- Optimize history
1.4.3 - Apr 7, 2019
- Fix crash on when Cmd is tapped.
- Update all dependencies
1.4.2 - Apr 4, 2019
- Fix crash on startup - #84 App quits after opening search via global hotkey
1.4.1 - Apr 2, 2019
- Fix compatibility with XCode 10.x
- Fix Mojave codesign issues.