Getting started
Prerequisites
To interact with a physical Stream Deck device, ensure you have the following:
An iPad with a USB-C jack and Apple silicon chip (at least M1)
The Elgato Stream Deck Connect app installed
The Stream Deck Device Driver enabled in iOS settings app (Refer to the in-app instructions for guidance)
However, if you want to verify your implementation using the Stream Deck Simulator only, no additional prerequisites are necessary.
During the alpha phase, the app is not in available in the App Store. Click here to participate in the public alpha of Stream Deck Connect in TestFlight.
Installation
Package
You can add the library to your XCode project via Swift Package Manager. See "Adding package dependencies to your app".
If you want to add it to your own libraries Package.swift
, use this code instead:
Entitlements
In order to connect to the Stream Deck driver, you need to add the "Communicates with Drivers" (com.apple.developer.driverkit.communicates-with-drivers
) capability to your app target. Refer to "Adding capabilities to your app" for guidance.
First steps
Rendering content on a Stream Deck is very simple with SwiftUI, much like designing a typical app UI.
This code snippet demonstrates rendering a blue color across all buttons and displays on a device.
StreamDeckSession
operates as a singleton, meaning you should invoke setUp
only once throughout your application's life cycle.
To render content on specific areas, utilize the Stream Deck Layout system. StreamDeckLayout
with the @StreamDeckView
Macro provides predefined layout views to position content on a Stream Deck.
To check your layout during development, you can use the Simulator.
Last updated