Installing DoubleCommand
To install DoubleCommand, please perform the following steps:
1. Remove any versions of iJect, uControl, CommandandControl or PowerDelete (see below for how to do that). These are conflicting software. Note that you do not have to remove old versions of DoubleCommand anymore.
2. Open the disk image and open the installer package within.
Installing DoubleCommand for Developers with XCode
To install DoubleCommand, please perform the following steps:
1. Remove any versions of iJect, uControl, CommandandControl or PowerDelete (see below for how to do that). These are conflicting software. Note that you do not have to remove old versions of DoubleCommand anymore.
2. Unzip the DoubleCommandx.x.x.tar.gz file, and open the DoubleCommand folder created.
3. Double click the install.command file in the new DoubleCommand folder. This will open a new Terminal window, and you may be asked for your admin password. When it says logout you can close the window - DoubleCommand is installed and active right away!
Configuring DoubleCommand
DoubleCommand now includes a preference pane, so just open up System Preferences and look for DoubleCommand.
Configuring DoubleCommand for Developers with XCode
To configure DoubleCommand requires some basic maths ability and a text editor (like TextEdit). You only need to edit the file /Library/StartupItems/DoubleCommand/DoubleCommand.pref, changing the number to a number calculated below and save the file. Then just double click the config.command file to apply the settings.
The table below shows a list of numbers and what functionality they activate. To activate more than one at a time, simply add the numbers together. For example, I like enter -> command and shift+delete -> forward delete, so I use 1 + 16384 = 16385. So my file simply contains the number 16385.
Under 10.3 DoubleCommand can tell between left and right modifier keys, and so look for new features coming soon that effect only one side or the other.
DoubleCommand Feature List
Value | Feature |
0 | Disable DoubleCommand |
1 | Enter key acts as a Command key |
2 | Enter key acts as a Control key |
4 | Enter key acts as an Option key |
8 | Enter key acts as an fn key (partial support, cursor keys only) |
16 | Command key acts as an Option key |
32 | Command key acts as a Control key |
64 | Option key acts as a Command key |
256 | Control key acts as a Command key |
512 | Swaps Control key and Option key |
2048 | Capslock key acts as a Control key |
4096 | fn key acts as a Control key |
8192 | Swaps numpad . with numpad shift+. |
16384 | Shift + Delete acts as a Forward Delete |
32768 | Disable Command and Option |
65536 | PC style Home and End keys |
131072 | Backslash (\) acts as a Forward Delete |
262144 | Swap function key behaviour on new 'Books |
524288 | Disable Capslock |
Any sensible combination of the above can be used | |
Preference pane (contributed by Christian Nadolle). |
Removing DoubleCommand
To remove DoubleCommand from your machine:
1. Delete the DoubleCommand folder in /Library/StartupItems on your Mac OS X startup volume.
2. Delete the DoubleCommand preference pane in /Library/PreferencePanes on your Mac OS X startup volume.
3. Restart your computer.
Removing conflicting software
To remove conflicting software from your machine:
1. Delete the iJect, uControl, CommandandControl or PowerDelete folder in /Library/StartupItems on your Mac OS X startup volume.
2. Restart your computer.
Troubleshooting
DoubleCommand has been developed for Mac OS X. It is known to run on Mac OS X 10.1 through to Mac OS X 10.3 (using the correct versions for each system) and probably runs on later versions, too. However, since it links to internal kernel structures, newer versions of the kernel may break DoubleCommand. After failing to load for any reason, DoubleCommand automatically deactivates itself to avoid continuing problems. If this happens check with this web site for an update that will work with the new kernel.
If your machine does not boot after installing DoubleCommand, hold the option (alt) key during booting and boot to Mac OS 9. You can remove DoubleCommand from Mac OS 9. You can also start the computer while holding down Command and S to get single user mode. While in this mode you can type the following to disable DoubleCommand:
mv /Library/StartupItems/DoubleCommand/DoubleCommand /Library/StartupItems/DoubleCommand/DoubleCommand.disabled
When you restart the computer DoubleCommand will no longer be active.