Skip to content

Biomechaniac/streamdeck-plugintemplate

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

33 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Stream Deck Plugin Template

The Stream Deck Plugin Template is a boilerplate template to let you get started quickly when writing a Javascript plugin for Stream Deck.

Stream Deck Plugin Template requires Stream Deck 4.1 or later.

Description

Stream Deck Plugin Template is a complete plugin that shows you how to

  • load and save settings using Stream Deck's persistent store
  • setup and communicate with the Property Inspector
  • pass messages directly from Property Inspector to the plugin (and vice versa)
  • localize your Property Inspector's UI to another language

If you think about creating a Stream Deck plugin, it's a good idea to start with this template, because it already implements all code required to communicate from your plugin to the Property Inspector and to your Stream Deck.

There are also a bunch of utility helpers included, which makes it easy to process messages sent and received via Websockets.

Together with the PISamples library it helps you create your full-fledged Stream Deck plugin fast.

Features:

Features:

  • code written in Javascript
  • cross-platform (macOS, Windows)
  • localization support
  • styled Property Inspector included
  • Property Inspector contains all required boilerplate code to let you instantly work on your plugin's code.

Quickstart: From Template to Plugin in under a minute

A short guide to help you getting started quickly.

Pre-requisites

  • Download or clone the template plugin.

Do a search/replace on strings in the template's files:

Use your utility of choice (or your terminal) to do a full string replace using:

Replace all occurences of:

de.biomechaniac.streamdeck.aquasuite with your.identifier.plugin

and:

Aquasuite Monitoring with Your Plugin Name

Fire up your preferred code-editor and open app.js.

Remove what you don't need and start coding (e.g. in the onKeyDown method)

Happy coding...

Aquasuite Monitoring Plugin

How-To

Aquasuite setup

  • In your aquasuite go to "aquasuite web" → "Data export"
  • Follow the instructions to export all the sensor data that you want to display on your streamdeck
  • Then go to "Data access" and copy your access code

Plugin setup

  • Download the Plugin from the Streamdeck Store
  • Drag the Action to your Streamdeck
  • Enter your Aquasuite access code

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 61.6%
  • CSS 36.0%
  • HTML 2.4%