advanced-camera-card/docs/usage/keyboard-shortcuts.md

Keyboard Shortcuts

There are two ways to have the card respond to key input:

• As a convenience, the card supports a small number of built in shortcuts with pre-defined default bindings. See Built-in shortcuts for these built in shortcuts. Use the keyboard_shortcuts configuration to change their bindings.
• More generally, any action can be configured to run in response to keyboard input as part of an automation, even if that action does not have a pre-defined shortcut. See keyboard automation example to show how to execute any arbitrary action(s) in response to keyboard activity.

How key input is handled

• The card must have focus. Key input only reaches the card if the user has interacted with it (i.e. click or tab to the card first).
• Registered keyboard shortcuts will be handled only by the card. When a key matches a built-in shortcut (below) or a key trigger, the browser's own behavior for that key is suppressed (to ensure that pressing ArrowDown pans the camera without also scrolling the dashboard). Keys with no binding are left entirely to the browser.
  • A key trigger with no key property is an exception. Such a trigger fires on every key, so no suppression occurs to preserve the browser behavior in the general case (e.g. Tab still moves focus).
• Keys typed into an input field are otherwise ignored. Key strokes aimed at intentional inputs (e.g. a text box or dropdown) do not trigger card actions / automations.

Built-in shortcuts

Built in keyboard shortcuts can be disabled through the keyboard_shortcuts configuration.

Name	Default key binding	Action	Description
ptz_down	ArrowDown	ptz_multi	PTZ move down.
ptz_home	h	ptz_multi	PTZ home / default.
ptz_left	ArrowLeft	ptz_multi	PTZ move left.
ptz_right	ArrowRight	ptz_multi	PTZ move right.
ptz_up	ArrowUp	ptz_multi	PTZ move up.
ptz_zoom_in	+	ptz_multi	PTZ zoom in.
ptz_zoom_out	-	ptz_multi	PTZ zoom out.