Guide 03 · 6 min read
Stream Deck & controllers
Design keys once; use them on a Stream Deck, touch screen or any macro tool.
Design your buttons once in VTube Pro, then press them on an Elgato Stream Deck, a virtual deck on a touch screen, Touch Portal, Bitfocus Companion, Loupedeck, Streamer.bot, a macro pad, or anything that can send a web request.
1. Design your keys
Open Stream Deck & controllers from the studio, or go to http://127.0.0.1:5191/deck.html.
- Pick your device: Mini, MK.2, +, XL, a 4×4 macro pad, or any size you type in.
- Drag an action onto a key: lighting states, rooms, stage modes, emotes, polls, capture cover, weather, BRB and more.
- Click a key to set its title, emoji or image, colour, and options.
- Add pages and put Next page / Previous page keys on them.
- ▶ Test press runs a key for real.
- Export / Import saves your layout as a file, to back it up or share it.
A key with a green ring is "on right now", and it follows what's really happening, whoever changed it.
2. Elgato Stream Deck
- Double-click the VTube Pro plugin file that comes with the app. It needs the Stream Deck app 7.1 or newer.
- In the Stream Deck app, find the VTube Pro category and drag VTube Pro Page key onto a key. Copy and paste it onto every key of a profile.
- Done. Each key shows whatever is at the same spot in your VTube Pro layout, and lights up when it's live.
Want one fixed button, for example inside a multi-action? Use VTube Pro action and pick the action from the list.
If VTube Pro isn't running, keys show offline and come back on their own when it starts.
Beta note: the plugin is built with Elgato's official SDK and tested end to end against a simulated Stream Deck. If something looks off on real hardware, the virtual deck shows what it should be doing, and we'd love your report.
3. No Stream Deck? Use the virtual deck
Open http://127.0.0.1:5191/deck.html?virtual=1, or click Virtual deck ↗ on the design screen. It behaves exactly like the plugin. Put it on a tablet, a touch screen or a second monitor.
4. Other tools
Every action is also a simple web request from your PC:
| Tool | How |
|---|---|
| Touch Portal | Settings → Import plug-in, then pick the VTube Pro .tpp file that comes with the app. |
| Bitfocus Companion | Add the Generic: HTTP Requests connection, and give each button a POST action with a VTube Pro URL. |
| Streamer.bot, Loupedeck, SAMMI, AutoHotkey, macro keyboards | Any "HTTP request" action: POST http://127.0.0.1:5191/api/deck/run/<action> |
| Stream Deck without the plugin | System → Website, tick "GET request in background", and paste the URL from Copy action URL (GET). |
Chat polls on a button
Save a poll as a template in the Chat Hub, then add Start poll, End poll and Show / hide poll keys. Viewers vote by typing a number or a keyword, on every connected platform at once.
Stay safe
Everything listens only on your own PC and refuses requests from websites. The GET URLs contain a private key for your PC: don't share them or show them on stream.