# 2You Control — Stream Deck Plugin

Control [2you.pro](https://2you.pro) live stream tools from your Elgato Stream Deck.

> **Marketplace:** Copy the English product description from [`../MARKETPLACE_LISTING.md`](../MARKETPLACE_LISTING.md) into Maker Console. The same text is in `manifest.json` → `Description` (min. 250 / max. 1,500 characters, English).

## Compatibility (Marketplace 2026+)

- Stream Deck software **6.9** or newer (`Software.MinimumVersion`)
- Plugin SDK **3** (`SDKVersion`: 3) — HTML/WebSocket plugin
- **DRM-compatible** — in Maker Console set **DRM protection = Yes** (DRM is applied by Elgato after upload)

## What it does

Dedicated **Valorant Agent Select** keys (spin, reset, overlay on/off) plus one action (**2you Aktion**) for the rest of your catalog (Death Counter, Songbattle, Subathon, Poll, Wheel, and more). Enter Streamer ID and Stream Deck key once; Agent Select keys run immediately, catalog keys pick a function from the dropdown.

## Installation

1. Download `2you-control.streamDeckPlugin` from [2you.pro/extension/streamdeck/](https://2you.pro/extension/streamdeck/).
2. Double-click — Stream Deck installs the plugin (category **2You Control**, icon **2Y**).

## Connect Stream Deck

1. On the hub page, sign in → **Connect Stream Deck** → copy your key.
2. Drag **Agent Select · Würfeln** (or Reset / Overlay) onto the deck — or **2you Aktion** for other tools.
3. In the Property Inspector: enter **Streamer ID** (Twitch login) + **Stream Deck key**.
4. For **2you Aktion**: **Load games** and pick the function. Agent Select keys need no dropdown.

One Stream Deck key replaces per-tool control URLs for all unlocked games.

## Updates

On start, the plugin checks `https://2you.pro/extension/streamdeck/version.json`. Local version comes from `plugin-meta.json` (not `manifest.json` under DRM). Newer version → notice in the Property Inspector + download of the `.streamDeckPlugin` file. Silent Marketplace auto-updates only via the Elgato Store.

## Build package

```bash
python generate_icons.py   # optional
python build_streamdeck.py
# optional: streamdeck validate com.2you.control.sdPlugin
```

## Security

- Keep Stream Deck keys and control keys private.
- Keys are stored only in local Stream Deck settings.
