Last updated: July 15, 2013
Welcome to the Shortcat public beta! There are a few things that you need to know before you get started. You can find this page by going into the Shortcat preferences (
Cmd+, while Shortcat is activated, or launching Shortcat when it’s already running), then clicking the Help pane. You can also view this in your browser of choice at http://shortcatapp.com/readme.html.
Changelog is viewable at http://shortcatapp.com/changelog.html.
Shortcat is in beta. Bugs are to be expected, and it may crash.
A Chinese version (中國版本) of this document can be found at http://kong.site44.com/shortcat_guide.html (thanks to Guoxiaosi.com).
It’s strongly recommended you read Usage to get the most out of Shortcat. Please read Compatibility before asking any questions about compatibility and Known Issues and Filing a bug before reporting bugs. Also be sure to check the Changelog for new features and changes!
Language & Text
langwill also work
barwill not match
Foobar, but will match
Batman and Robin.
.to show all elements.
Controland type in the shortcut highlighted on the field.
Command+Click, simply hit
Entertwice in quick succession.
Control. Double tap
Controlto focus the element.
Enter. If you know the shortcut or are reasonably confident the query you enter will match the element you want, simply activate Shortcat, type it in, and hit
Enter. The best match that would be highlighted in green will be clicked.
The default activation shortcut is
Command+Shift+Space. This brings up the Shortcat query window. You can change this shortcut in the Preferences. Preferences can be accessed via the menu icon or
Cmd+, while Shortcat is active.
To query, simply type (in lowercase) a few letters of text from the element you would like to click on. These letters can be sequential or an abbreviation for the element.
For example, to click
Desktop & Screen Saver in
System Preferences, you can either type
Shortcat will highlight visible elements that match your query, with the green highlighted element being the top match.
If you want to click on an element that has no visible text, you can type
. (period) and Shortcat will highlight all elements that it can detect and the corresponding shortcut for each element.
This feature is under development and will most likely change in the future.
You can search by element type (AKA
.button will show all buttons. It currently uses a different matching algorithm compared to the normal querying. Currently, you can’t combine a role search with a normal query, but this feature will be added in a later release.
A list of
AXRoles can be found here.
The top match in the green highlight will be clicked when you press
Enter. You can use modifiers like
Control while pressing
Enter to click with the modifier. For example,
Control+Click, which is right click.
To click elements that are not the top match, simply hold
Control and type in the letters displayed on the highlight.
To double-click an element, double tap
To mouse over the active element, tap
To perform a click at the current cursor position, simply press
Enter with no query. You can also double-click at the current cursor position by double-tapping
This has been removed in v0.4.0. More thought is needed for this feature. It’ll come back.
Shortcat works with any application that properly exposes accessibility attributes. Standard OS X controls expose these attributes by default, so Shortcat works with most native applications on OS X. If applications implement custom controls (for animations, etc) and don’t implement accessibility attributes, Shortcat will not work for that application.
Below is a known list of applications classified by how well they work with Shortcat. If you find a popular application works particularly well, please let me know at http://support.shortcatapp.com
open -a "/Applications/Google Chrome.app" --args --force-renderer-accessibility, or go to chrome://accessibility and turn Global Accessibility on (this is a temporary setting).
Before you report a bug, please make sure you read the Known Issues above first, then the really important section below.
If Shortcat crashes, it should prompt you to send a crash report on the next launch. Please fill in the description field with what you did and steps to reproduce. If you put in your email, I will be able to contact you for further information and notify you of the status.
Please search for existing topics/reports before you create a new one. There’s a public Trello board at https://trello.com/board/shortcat-bugs/51ac6a3711f6b34606001d7f where there will be a list of issues that have been reported. If you have an account, you can comment and vote on issues.
The feedback site is at http://support.shortcatapp.com/.
Please include the following when you make a bug report:
If you just wanna say how much you love Shortcat, tweet @shortcatapp! Otherwise, general feedback can be submitted at http://support.shortcatapp.com. If it’s a feature request, please hold off on it until it goes 1.0.0, because I have a massive feature roadmap as it is :)
TL;DR: Shortcat is provided “as is”. Use at your own risk.
Shortcat is provided by Sproutcube “as is” and “with all faults.” Sproutcube makes no representations or warranties of any kind concerning the safety, suitability, lack of viruses, inaccuracies, typographical errors, or other harmful components of Shortcat. There are inherent dangers in the use of any software, and you are solely responsible for determining whether this Shortcat is compatible with your equipment and other software installed on your equipment. You are also solely responsible for the protection of your equipment and backup of your data, and Sproutcube will not be liable for any damages you may suffer in connection with using, modifying, or distributing Shortcat.