Facilitates creation of custom Stream Deck plugins by extending a plugin class and handling events through use cases. Supports building plugins via a Gradle plugin.
A Kotlin SDK to create Stream Deck plugins.
Add the gradle plugin and the dependency to your build.gradle(.kts):
plugins {
id("me.nathanfallet.streamdeck") version "1.2.0"
}
dependencies {
implementation("me.nathanfallet.streamdeck:streamdeck-kotlin-sdk:1.2.0")
}Create a plugin is really simple, you just need to extend the Plugin class:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
}
}And add a main function to your application to start it:
fun main(args: Array<String>) = MyAwesomePlugin().main(args)Update your build.gradle(.kts) to register your plugin id and main class:
application {
mainClass = "me.nathanfallet.myawesomeplugin.MyAwesomePluginKt"
}
streamDeckPlugin {
pluginId = "me.nathanfallet.myawesomeplugin"
}To handle events, create a usecase that implements IHandleEventUseCase.
There are two ways to handle events:
class HandleKeyDownUseCase : IHandleEventUseCase {
override suspend fun invoke(input1: IEvent, input2: IPlugin) {
if (input1 !is KeyDownEvent) return
println("Key down event received for key ${input1.payload.coordinates.column}x${input1.payload.coordinates.row}")
}
}And register it in your plugin:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
registerUseCase(HandleKeyDownUseCase()) // Add this
}
}class HandleEventsUseCase(
private val handleKeyDownUseCase: HandleKeyDownUseCase,
// Add other usecases here
) : IHandleEventUseCase {
override suspend fun invoke(input1: IEvent, input2: IPlugin) {
when (input1) {
is KeyDownEvent -> handleKeyDownUseCase(input1, input2)
else -> return // Ignore other events
}
}
}class HandleKeyDownUseCase : IPairSuspendUseCase<KeyDownEvent, IPlugin> {
override suspend fun invoke(input1: KeyDownEvent, input2: IPlugin) {
println("Key down event received for key ${input1.payload.coordinates.column}x${input1.payload.coordinates.row}")
}
}And register it in your plugin:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
registerUseCase(
HandleEventsUseCase(
HandleKeyDownUseCase(),
// Add other usecases here
)
)
}
}Create a manifest.json file in your src/main/resources folder (along with any other assets you want to include in
the plugin, like action icons).
Thanks to the gradle plugin, you can use the ./gradlew buildStreamDeckPlugin command (or the buildStreamDeckPlugin
task from your IDE) to build the build/<pluginId>.sdPlugin folder containing the plugin.
You might also need to adjust the manifest file first for it to match with your gradle project name:
{
"CodePathMac": "bin/my-awesome-plugin",
"CodePathWin": "bin/my-awesome-plugin.bat"
}
A Kotlin SDK to create Stream Deck plugins.
Add the gradle plugin and the dependency to your build.gradle(.kts):
plugins {
id("me.nathanfallet.streamdeck") version "1.2.0"
}
dependencies {
implementation("me.nathanfallet.streamdeck:streamdeck-kotlin-sdk:1.2.0")
}Create a plugin is really simple, you just need to extend the Plugin class:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
}
}And add a main function to your application to start it:
fun main(args: Array<String>) = MyAwesomePlugin().main(args)Update your build.gradle(.kts) to register your plugin id and main class:
application {
mainClass = "me.nathanfallet.myawesomeplugin.MyAwesomePluginKt"
}
streamDeckPlugin {
pluginId = "me.nathanfallet.myawesomeplugin"
}To handle events, create a usecase that implements IHandleEventUseCase.
There are two ways to handle events:
class HandleKeyDownUseCase : IHandleEventUseCase {
override suspend fun invoke(input1: IEvent, input2: IPlugin) {
if (input1 !is KeyDownEvent) return
println("Key down event received for key ${input1.payload.coordinates.column}x${input1.payload.coordinates.row}")
}
}And register it in your plugin:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
registerUseCase(HandleKeyDownUseCase()) // Add this
}
}class HandleEventsUseCase(
private val handleKeyDownUseCase: HandleKeyDownUseCase,
// Add other usecases here
) : IHandleEventUseCase {
override suspend fun invoke(input1: IEvent, input2: IPlugin) {
when (input1) {
is KeyDownEvent -> handleKeyDownUseCase(input1, input2)
else -> return // Ignore other events
}
}
}class HandleKeyDownUseCase : IPairSuspendUseCase<KeyDownEvent, IPlugin> {
override suspend fun invoke(input1: KeyDownEvent, input2: IPlugin) {
println("Key down event received for key ${input1.payload.coordinates.column}x${input1.payload.coordinates.row}")
}
}And register it in your plugin:
class MyAwesomePlugin : Plugin() {
override fun onEnable() {
// Setup your plugin here
registerUseCase(
HandleEventsUseCase(
HandleKeyDownUseCase(),
// Add other usecases here
)
)
}
}Create a manifest.json file in your src/main/resources folder (along with any other assets you want to include in
the plugin, like action icons).
Thanks to the gradle plugin, you can use the ./gradlew buildStreamDeckPlugin command (or the buildStreamDeckPlugin
task from your IDE) to build the build/<pluginId>.sdPlugin folder containing the plugin.
You might also need to adjust the manifest file first for it to match with your gradle project name:
{
"CodePathMac": "bin/my-awesome-plugin",
"CodePathWin": "bin/my-awesome-plugin.bat"
}