Note:
At the moment Windows and OSX are supported. Linux has been reported to work, there is no official Linux support for the Stream Deck, but there exist a 3rd party Stream Deck UI that appears be compatible. To get it working on Linux requires more work, and help I can personally offer is limited.
The module works on the native Foundry application, Chrome and Firefox. Safari (you'll need the latest dev version to get Foundry to work on it) doesn't work if your Foundry server is secured, unless you use something like Nginx with which I cannot help you.
In any case: Proceed at your own risk, I will not take any responsibility if you spent money and the module doesn't work!
Please read the documentation carefully, especially if you want to modify the default profile!
I created a Discord server to discuss this and other hardware-based Foundry modules. Feel free to join if you'd like to join the discussion and be updated on this module.
[](https://youtu.be/7h5Ew8cJYxg "FoundryVTT Material Deck Demonstration")
# Material Deck
Material Deck is a Foundry VTT module that allows you to control certain Foundry functions using an Elgato Stream Deck. A Stream Deck is a device that has physical buttons with displays behind them. Material Deck uses this to, for example, control playlists, execute macros, display and control the combat tracker.
The module allows a high degree of customization, where each button on the Stream Deck can be assigned any desired function. Furthermore, it supports folder structures, allowing easy switching between various button configurations so you can easily switch between the combat tracker, soundboard, or any other (custom) configuration.
The functions are categorized into actions. Here is a list of the available actions and their most important functions:
- Playlist Action: Control Foundry's playlists
- Play/Stop playlists
- Play/Stop tracks
- Stop all tracks & playlists
- Soundboard Action: Play sounds
- Play/Stop sound
- Stop all sounds
- Token Action: Display token info
- Display selected token's name, icon or stats (HP/AC/Movement/etc)
- Open selected token's character sheet or token config
- Target token
- Toggle token visibility, combat state, conditions
- Move Action: Move selected token or the canvas
- Move token (in a specified direction)
- Move canvas (in a specified direction)
- Zoom canvas in/out
- Macro Actions: Execute macros
- Execute macro from hotbar
- Execute macro from macro board
- Combat Tracker Actions: Control and display the combat tracker
- Display combatants
- Start/Stop combat
- Next/Previous turn/round
- Other Actions: Misc other actions
- Pause/Resume game
- Scene selection/activation
- Toggle control buttons
- Control darkness level
- Open/Roll from a roll table
- Open sidebar tab
- Open compendium pack
- Open journal entry
## Instructions and More Info
Instructions and more info can be found in the wiki.
## Latest releases
Module
Stream Deck
Server
Module manifest: https://raw.githubusercontent.com/CDeenen/MaterialDeck/Master/module.json
## Software Versions & Module Incompatibilities
Foundry VTT: Tested on 0.7.9
Module Incompatibilities: Combat Utility Belt conditions do not work with the Token Action.
## Feedback
If you have any suggestions or bugs to report, feel free to create an issue, contact me on Discord (Cris#6864), or send me an email: cdeenen@outlook.com.
## Credits
Author: Cristian Deenen (Cris#6864 on Discord)
Special thanks to Asmodeus#7588 who made this module possible by generously donating a Stream Deck XL
Please consider supporting me on Patreon, and feel free to join the Material Foundry Discord server.
## Abandonment
Abandoned modules are a (potential) problem for Foundry, because users and/or other modules might rely on abandoned modules, which might break in future Foundry updates.
I consider this module abandoned if all of the below cases apply:
- This module/github page has not received any updates in at least 3 months
- I have not posted anything on "the Foundry", "the League of Extraordinary Foundry VTT Developers" or the "Material Foundry" Discord servers in at least 3 months
- I have not responded to emails or PMs on Discord in at least 1 month
- I have not announced a temporary break from development, unless the announced end date of this break has been passed by at least 3 months
If the above cases apply (as judged by the "League of Extraordinary Foundry VTT Developers" admins), I give permission to the "League of Extraordinary Foundry VTT Developers" admins to assign one or more developers to take over this module, including requesting the Foundry team to reassign the module to the new developer(s).
I require the "League of Extraordinary Foundry VTT Developers" admins to send me an email 2 weeks before the reassignment takes place, to give me one last chance to prevent the reassignment.
I require to be credited for my work in all future releases.