abcminiuser/python-elgato-streamdeck

Python library to control the Elgato Stream Deck.

Python

1,136

434 commits

updated Aug 30, 2026

See the code

README

Python Elgato Stream Deck Library

Example Deck

This is an open source Python 3 library to control an Elgato Stream Deck directly, without the official software. This can allow you to create your own custom front-ends, such as a custom control front-end for home automation software.

Protocol documentation for various StreamDeck products are published the Elgato website.


PyPi Project Entry - Online Documentation - Source Code

Project Status:

Working - you can enumerate devices, set the brightness of the panel(s), set the images shown on each button, and read the current button states.

Currently the following StreamDeck products are supported in multiple hardware variants:

  • StreamDeck 6 Key, 15 Key and 32 Key Modules
  • StreamDeck Mini
  • StreamDeck Neo
  • StreamDeck Original
  • StreamDeck Pedal
  • StreamDeck Plus
  • StreamDeck Plus XL
  • StreamDeck Studio
  • StreamDeck XL

Package Installation:

Install the library via pip:

pip install streamdeck

Alternatively, manually clone the project repository:

git clone https://github.com/abcminiuser/python-elgato-streamdeck.git

For detailed installation instructions, refer to the prebuilt online documentation, or build the documentation yourself locally by running make html from the docs directory.

Credits:

Thank you to the following contributors, large and small, for helping with the development and maintenance of this library:

If you've contributed in some manner, but I've accidentally missed you in the list above, please let me know.

License:

Released under the MIT license.

python-library
streamdeck

abcminiuser/python-elgato-streamdeck

Python library to control the Elgato Stream Deck.

Python

1,136

434 commits

updated Aug 30, 2026

See the code

README

Python Elgato Stream Deck Library

Example Deck

This is an open source Python 3 library to control an Elgato Stream Deck directly, without the official software. This can allow you to create your own custom front-ends, such as a custom control front-end for home automation software.

Protocol documentation for various StreamDeck products are published the Elgato website.


PyPi Project Entry - Online Documentation - Source Code

Project Status:

Working - you can enumerate devices, set the brightness of the panel(s), set the images shown on each button, and read the current button states.

Currently the following StreamDeck products are supported in multiple hardware variants:

  • StreamDeck 6 Key, 15 Key and 32 Key Modules
  • StreamDeck Mini
  • StreamDeck Neo
  • StreamDeck Original
  • StreamDeck Pedal
  • StreamDeck Plus
  • StreamDeck Plus XL
  • StreamDeck Studio
  • StreamDeck XL

Package Installation:

Install the library via pip:

pip install streamdeck

Alternatively, manually clone the project repository:

git clone https://github.com/abcminiuser/python-elgato-streamdeck.git

For detailed installation instructions, refer to the prebuilt online documentation, or build the documentation yourself locally by running make html from the docs directory.

Credits:

Thank you to the following contributors, large and small, for helping with the development and maintenance of this library:

If you've contributed in some manner, but I've accidentally missed you in the list above, please let me know.

License:

Released under the MIT license.

python-library
streamdeck

Project health

Overall

3.5/10

Maintained

10/10

Code review

0/10
OpenSSF Scorecard

Significant stargazers

Frank Elsinga

186 followers · starred Jun 2020

Lukas Klingsbo

774 followers · starred Aug 2023

Jim Garrison

237 followers · starred Feb 2026

Antoine Beyeler

208 followers · starred Jan 2023