StreamDeck-Tools 5.9.0-Beta1

.NET Standard 2.0
This is a prerelease version of StreamDeck-Tools.
There is a newer version of this package available.
See the version list below for details.
dotnet add package StreamDeck-Tools --version 5.9.0-Beta1
NuGet\Install-Package StreamDeck-Tools -Version 5.9.0-Beta1
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="StreamDeck-Tools" Version="5.9.0-Beta1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add StreamDeck-Tools --version 5.9.0-Beta1
#r "nuget: StreamDeck-Tools, 5.9.0-Beta1"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install StreamDeck-Tools as a Cake Addin
#addin nuget:?package=StreamDeck-Tools&version=5.9.0-Beta1&prerelease

// Install StreamDeck-Tools as a Cake Tool
#tool nuget:?package=StreamDeck-Tools&version=5.9.0-Beta1&prerelease

BarRaider's Stream Deck Tools

C# library that wraps all the communication with the Stream Deck App, allowing you to focus on actually writing the Plugin's logic.

Build StatusNuGet

Author's website and contact information:

Stream Deck+ Support

Docs are still not ready, for support check our discord (link below). Read release information for usage.

Getting Started

Introducing our new wiki packed with usage instructions, examples and more.

Dev Discussions / Support

Discord: Discuss in #developers-chat in Bar Raiders

Downloadable Resources

  • StreamDeck-Tools Template for Visual Studio (2019/2022) - Automatically creates a project with all the files needed to compile a plugin. This is the best way to start a new plugin!
  • Install.bat - Script that quickly uninstalls and reinstalls your plugin on the streamdeck (edit the batch file for more details). Put the install.bat file in your BIN folder (same folder that has Debug/Release sub-folders)
  • EasyPI - Additional library used to easily pass information from the PI (Property Inspector) to your plugin.
  • Profiles Downloadable empty profiles for the XL (32-key), Classic (15-key), Mini (6-key) and Mobile devices at

Library Features

  • Encapsulates all the communicating with the Stream Deck, getting a plugin working on the Stream Deck only requires implementing the PluginBase class.
  • Sample plugin now included in this project on Github
  • Built-in integration with NLog. Use Logger.LogMessage() for logging.
  • Auto-populate user settings which were modified by the Property Inspector
  • Access the Global Settings from anywhere in your code
  • Simplified working with filenames from the Stream Deck SDK.
  • PluginActionId attribute let's you easily associate your code to a specific action defined in the manifest.json
  • Large set of helper functions to simplify creating images and sending them to the Stream Deck.

Change Log

Version 3.2 is out!

  • Created new ISDConnection interface which is now implemented by SDConnection and used by PluginAction.
  • GlobalSettingsManager now has a short delay before calling GetGlobalSettings(), to reduce spamming the Stream Deck SDK.
  • Updated dependencies to latest version

Version 3.1 is out!

  • Updated Logger class to include process name and thread id

Version 3.0 is out!

  • Updated file handling in Tools.AutoPopulateSettings and Tools.FilenameFromPayload methods
  • Removed obsolete MD5 functions, use SHA512 functions instead
  • Tools.CenterText function now has optional out textFitsImage value to verify the text does not exceed the image width
  • New Tools.FormatBytes function converts bytes to human-readable value
  • New Graphics.GetFontSizeWhereTextFitsImage function helps locate the best size for a text to fit an image on 1 line
  • Updated dependency packages to latest versions
  • Bug fix where FileNameProperty attribute

Version 2.7 is out!

  • Fully wrapped all Stream Deck events (All part of the SDConneciton class). See "Subscribing to events" section below
  • Added extension methods for multiple classes related to brushes/colors
  • Added additional methods under the Tools class, including AddTextPathToGraphics which can be used to correctly position text on a key image based on the Text Settings in the Property Inspector see "Showing Title based on settings from Property Inspector" section below.
  • Additional error checking
  • Updated dependency packages to latest versions
  • Sample plugin now included in this project on Github


  • Updated Install.bat (above) to newer version

Version 2.6 is out!

  • Added new MD5 functions in the Tools helper class
  • Optimized SetImage to not resubmit an image that was just posted to the device. Can be overridden with new property in Connection.SetImage() function.
Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (4)

Showing the top 4 popular GitHub repositories that depend on StreamDeck-Tools:

Repository Stars
Elgato Stream Deck plugin for Elite Dangerous
Create sophisticated macros easily and run them through your Stream Deck
VoiceMeeter integration for Stream Deck
Elgato Stream Deck button plugin for Star Citizen
Version Downloads Last updated
6.0.0 243 2/12/2023
5.9.1-Beta1 79 12/22/2022
5.9.0-Beta1 65 12/8/2022
3.2.0 2,413 1/20/2021
3.1.0 1,060 11/29/2020
3.0.0 430 10/1/2020
2.9.0 539 6/25/2020
2.8.0 517 4/27/2020
2.7.0 878 1/2/2020
2.6.0 666 9/29/2019
2.5.0 512 8/12/2019
2.4.2 428 7/15/2019
2.3.0 422 7/9/2019
2.2.0 535 5/24/2019
2.0.1 557 3/8/2019
2.0.0 652 3/4/2019
1.1.6 527 2/18/2019
1.1.5 527 2/15/2019
1.1.1 510 2/9/2019

4.0 - 1. Merged streamdeck-client-csharp package into library to allow better logging of errors
2. Increased timeout of connection to Stream Deck due to the Stream Deck taking longer than before to reply on load
3. Added error catching to prevent 3rd party plugin exception to impact communication