> ## Documentation Index
> Fetch the complete documentation index at: https://docs.heyquiz.pro/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote Pilot

> Control the quiz from your phone

## What is Remote Pilot?

**Remote Pilot** lets you control the quiz from your phone while the computer screen shows only the presentation view. Ideal when:

* You're hosting the quiz standing in front of a group
* Computer is connected to a projector
* You want to move around freely

## How to set up?

<Steps>
  <Step title="Create session">
    Start the quiz and go to lobby.
  </Step>

  <Step title="Click the pilot icon">
    In the lobby, find the **pilot** icon (📱) and click it.
  </Step>

  <Step title="Scan QR code">
    A QR code will appear - scan it with your phone's camera.
  </Step>

  <Step title="Open the link">
    Your phone will open the Remote Pilot page.
  </Step>

  <Step title="Done!">
    Your phone is now the quiz remote control.
  </Step>
</Steps>

## Pilot features

### Control panel

On your phone you have access to:

| Button            | Function                   |
| ----------------- | -------------------------- |
| **Start**         | Starts the quiz from lobby |
| **Next question** | Moves forward              |
| **Show answer**   | Reveals correct answer     |
| **Show ranking**  | Displays leaderboard       |
| **End quiz**      | Ends the session           |

### Information on pilot

You see in real-time:

* Current question number
* How many have answered
* Time remaining
* Timer status

## Security

### One-time token

<Info>
  The pilot link contains a one-time token valid for **5 minutes**. After that, you need to generate a new QR code.
</Info>

### Single device

* Only one device can be the pilot
* Connecting from a new device disconnects the previous one
* Computer still shows the presentation view

## Workflow

### Typical scenario

1. **Preparation:**
   * Connect computer to projector
   * Open quiz in browser
   * Create session

2. **Connect pilot:**
   * Scan QR with phone
   * Verify the pilot works

3. **Hosting:**
   * Participants join (they see the projector screen)
   * Start quiz from phone
   * Control the entire quiz from your hand

### Presentation view

The computer screen (projector) shows:

* Clean question view for participants
* No control elements
* Large, readable answers
* Timer visible to everyone

## Troubleshooting

<AccordionGroup>
  <Accordion title="QR code expired">
    * Click the pilot icon again
    * A new QR code will be generated
    * Scan it again
  </Accordion>

  <Accordion title="Pilot disconnected">
    * Check phone's Wi-Fi connection
    * Refresh the pilot page
    * If needed - scan QR again
  </Accordion>

  <Accordion title="Buttons not responding">
    * Make sure phone has internet
    * Wait a moment (network delay)
    * Refresh the pilot page
  </Accordion>

  <Accordion title="Can't scan QR">
    * Enlarge the code on screen
    * Check lighting
    * Use a dedicated QR scanning app
  </Accordion>
</AccordionGroup>

## Technical requirements

### Phone

* Any smartphone with a browser
* Internet connection (Wi-Fi or mobile data)
* Camera for scanning QR (or app)

### Computer

* Browser with quiz open
* Stable internet connection
* Optionally: connected to projector

<Warning>
  **Important:** Phone and computer both need internet connection. They don't work on local network only.
</Warning>

## Tips

<Tip>
  **Test the connection before the quiz** - make sure the pilot works before participants join.
</Tip>

<Tip>
  **Keep your phone charged** - a long session can drain the battery.
</Tip>

<Tip>
  **Disable notifications** - mute your phone to avoid distracting sounds.
</Tip>

## Alternatives

If Remote Pilot doesn't work:

* Control directly from computer
* Use a wireless mouse/presenter
* Ask someone to click on the computer

## Next steps

<CardGroup cols={2}>
  <Card title="Hosting the quiz" icon="presentation-screen" href="/en/sessions/hosting">
    Full session control
  </Card>

  <Card title="Ending the session" icon="flag-checkered" href="/en/sessions/ending">
    Results summary
  </Card>
</CardGroup>