> For the complete documentation index, see [llms.txt](https://docs.engagevr.io/engage/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.engagevr.io/engage/configuring-the-engage-app/accessibility/microsoft-windows/adding-hotkey-controls-to-turn-your-avatar.md).

# Adding hotkey controls to turn your avatar

{% hint style="warning" %}
The following solution uses third-party software which is not verified or endorsed by ENGAGE XR.
{% endhint %}

By default, there are no keyboard controls to turn your avatar in ENGAGE. Instead, on a desktop device, you use the mouse to change the direction in which your avatar faces. However, you can use third-party software to simulate mouse drags so that you can fully navigate in ENGAGE using only the keyboard.

{% hint style="info" %}
With the [Mouse Keys](https://support.microsoft.com/en-us/windows/use-mouse-keys-to-move-the-mouse-pointer-9e0c72c8-b882-7918-8e7b-391fd62adf33) feature, you can use the zero key to drag items in most applications. However, this is not supported for looking around in ENGAGE.
{% endhint %}

One example of third-party software that you could use is AutoHotkey (<https://www.autohotkey.com/>). You can use it to assign a simulated drag operation to a keyboard shortcut. The following AutoHotkey script assigns a left drag to the Shift+A shortcut, and a right-drag to the Shift+D shortcut:

```
#Requires AutoHotkey v2.0

+a::
{
    SendMode "Event"
    MouseClickDrag "Left", 0, 0, -200, 0, 60, "R"
}

+d::
{
    SendMode "Event"
    MouseClickDrag "Left", 0, 0, 200, 0, 60, "R"
}
```

{% hint style="warning" %}
AutoHotkey enables keyboard and mouse events to be executed on your computer as though you were the one that performed them. We recommend that you only use scripts that you fully understand.
{% endhint %}

## Using the AutoHotkey script

1. Install AutoHotkey. For more information, refer to [How to Install AutoHotkey](https://www.autohotkey.com/docs/v2/howto/Install.htm).
2. Open a text editor, such as Notepad.
3. Copy the code above into a new text document, and then save it with a `.ahk` extension. For example `engage_keyboard_turn.ahk`
4. Find the script in Windows Explorer, and then double click it to run the script. Alternatively, select the script and then press the Enter key to run it.

The script runs and an icon is added to the system tray. To stop the script, right-click the icon in the system tray, and then select **Exit**. For more information about how to create, run, and control scripts, refer to [Using the Program](https://www.autohotkey.com/docs/v2/Program.htm) in the AutoHotkey documentation.

## Using the shortcuts in ENGAGE

* In a Session, ensure that the mouse cursor is within the ENGAGE window. Then, hold down the **Shift** key and press the **A** key to turn left or the **D** key to turn right.

{% hint style="info" %}
If you hold down the **A** or **D** key first, and the press **Shift**, your avatar will walk sideways as normal.
{% endhint %}

## Understanding the script

The `+a::` and `+d::` parts define the shortcut keys. The plus symbol indicates the Shift key. You can define any other key combination. You can replace the plus symbol with `#` for the Windows key, `^` for the Ctrl key, or `!` for the Alt key. For more information about defining the hotkey, refer to [Basic Hotkeys](https://www.autohotkey.com/docs/v2/howto/WriteHotkeys.htm).

`SendMode "Event"` sets a simulation mode that creates a slow, noticeable drag event. Without it, the drag would not be recognized by ENGAGE.

`MouseClickDrag` is the command that simulates the mouse being dragged. It is configured to simulate the left mouse button being held, and then dragged 200 pixels left (-200) or right (200). For more information about the available parameters, refer to [MouseClickDrag](https://www.autohotkey.com/docs/v2/lib/MouseClickDrag.htm) in the AutoHotkey documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.engagevr.io/engage/configuring-the-engage-app/accessibility/microsoft-windows/adding-hotkey-controls-to-turn-your-avatar.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.