This simple utility allows you to view, update, create and delete text substitutions used in Cocoa-based applications.

shortcuts is built on top of macOS' private APIs (InputMethodKit.framework for 10.11, KeyboardServices.framework for 10.12+) so any OS update (especially a major one) could break the utility. If this ever happens I'll try my best to fix it as soon as possible, so stay tuned!

There're two branches in this repo: v1.x for El Capitan (10.11) and master for Sierra (10.12) and High Sierra (10.13). The former is in maintaince mode mostly so it won't receive any new features (but I'll try to backport bug fixes from master, so don't worry).

If you're installing shortcuts via Homebrew the appropriate version is installed automatically based on your macOS revision.

You can install shortcuts with Homebrew:

$ brew install rodionovd/taps/shortcuts

Please note that you'll need Xcode in order to compile the project. If you don't use Xcode, download a pre-built binary and put it into /usr/local/bin/ or any other suitable location.

$ shortcuts read [--as-plist]

You can specify --as-plist modifier to generate a property list file suitable for dragging into Keyboard Preferences Pane (see How to export and import text substitutions in OS X for details).

You can import new text replacement entries either from a property list (see above)

$ shortcuts import [--force] /path/to/input.plist

or manully like this

$ shortcuts create [--force] <shortcut> <phrase>

The default conflict resolution strategy is that the existing entries will not be overwritten with those from the input file/command line. You should use the --force flag to update existing entries (i.e. for the same <shortcut>).

As simple as

$ shortcuts update <shortcut> <new phrase>

Currently this command is an alias for the create --force command.

$ shortcuts delete <shortcut>

Well that's it.

Made by Internals Exposed @ 2016-2018.