StreamDeck-Tools
6.1.1
See the version list below for details.
dotnet add package StreamDeck-Tools --version 6.1.1
NuGet\Install-Package StreamDeck-Tools -Version 6.1.1
<PackageReference Include="StreamDeck-Tools" Version="6.1.1" />
paket add StreamDeck-Tools --version 6.1.1
#r "nuget: StreamDeck-Tools, 6.1.1"
// Install StreamDeck-Tools as a Cake Addin #addin nuget:?package=StreamDeck-Tools&version=6.1.1 // Install StreamDeck-Tools as a Cake Tool #tool nuget:?package=StreamDeck-Tools&version=6.1.1
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.
Author's website and contact information: https://barraider.com
Stream Deck+ Support
Instead of PluginBase
, Derive from either KeypadBase
(if you don't support dials), EncoderBase
(for only dials), KeyAndEncoderBase
(for both keys and dials)
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 https://barraider.com/profiles
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 6.1
- Support for new
DialDown
andDialUp
events. - Removed support for deprecated
DialPress
event
Version 6.0
- Merged streamdeck-client-csharp package into library to allow better logging of errors
- Added support for SD+ SDK
- Increased timeout of connection to Stream Deck due to the Stream Deck taking longer than before to reply on load
- Added error catching to prevent 3rd party plugin exception to impact communication
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
andTools.FilenameFromPayload
methods - Removed obsolete MD5 functions, use SHA512 functions instead
Tools.CenterText
function now has optional outtextFitsImage
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
2019-11-17
- 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 Compatible and additional computed target framework versions. |
---|---|
.NET | net5.0 was computed. net5.0-windows was computed. net6.0 was computed. net6.0-android was computed. net6.0-ios was computed. net6.0-maccatalyst was computed. net6.0-macos was computed. net6.0-tvos was computed. net6.0-windows was computed. net7.0 was computed. net7.0-android was computed. net7.0-ios was computed. net7.0-maccatalyst was computed. net7.0-macos was computed. net7.0-tvos was computed. net7.0-windows was computed. net8.0 was computed. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. |
.NET Core | netcoreapp2.0 was computed. netcoreapp2.1 was computed. netcoreapp2.2 was computed. netcoreapp3.0 was computed. netcoreapp3.1 was computed. |
.NET Standard | netstandard2.0 is compatible. netstandard2.1 was computed. |
.NET Framework | net461 was computed. net462 was computed. net463 was computed. net47 was computed. net471 was computed. net472 was computed. net48 was computed. net481 was computed. |
MonoAndroid | monoandroid was computed. |
MonoMac | monomac was computed. |
MonoTouch | monotouch was computed. |
Tizen | tizen40 was computed. tizen60 was computed. |
Xamarin.iOS | xamarinios was computed. |
Xamarin.Mac | xamarinmac was computed. |
Xamarin.TVOS | xamarintvos was computed. |
Xamarin.WatchOS | xamarinwatchos was computed. |
-
.NETStandard 2.0
- CommandLineParser (>= 2.9.1)
- Newtonsoft.Json (>= 13.0.2)
- NLog (>= 5.1.1)
- System.Drawing.Common (>= 7.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (3)
Showing the top 3 popular GitHub repositories that depend on StreamDeck-Tools:
Repository | Stars |
---|---|
mhwlng/streamdeck-elite
Elgato Stream Deck plugin for Elite Dangerous
|
|
mhwlng/streamdeck-starcitizen
Elgato Stream Deck button plugin for Star Citizen
|
|
BarRaider/streamdeck-voicemeeter
VoiceMeeter integration for Stream Deck
|
Version | Downloads | Last updated |
---|---|---|
6.2.0 | 1,220 | 1/23/2024 |
6.1.1 | 1,769 | 4/26/2023 |
6.1.0 | 695 | 4/25/2023 |
6.0.0 | 1,147 | 2/12/2023 |
5.9.1-Beta1 | 638 | 12/22/2022 |
5.9.0-Beta1 | 622 | 12/8/2022 |
3.2.0 | 3,668 | 1/20/2021 |
3.1.0 | 2,077 | 11/29/2020 |
3.0.0 | 1,135 | 10/1/2020 |
2.9.0 | 1,198 | 6/25/2020 |
2.8.0 | 1,124 | 4/27/2020 |
2.7.0 | 1,581 | 1/2/2020 |
2.6.0 | 1,373 | 9/29/2019 |
2.5.0 | 1,164 | 8/12/2019 |
2.4.2 | 1,086 | 7/15/2019 |
2.3.0 | 1,027 | 7/9/2019 |
2.2.0 | 1,234 | 5/24/2019 |
2.0.1 | 1,240 | 3/8/2019 |
2.0.0 | 1,467 | 3/4/2019 |
1.1.6 | 1,233 | 2/18/2019 |
1.1.5 | 1,162 | 2/15/2019 |
1.1.1 | 1,166 | 2/9/2019 |
6.1.1 - Removed error being logged for DialPress events
- Support for new DialDown and DialUp events.
Removed support for deprecated DialPress event