KeyJack Quick Start
Quick Install for Hardware
- Plug in the Ergodex DX1 into a USB port
NOTE: The "Keyboard Setup Assistant" window will open and ask you to identify the keyboard. This window will ask you to "Press the key immediately to the right of the Shift key...". Since this key does not exist on a DX1 you can safely close this window by clicking the the window's close box. Your DX1 will still function.
NOTE: This software supports a single DX1.
Quick Install for Software
We recommend you move KeyJack into the "/Applications/Utilities" folder on your main hard drive.
Enable access for assistive devices.
- Open the "System Preferences". (If already open, click "Show All")
- Choose "Universal Access"
- Check "Enable access for assistive devices"
Enable KeyJack as a Login Item
- Open the "System Preferences"
- Choose "Accounts"
- Choose the "Login Items" tab
- Drag "KeyJack" into the list, or use the "+" button to add it from the Utilities folder
- Open the "KeyJack" application
The KeyJack software is now ready for use.
Note: You will be notified of any new updates if your computer is connected to the Internet.
Programming the DX1
There are two ways to program the keys, manually or by recording your actions. Both are easy.
Manually programming a key
- Double-Press the "Ergo" hand button on your DX1 next to the green LED.
- This will display the profiles window.
- Click the "+" button in the bottom left corner of the window
- Choose "New Macro"
- A new key is generated with the next available number, which is selected.
- Enter a label for the new macro
- If you want to program a different number, type it on your regular keyboard and press the "Return" key. If you want to accept the default key number, just press the "Return" key.
- Double-Click the row of the new key to open a key editor window.
- In the top right corner of the key editor, you will see "Empty" with a question mark icon.
- Click the icon to choose a new key type. For this example, choose "Key".
- A popup menu for the "Key Value" will appear underneath. From this menu, you may select a specific key from the standard keyboard.
Congratulations! You have programmed a key!
Recording a key
- First, start in an application where you would typically use this macro.
- Press the "Record" button on the DX1 to start recording.
- Type a key, modifier, or series of keys
- Press the key on the DX1 you wish to assign
Repeat as necessary to program other keys
Press the "Record" button on the DX1 to stop recording.
Key Events
KeyJack offers a number of different key functions as defined in the following table.
| Function | Description |
|---|---|
| Empty | An "Empty" key has no function. It is a placeholder for new keys, but it may also be useful in more complex layouts. |
| Key | This emulates the function of any single specific key found on your regular keyboard. |
| Modifier | This also acts the same as a regular keyboard, but as a modifier (or group of modifiers) key. |
| Macro | This is a recorded collection of keyboard events that play back when you press this key. |
| Application | Allows you to create a "hot key" to launch or bring a specific application to the front. |
| File | Opens a preselected file as if double-clicked in the Finder. |
| Level | This kind of button cycles through the current user states. Holding down the shift key reverses the order. |
| Script | Optimized support for any script language supported by the Apple Open Scripting Architecture. Scripts are compiled once the first time your run them. |
| Text | Quickly inserts a preset series of characters. Currently unimplemented. |
| URL | Launches a specific URL in your default browser. |
For the details about User State Mappings see below.
NOTE: At this time the only way to know what state is active is to enable Use Spoken Responses in the preferences window. States will be announced when activated.
A mapping is a group of keys that apply under a certain condition. Two levels of mappings supported are Application Profiles and User State Mappings. The device status window displays and edits the "Key Mappings" list. The sidebar items (the ones on the left) are Application Profiles and their content is displayed on the right. The "Global" profile is the set of keys that are available to all applications at all times.
Application Profile
An "Application Profile" is a "top level" mapping that allows you to redefine keys from the global set that are used when that application is in front. If you choose "New Macro" and something in the "Photoshop" application mapping is selected, the New Key will be created in the Photoshop mapping. You can use drag & drop to move keys from one profile to another, or hold down the option key while dragging to copy them into the destination mapping. You can change a key's number by clicking it in the top-left corner of the key editor view and selecting a new number. If a key with that number already exists in the mapping, the two keys are swapped.
You can quickly create a new mapping for the application you are currently in by simple pressing the Control key (⌃) while pressing the "Record" button on the Ergodex DX1.
User Level Profiles
There is also a secondary level of mapping called "User Level Profiles". These are user defined sets of "level" indicators and each level can have a user defined mapping. Much like the way the "Shift" and "Option" modifiers affect the keys, the User Level mappings temporarily change the values of the keys. A User Level Profile can only be inside an Application or the Global Profile. If you select "New Level", you will create a new User Level Profile.
At this time, the number and names of the levels is fixed. In a future releases, users can create their own sets of states as they wish.
Contact Us
If you have any problems, crashes, questions, concerns, or anything else please feel free to email anytime.
email: support@keyjack.com