StreamDeckSharp 10.0.0


StreamDeckSharp is a simple (unofficial) .NET interface for the Elgato Stream Deck

license GitHub release Nuget version

Recent Changes

Quickstart (TL;DR)

Should work on all major operating systems.
I typically test on Windows and Linux (Debian, Ubuntu), but it should also work on macOS. See Wiki: Supported Platforms

  1. Add StreamDeckSharp reference (via nuget or download latest release)
  2. Add a using directive for StreamDeckSharp: using StreamDeckSharp;
I want to... Code (C#)
create a device reference var deck = StreamDeck.OpenDevice();
set the brightness deck.SetBrightness(50);
create bitmap for key var bitmap = KeyBitmap.Create.FromFile("icon.png")
set key image deck.SetKeyBitmap(keyId, bitmap)
clear key image deck.ClearKey(keyId)
process key events deck.KeyStateChanged += KeyHandler;

Make sure to dispose the device reference correctly (use using whenever possible)

Examples

If you want to see some examples take a look at the example projects.
Here is a short example called "Austria". Copy the code and start hacking :wink:

using System;
using OpenMacroBoard.SDK;
using StreamDeckSharp;

namespace StreamDeckSharp.Examples.Austria
{
    class Program
    {
        static void Main(string[] args)
        {
            //This example is designed for the 5x3 (original) Stream Deck.

            //Create some color we use later to draw the flag of austria
            var red = KeyBitmap.Create.FromRgb(237, 41, 57);
            var white = KeyBitmap.Create.FromRgb(255, 255, 255);
            var rowColors = new KeyBitmap[] { red, white, red };

            //Open the Stream Deck device
            using (var deck = StreamDeck.OpenDevice())
            {
                deck.SetBrightness(100);

                //Send the bitmap informaton to the device
                for (int i = 0; i < deck.Keys.Count; i++)
                    deck.SetKeyBitmap(i, rowColors[i / 5]);

                Console.ReadKey();
            }
        }
    }
}

Here is what the "Rainbow" example looks like after pressing some keys

Rainbow example photo

Play games on a StreamDeck

For example minesweeper (take a look at the example projects if you are interested in that)

You can even play videos on a StreamDeck

Here is a short demo, playing a video on a stream deck device.

Demo video of the example
*The glitches you can see are already fixed.

More about that in the Wiki: Play video on StreamDeck



Showing the top 20 packages that depend on StreamDeckSharp.

Packages Downloads
Lib.StreamDeck
Package Description
29
Lib.StreamDeck
Package Description
28
Lib.StreamDeck
Package Description
14
Lib.StreamDeck
Package Description
8

.NET 10.0

Version Downloads Last updated
10.0.0 8 06/22/2026
6.1.0 26 10/26/2025
6.0.0 32 02/19/2025
5.0.0 33 02/19/2025
4.2.0-preview 32 02/19/2025
4.1.0-preview 32 02/19/2025
4.0.0-preview 32 02/19/2025
3.2.0 32 02/19/2025
3.0.0 32 02/19/2025
2.2.0 30 02/19/2025
2.1.0 32 02/19/2025
2.0.0 31 02/19/2025
1.0.0 30 02/19/2025
0.3.5 32 02/19/2025
0.3.4 32 02/19/2025
0.3.2 31 02/19/2025
0.3.1 32 02/19/2025
0.3.0 32 02/19/2025
0.2.0 33 02/19/2025
0.1.10 30 02/19/2025
0.1.9 31 02/19/2025
0.1.8 32 02/19/2025
0.1.7 32 02/19/2025
0.1.5 32 02/19/2025
0.1.4 32 02/19/2025
0.1.2 32 02/19/2025
0.1.1 31 02/19/2025