jasonm23 232fcce0a5 Resync web [release] | hai 11 meses | |
---|---|---|
.github | hai 11 meses | |
CutBox | hai 11 meses | |
bin | hai 11 meses | |
cutbox.github.io @ 539dd60a02 | hai 11 meses | |
cutbox.wiki @ c7223597c7 | hai 1 ano | |
cutbox_command | hai 1 ano | |
.codeclimate.yml | %!s(int64=3) %!d(string=hai) anos | |
.gitignore | hai 1 ano | |
.gitmodules | hai 1 ano | |
.swiftlint.yml | %!s(int64=2) %!d(string=hai) anos | |
Brewfile | hai 1 ano | |
LICENSE | %!s(int64=6) %!d(string=hai) anos | |
README.md | hai 1 ano | |
package-lock.json | hai 1 ano | |
package.json | hai 1 ano | |
release-notes.md | %!s(int64=6) %!d(string=hai) anos |
CutBox is a clipboard manager for MacOS, designed for developers. It is used to manage and organize text copied from various sources. Some of its features include fuzzy matching, regular expression search, favorites, and the ability to transform text by pasting multiple clipboard entries at once. CutBox works by saving any text copied on MacOS to its history, which can be accessed using a global hotkey. The program supports shortcuts for exiting the search, pasting selected items, and opening the preferences. CutBox can be installed using Homebrew Cask or Homebrew.
CutBox has JavaScript features that allow you to process text before pasting it. To use this feature, you need to have a file named ~/.cutbox.js in your home directory. This file can contain custom JavaScript code that will be executed when you paste text using CutBox.
You can access this feature by selecting an item from the CutBox clipboard history and then pressing CmdEnter. This will open the JavaScript processing dialog where you can enter or modify the JavaScript code to process the text. When you're done, press Enter to apply the processing and paste the modified text.
The JavaScript parser will recognize require(javascript_file)
and shellCommand(command_args)
to give you complete flexibility, and lets you process text through any js library or shell command before pasting it at your cursor.
Note that the JavaScript code should be safe and not contain any malicious code. Always be careful when running code from untrusted sources.
Cutbox also has a command-line interface called cutbox
. It allows you to fetch items from history, filter by search, and get n entries from the most recent or searched items. See below
Originally Inspired by JumpCut & Flycut
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.)
With the CutBox window open, search for anything you copied.
Press Enter and the selected item will paste into your current app.
To exit press Esc.
Shortcut Keys | Action |
---|---|
Esc | exit search |
Ctrlg | exit search |
Enter | Paste selected |
CmdEnter | Paste through JavaScript Functions selected (you'll need ~/.cutbox.js set up) |
CmdComma | open preferences |
CmdDelete | Delete selected item(s) |
CmdComma | open preferences |
Cmdt | toggle color themes |
Cmdp | toggle preview |
CmdShift= | zoom/scale up text |
CmdShift- | zoom/scale down text |
CmdShift0 | reset text scale/zoom |
Cmds | toggle search modes, fuzzy match, regexp/i or regexp |
Cmdf | toggle search favorites / everything (use the right click menu, to favorite) |
Install the compiled package.
brew tap cutbox/cutbox
brew install --cask cutbox
For advanced users. Builds the package from source, full Xcode installation needed.
brew tap cutbox/cutbox
brew install cutbox
When you first run CutBox Macos will prompt you that the developer cannot be identified.
Please read this post from Apple.
If you prefer to install open source software that isn't notarized (such as CutBox, or Chromium) on your Mac, you can do this in the terminal.
sudo spctl --master-disable
I only recommend this if you feel comfortable using free software that you can code audit. CutBox is code audited by Codacy. However it doesn't participate in Apple's anti opensource gatekeeper / notarisation system or any other parts of Apple's Walled Garden.
CutBox will be free and open forever, and is licensed under GNU/GPL3, so the source is always available.
Dmg/.app builds are produced by Github Workflow actions, so you can also inspect the entire test/deploy/delivery chain. (as of Sept 2022)
Before CutBox can paste for you (when you select something and hit enter that is.) You have to enable it to control the keyboard.
Go to System Preferences -> Security & Privacy -> Privacy -> Accessibility
Unlock and add CutBox to the list of apps (also switch on the check box next to its icon).
Do the same for input monitoring...:
Go to System Preferences -> Security & Privacy -> Privacy -> Input Monitoring
Make sure CutBox is in the list and its checkbox is on.
These work best before CutBox is run. (Macos will suggest restarting CutBox anyway, wait for the CutBox icon to appear before changing a checkbox in security preferences.)
FYI If you're upgrading, you'll need to remove and re-add the new CutBox.app.
The CutBox repo includes a command line tool to access history.
Usage:
cutbox [-f query] [limit]
History items can be filtered by Query (string contained in a history item)
Limit will show the top n items (after filtering if used.)
The command line tool must be compiled at the moment, from the cutbox_command
folder you can run:
swift build -c release; cp .build/release/cutbox /usr/local/bin/
This will build and install the command to /usr/local/bin
The command will fail to run if CutBox is not installed and has history.
More information is in the wiki
If you find a bug, click here to tell me what happened.
git clone git@github.com:CutBox/CutBox
gem install cocoapods
cd CutBox
pod install
cd ..
To build CutBox.app:
bin/build
open CutBox/build/
Run the local CutBox.app with terminal logging...
CutBox/build/CutBox.app/Contents/MacOS/CutBox
There's a Gitter channel if you have problems getting up and running (https://gitter.im/CutBox)
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/.