private.xml Reference Manual

In addition, all installed setting is described in checkbox.xml.
It's a good example of <autogen>.
(Note: You cannot use "#include" in private.xml. Unfold all settings to private.xml.)

<?xml version="1.0"?>
<root>

  <item>
    <name>Name of Setting</name>
    <appendix>Optional Description of Setting</appendix>
    <identifier>Unique Identifier of Setting</identifier>
    <autogen>Behavior Definition</autogen>
    <autogen>Behavior Definition</autogen>
  </item>

  <item>...</item>

  <item>...</item>
</root>

• List of KeyCode
• List of ModifierFlag
• List of ConsumerKeyCode (Brightness Control, Audio Volume Control, Music Control, etc)
• List of PointingButton

1. Plain:
   This autogen changes space key to tab key.

   <autogen>--KeyToKey-- KeyCode::SPACE, KeyCode::TAB</autogen>
   

2. Modifier+Key to Key:
   This autogen changes "left control+space key" to tab key.

   <autogen>--KeyToKey--
     KeyCode::SPACE, ModifierFlag::CONTROL_L,
     KeyCode::TAB
   </autogen>
   

3. Modifier+Key to Modifier+Key:
   This autogen changes "left control+space key" to "left control+tab key".

   <autogen>--KeyToKey--
     KeyCode::SPACE, ModifierFlag::CONTROL_L,
     KeyCode::TAB,   ModifierFlag::CONTROL_L
   </autogen>
   

4. Multiple Modifier:
   Use "|" to specify multiple modifiers.
   This autogen changes "left control+fn+space key" to tab key.

   <autogen>--KeyToKey--
     KeyCode::SPACE, ModifierFlag::CONTROL_L | ModifierFlag::FN,
     KeyCode::TAB
   </autogen>
   

5. ModifierFlag::NONE
   If you want to change key behavior only when specific modifiers are pressed, use ModifierFlag::NONE.
   This autogen changes "fn+space key" to tab key and retain other modifier combinations+space key behavior.
   For example, control+fn+space key acts as control+fn+space. (not control+tab)

   <autogen>--KeyToKey--
     KeyCode::SPACE, ModifierFlag::FN | ModifierFlag::NONE,
     KeyCode::TAB
   </autogen>
   

6. Change to Multiple Keys
   This autogen changes space key to tab,return key.

   <autogen>--KeyToKey--
     KeyCode::SPACE,
     KeyCode::TAB, KeyCode::RETURN
   </autogen>
   

<?xml version="1.0"?>
<root>
  <item>
    <name>Swap Space and Tab</name>
    <identifier>private.app_safari_swap_space_and_tab</identifier>
    <only>SAFARI</only>
    <autogen>--KeyToKey-- KeyCode::SPACE, KeyCode::TAB</autogen>
    <autogen>--KeyToKey-- KeyCode::TAB, KeyCode::SPACE</autogen>
  </item>
</root>

1. Launch EventViewer from a menu.
   
   
   
2. See "Current Application" of EventViewer.
   This value is changed when you change the current application.
   Change the current application to target application. Then press "copy to pasteboard" button.
   You can paste this information to text area.
   

1. Add <appdef> to your private.xml.
   <appname> is a name of application which you use in <only> filter.
   Write the bundle identifier into <equal>.

   <?xml version="1.0"?>
   <root>
     <appdef>
       <appname>APPSTORE</appname>
       <equal>com.apple.appstore</equal>
     </appdef>
   </root>
   

2. Then, you can use <only>APPSTORE</only> in private.xml.

   <?xml version="1.0"?>
   <root>
     <appdef>
       <appname>APPSTORE</appname>
       <equal>com.apple.appstore</equal>
     </appdef>
   
     <item>
       <name>Space to Tab on App Store.app</name>
       <identifier>private.appdef</identifier>
       <only>APPSTORE</only>
       <autogen>--KeyToKey-- KeyCode::SPACE, KeyCode::TAB</autogen>
     </item>
   </root>
   

• Presets of Application Definition

<?xml version="1.0"?>
<root>
  <appdef>
    <appname>TERMINAL</appname>
    <equal>com.apple.Terminal</equal>
  </appdef>
</root>

<?xml version="1.0"?>
<root>
  <item>
    <name>Disable ScrollWheel on Magic Mouse</name>
    <identifier>private.dropscrollwheel_0x05ac_0x030d</identifier>
    <device_only>DeviceVendor::APPLE_COMPUTER,DeviceProduct::MAGIC_MOUSE</device_only>
    <autogen>--DropScrollWheel--</autogen>
  </item>
</root>

1. Launch System Information.app (System Profiler.app in Snow Leopard).
   You can launch System Information.app from the menu by clicking Apple mark while pressing Option key.
   
   
   
2. Examine VendorID and ProductID of the device.
   

1. Add <devicevendordef> and <deviceproductdef> to your private.xml.
   

   <?xml version="1.0"?>
   <root>
     <devicevendordef>
       <vendorname>HEWLETT_PACKARD</vendorname>
       <vendorid>0x03f0</vendorid>
     </devicevendordef>
   
     <deviceproductdef>
       <productname>MY_HP_KEYBOARD</productname>
       <productid>0x0224</productid>
     </deviceproductdef>
   </root>
   

2. Then, you can use <device_only> in private.xml.

   <?xml version="1.0"?>
   <root>
     <devicevendordef>
       <vendorname>HEWLETT_PACKARD</vendorname>
       <vendorid>0x03f0</vendorid>
     </devicevendordef>
   
     <deviceproductdef>
       <productname>MY_HP_KEYBOARD</productname>
       <productid>0x0224</productid>
     </deviceproductdef>
   
     <item>
       <name>Space to Tab in MY_HP_KEYBOARD</name>
       <identifier>private.deviceproductdef</identifier>
       <device_only>DeviceVendor::HEWLETT_PACKARD, DeviceProduct::MY_HP_KEYBOARD</device_only>
       <autogen>--KeyToKey-- KeyCode::SPACE, KeyCode::TAB</autogen>
     </item>
   
   </root>
   

• Presets of Device Vendor Definition
• Presets of Device Product Definition