Open Stream Deck

Open Stream Deck это открытый стек для управления макропадом с кнопками и дисплеем. Проект состоит из трёх частей, которые работают вместе, но развиваются и собираются независимо.

Часть	Репозиторий	Что делает
Приложение	`open-stream-deck`	Настольное приложение на Tauri. Хранит профили и страницы, рисует кнопки, связывается с устройством и запускает плагины.
Прошивка	`Frimware-AjazzAKP153R`	Программа для микроконтроллера AJAZZ AKP153R. Принимает команды по USB HID, рисует на дисплее и передаёт нажатия.
SDK	`Open-Stream-Deck-SDK`	Крейт `opensd` для Rust, API для JavaScript и TypeScript, CLI `opensd`. Плагин распространяется одним файлом `.opensd` и работает в песочнице приложения.

Как части связаны

Приложение решает, что показать на каждой кнопке. Прошивка получает готовые команды рисования, отдаёт нажатия и состояние устройства. Плагины работают внутри приложения в изолированных воркерах, получают события кнопок и просят изменить подписи, картинки и состояния.

Поддерживаемое оборудование

Сейчас поддерживается одно устройство: AJAZZ AKP153R с 15 кнопками (сетка 5 × 3), дисплеем 480 × 854 и боковой полосой из трёх слотов на каждой странице. Архитектура разделяет логику приложения и протокол устройства, поэтому добавление новых моделей планируется без переписывания приложения.

С чего начать

Пользователю: установка и запуск приложения, затем работа с интерфейсом.
Разработчику приложения: архитектура и разработка.
Тем, кто хочет прошить устройство: сборка прошивки и установка.
Автору плагинов: быстрый старт SDK.

Прошивка меняет устройство

Установка прошивки перезаписывает область приложения во flash. Загрузчик производителя не затрагивается, но перед записью убедитесь, что образ собран для вашей модели и версии.