---
title: "MotionControllers"
section: "Interaction"
order: 1303
description: "MotionControllers — Vuer documentation"
---

import { Callout } from '@docs/components/Docs'

# MotionControllers

<Callout>
  **Warning**: This example is still under construction. now reference: [Motion Controllers](/examples/vr_xr/motion_controllers)
</Callout>

The `MotionControllers` component enables VR motion controller tracking. This is essential for:

- VR controller input in WebXR applications
- Building VR interaction interfaces
- Robot teleoperation with VR controllers
- Creating immersive VR experiences

## Basic Usage

A minimal example that enables motion controller tracking:

```python
import asyncio
from vuer import Vuer, VuerSession
from vuer.schemas import MotionControllers

app = Vuer()

@app.add_handler("CONTROLLER_MOVE")
async def handler(event, session):
    print(f"Controller Event:", event.value)

@app.spawn(start=True)
async def main(session: VuerSession):
    session.upsert(
        MotionControllers(
            stream=True,
            key="controllers",
        ),
        to="bgChildren",
    )

    while True:
        await asyncio.sleep(1.0)
```

## Key Parameters

| Parameter | Type | Default | Description                              |
| --------- | ---- | ------- | ---------------------------------------- |
| `key`     | str  | -       | Unique identifier for the controllers    |
| `stream`  | bool | `False` | Enable streaming of controller pose data |
| `left`    | bool | `True`  | Enable left controller tracking          |
| `right`   | bool | `True`  | Enable right controller tracking         |

## Controller Data Format

The `CONTROLLER_MOVE` event returns pose and button data for each controller.

## SSL Requirement

WebXR requires HTTPS. Use ngrok or localtunnel for development:

- **ngrok**: [https://ngrok.com/docs](https://ngrok.com/docs)
- **localtunnel**: [https://localtunnel.me](https://localtunnel.me)

## Learn More

For detailed examples of using `MotionControllers`, see:

- [Motion Controllers](/examples/vr_xr/motion_controllers) - Complete VR controller tutorial