device_if, device_unless

Change an event if/unless the event is from specified device.

{
    "type": "device_if",
    "identifiers": [
        {
            "vendor_id": 1111,
            "product_id": 2222,
            "description": "my keyboard 1"
        },
        {
            "vendor_id": 3333,
            "product_id": 4444,
            "description": "my keyboard 2"
        },
        ...
    ]
}

Name	Required	Description
`type`	Required	`"device_if"` or `"device_unless"`
`identifiers`	Required	Target device definitions
`description`	Optional	A human-readable comment

`identifiers`

identifiers is an array of objects.

Name	Required	Description
`vendor_id`	Optional	Vendor ID of device which is fixed value for each device
`product_id`	Optional	Product ID of device which is fixed value for each device
`location_id`	Optional	Location ID of device which is changed by where the port your device is connected
`is_keyboard`	Optional	`true` or `false`
`is_pointing_device`	Optional	`true` or `false`
`is_touch_bar`	Optional	`true` or `false`

Multiple identifiers

If you specify multiple identifiers (vendor_id, product_id, location_id, …), these are joined by “and”.

The following condition is matched if Vendor ID is 1111 and Product ID is 2222.

{
    "type": "device_if",
    "identifiers": [
        {
            "vendor_id": 1111,
            "product_id": 2222
        }
    ]
}

Multiple entries

If you specify multiple entries at identifiers, conditions are joined by “or”.

The following condition is matched if Vendor ID is 1111 or 1112.

{
    "type": "device_if",
    "identifiers": [
        {
            "vendor_id": 1111
        },
        {
            "vendor_id": 1112
        }
    ]
}

Investigate the device identifiers

You can find them by EventViewer > Devices tab.