This shows you the differences between two versions of the page.
Both sides previous revision Previous revision | |||
trigger:USB_Device_Key [2023/09/13 00:29] peternlewis |
trigger:USB_Device_Key [2023/09/13 00:32] (current) peternlewis |
||
---|---|---|---|
Line 5: | Line 5: | ||
The *USB Device Key trigger* executes a macro when any device key is pressed — this includes modifier keys, mouse buttons, many programable keyboards, and even the brightness buttons on USB connected monitors. | The *USB Device Key trigger* executes a macro when any device key is pressed — this includes modifier keys, mouse buttons, many programable keyboards, and even the brightness buttons on USB connected monitors. | ||
- | The macro can be executed when the key is pressed, long pressed (v10.0+), released or repeat continuously while it is held down. The trigger can also optionally be restricted to when certain modifier keys are pressed. | + | Unlike hot key triggers, the pressed key is not removed or affected in any way. This trigger watches input devices at a low level, but it does not affect them, so any key presses continue to have their normal operation as well as triggering the macro. This is fine for modifiers, unused mouse buttons, programable keyboards and other unused buttons, but would likely be problematic for normal keystrokes which will continue to have some other, probably unwanted, affect. |
- | You can configure the trigger to execute when the key is tapped (press and released quickly) each time, the first tap, double tapped, triple tapped, or quadruple tapped (v7.0+). Keep in mind that Keyboard Maestro cannot see the future, so "tapped once" will will fire even on the first tap even if you tap the key twice ("tapped" would fire both times). | + | ===== When ===== |
- | For example, a macro could fire every five seconds while Control-Mouse Button 3 is held down. | + | You can configure the hot key trigger to execute the macro when the key is pressed, when it is long pressed (v10.0+), when it is released, or repeatedly while the key is held down. This allows you to do things like have a macro execute when the key is pressed, and then a second macro execute when the key is released, for example to toggle a setting on and then off again. |
- | Unlike hot key triggers, the pressed key is not removed or affected in any way. This trigger watches input devices at a low level, but it does not affect them, so any key presses continue to have their normal operation as well as triggering the macro. This is fine for modifiers, unused mouse buttons, programable keyboards and other unused buttons, but would likely be problematic for normal keystrokes which will continue to have some other, probably unwanted, affect. | + | You can configure the hot key trigger to execute when the key is tapped (press and released quickly) each time, the first tap, double tapped, triple tapped, or quadruple tapped (v7.0+). |
+ | |||
+ | You can configure the hot key trigger to execute when the key is tapped (press and released quickly) only on the first tap, or the second tap, or the third tap, or the fourth tap (v11.0+). Keep in mind that Keyboard Maestro cannot see the future, so to determine that this is explicitly the second tap, the macro will not fire when the key is released, but must wait a short period of time to see that it is not pressed a third time. As such there will be a short delay before the macro is executed when using the “only once” style options. | ||
===== See Also ===== | ===== See Also ===== |