Stream Deck - matt-cahill/DCSFlightpanels GitHub Wiki

Stream Deck Support

These docs are currently a work in progress

DCSFP and Stream Deck official software

If you have multiple Stream Deck enabled applications open at once they will fight for control of the button displays and all of the applications will respond to button presses at the same time.

This results in multiple actions taking place for a single button press depending on what is configured on the button in each application.

To avoid this make sure only one Stream Deck enabled app is running at once. This is likely to just be DCSFP and the Stream Deck's official software but this will also count for other 3rd party applications that have implemented Steam Deck support.

If you want to run DCSFP but have another app manage your Stream Deck(s) see below.

Note that it is not possible to manage multiple individual Stream Decks on one computer with different applications. They all must talk to the same application.

How to turn off Stream Deck support in DCSFP

Some users want to use the official or other 3rd party Stream Deck software. To have DCSFP not load the any Stream Deck(s) add the parameter -NoStreamDeck to the start command.

e.g. C:\apps\dcsflightpanels\dcsfp.exe -NoStreamDeck

Profile Assets

Assets used in DCSFP Stream Deck profiles must be uniquely named

Images

  • Use images of format .png, .jpg or .jpeg.
  • Optimal resolution is 144x144
  • Optimal aspect ratio is 1:1 other aspects will be stretched to fit.

Tip: Elgato's keycreator web app can help you make some icons to get started with https://www.elgato.com/en/keycreator.

This repo is highly recommended for DCS specific icons https://github.com/Togg-streamdeck/dcs.

Sounds

  • Use sound files of format .mp3 or .wav

Programming Stream Deck Profiles

Actions

Actions are what are triggered when interacting with a Stream Deck button. You can program two actions for each button, one for when the button is pressed and one for when it is released.

Each action can have a series of commands assigned to it and these can be configured to launch as a one shot macro or sequentially on each action state trigger.

This gives you extremely configurable behaviour compared to having a single action per button at the cost of some extra work during programming in some situations. The trade off is worth it however because it allows you to manipulate almost any type of virtual control with Stream Deck's momentary buttons.

Action Types

Action types are mutually exclusive per button, you cannot have one action type on press and another on release but you can have multiple action types on different buttons on one profile.

There are 4 main action types:

  • Key Press - Simulates keyboard inputs
  • DCS-BIOS - Sends API commands directly to DCS to control switches as though you had controlled them in game with your mouse.
  • OS Command - Run a command line script or launch an application e.g. a batch file or powershell script.
  • Layer Navigation - Switch to a specified layer.

Additionally there is one meta-action which can be applied alongside the main actions.

  • Play Sound - allows sound files to be triggered when the button is pressed. The volume of the sound file playback can also be adjusted.

Button displays

Layers