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

# Stream Deck Integration

> Control your Twitch overlays with Stream Deck hardware. Update counters, timers, and layers with physical buttons.

## Stream Deck Integration

Vision integrates with Elgato Stream Deck, letting you control your overlays with physical buttons. Adjust scores, toggle layers, control timers, and more - all without touching your keyboard.

***

## Getting Started

<Steps>
  <Step title="Download the plugin">
    Go to **Settings** in Vision and download the Stream Deck plugin, or get it from the [Elgato Marketplace](https://marketplace.elgato.com/product/1up-vision-cc30663a-d7bb-4f52-b19b-db99ac15de33)
  </Step>

  <Step title="Install the plugin">
    Double-click the downloaded file to install it in Stream Deck
  </Step>

  <Step title="Open Stream Deck software">
    Launch the Stream Deck application on your computer
  </Step>

  <Step title="Find Vision actions">
    In the actions panel, find the Vision category
  </Step>

  <Step title="Drag actions to buttons">
    Drag Vision actions onto your Stream Deck buttons
  </Step>

  <Step title="Configure each action">
    Select the overlay and layer you want to control
  </Step>
</Steps>

***

## Available Actions

### Score/Counter Controls

| Action       | Description                        |
| ------------ | ---------------------------------- |
| **Add**      | Increase a counter by a set amount |
| **Subtract** | Decrease a counter by a set amount |
| **Set**      | Set a counter to a specific value  |
| **Toggle**   | Switch between two values          |

### Timer Controls

| Action           | Description                       |
| ---------------- | --------------------------------- |
| **Start/Resume** | Begin or continue a timer         |
| **Pause**        | Pause a running timer             |
| **Reset**        | Reset timer to its starting value |

### Layer Controls

| Action     | Description                            |
| ---------- | -------------------------------------- |
| **Show**   | Make a layer visible                   |
| **Hide**   | Hide a layer                           |
| **Toggle** | Switch visibility between shown/hidden |

### Scene Controls

| Action           | Description                            |
| ---------------- | -------------------------------------- |
| **Switch Scene** | Change the active Vision overlay scene |

***

## Setting Up an Action

<Steps>
  <Step title="Drag action to button">
    Drag a Vision action from the actions panel to a Stream Deck button
  </Step>

  <Step title="Select your overlay">
    In the action settings, choose which overlay to control
  </Step>

  <Step title="Select the layer">
    Choose which layer within that overlay to control
  </Step>

  <Step title="Configure the action">
    Set the value (for add/subtract/set actions)
  </Step>

  <Step title="Test it">
    Press the button to verify it works
  </Step>
</Steps>

***

## Tips

<Tip>
  **Group related actions** together on your Stream Deck. Put all score controls in one area, timer controls in another.
</Tip>

<Tip>
  **Use folders** in Stream Deck to organize actions for different games or stream types.
</Tip>

<Tip>
  **Label your buttons** clearly - Stream Deck supports custom icons and text for each button.
</Tip>

***

## Troubleshooting

### Actions not working?

1. **Check your connection** - Make sure you're logged into Vision
2. **Verify the overlay** - Ensure the selected overlay exists
3. **Check the layer** - Confirm the layer hasn't been deleted or renamed
4. **Refresh the plugin** - Try removing and re-adding the action

### Plugin not showing?

1. Restart the Stream Deck software
2. Reinstall the Vision plugin
3. Check for Stream Deck software updates