TL2 Bookwyrm for Stream Deck
Put the table within reach.
Switch from map to scene art, change the weather, start a timer or cue the soundboard without leaving the table.
TL2 Desktop extension
Bookwyrm for Stream Deck
Control your campaign's audio and live VTT session from dedicated keys. On Stream Deck+, use the dials for master volume and soundboard intensity. Session keys follow Bookwyrm's live state, including changes made in the browser.
Volume
100%
Intensity
50%
- Platforms
- macOS 12 or later and Windows 10 or later.
- Actions
- Play scene, fire pad, stop all, volume and intensity. Map/scene art, map variants, weather and session timers.
- Campaigns
- Each shortcut can point at a different campaign.
TL2 Session controls
Keep your attention on the players.
- Map and scene art
- Toggle between the live map and chosen scene art, or explicitly show either. The key shows the current mode.
- Map variants
- Choose a variant for any map in the live scene. Applying it returns the scene to map mode. Each key names its chosen variant and shows whether it is active.
- Weather
- Set clear skies, rain, snow, fog, embers, sandstorm or leaves, with a configurable intensity. The key shows whether your preset is active or which weather is currently running.
- Session timers
- Run a shared stopwatch or countdown, visible to just the DM or to players too. Tap to start, pause or resume. Hold for at least 750ms and release to reset. The key displays the time.
Map, scene art and weather controls affect the campaign's live VTT scene, not the separate projector settings. Timers are shared across the campaign and work without a live scene.
TL2 Set up
From download to first cue.
-
Install the plugin
Open the downloaded file and let the Stream Deck app install Bookwyrm.
-
Create a token
Create an API token with
Open API tokenscontrol:audiofor audio actions andcontrol:sessionfor session controls. Select both to use every action. Paste the token into any Bookwyrm action; it is shared across them. You must be the campaign's DM. -
Add a campaign
Paste any campaign URL into the action. Campaign home, VTT, and settings URLs are all recognised.
-
Choose your controls
Choose the audio scene, pad, scene art, map variant or preset in the action's settings. Refresh the art and map pickers after changing the live scene or campaign.
Audio actions need the campaign soundboard open in the DM's browser. Stream Deck sends commands; the browser plays the audio. Session controls do not need the soundboard open.
