Безкоштовно з 2018 року, відкритий код з 2021 року

Чому Macro Deck?

Macro Deck - це більше, ніж альтернатива Stream Deck. Це гнучка платформа автоматизації з відкритим кодом, довгою історією, живою спільнотою та екосистемою, яку може розширити будь-хто.

Перетворіть телефони, планшети й браузери, які у вас уже є, на панель керування комп’ютером, яку можна налаштувати, і самі вирішуйте, що відбувається за кожною кнопкою.

Дека на планшеті: музичний програвач, годинник, прогноз погоди, повзунок гучності, графік навантаження CPU та різнокольорові кнопки дійТа сама дека на телефоні в горизонтальному положенні

З 2018 року

Одна з перших безкоштовних альтернатив Stream Deck

Завдяки Stream Deck від Elgato окремі макроклавіші стали звичним елементом на столах стримерів. У листопаді 2018 року Macro Deck з’явився на форумі OBS з іншою ідеєю: безкоштовний макропад без реклами, який працює на Android-пристрої, що вже є у вас.

Відтоді він розвивався від випуску до випуску під впливом тих, хто ним користується, і з набору папок із ярликами перетворився на кросплатформну платформу автоматизації.

Прочитати оригінальне повідомлення на форумі OBS
  1. Листопад 2018

    Перший випуск

    Комбінації клавіш, мультимедійні клавіші, запуск застосунків і папки на Android-пристрої, підключеному до ПК через Wi-Fi.

    Вікно Macro Deck Server 1.1.6 Beta: сітка кнопок макросів, ліворуч список дій, праворуч стан підключення й теки
  2. Macro Deck 2

    Підтримка плагінів

    Застосунок для Windows із плагінами, завдяки яким з’явилися такі інтеграції, як OBS Studio та Discord. У листопаді 2021 року вихідний код відкрито за ліцензією Apache 2.0.

    Вікно Macro Deck 2 з бічною панеллю, теками й сіткою кнопок: годинник, заряд гарнітури та вимкнений мікрофон
  3. Macro Deck 3

    Платформа

    Хост для Windows, macOS і Linux, веб-клієнт, нативні застосунки Companion, SDK для плагінів і Store з перевіркою.

    Редактор деки Macro Deck 3 з музичним плеєром, годинником, погодою, повзунком гучності, графіком ЦП і кольоровими кнопками дій

Автоматизація

Справжня логіка, а не просто комбінації клавіш

Кнопка вміє більше, ніж надсилати гарячу клавішу. Дії виконуються як ланцюжки з умовами, циклами й паузами, реагують на живі значення, а автоматизації запускають їх без чийогось натискання.

В ефір

  1. НатисканняКоротке натискання кнопки

  2. Ifstream_live дорівнює true

    • Натиснути гарячу клавішу зупинки
    • Задати stream_live значення false
    • Зробити кнопку червоною
  3. Else ifНавантаження CPU вище за 85 і грає Spotify

    • Надіслати сповіщення замість виходу в ефір
  4. OtherwiseНіщо не заважає

    • Зменшити гучність Spotify
    • Повторити 3 рази: встановити рамку Блимання, зачекати 1 секунду
    • Натиснути гарячу клавішу запуску
    • Задати stream_live значення true
    • Зробити кнопку зеленою
Одне натискання, три наслідки. Це справжній ланцюжок дій цієї кнопки в тому вигляді, в якому він показаний у редакторі.
Ланцюжок «В ефір» у редакторі Macro Deck: блок If / Else з гілкою Else if, що поєднує дві умови, та гілка Otherwise з циклом Repeat, паузою Wait, гарячими клавішами, змінними та зміною кольору
Умови та цикли
If, Else if і Else зі складеними умовами, а також Repeat і Wait.
Змінні
Живі значення з вашого комп’ютера та інтеграцій: їх можна показувати на кнопках і використовувати в умовах.
Події
Запускайте автоматизацію за розкладом, під час підключення пристрою, зміни змінної або початку трансляції в OBS.
Стани кнопки
Дайте кнопці кілька станів із власним виглядом або прив’яжіть її до змінної, наприклад до статусу мікрофона в Discord.
Інші комп’ютери
З Macro Deck Delegate кнопка запускає скрипт на іншому ПК та імпортує змінні, які він надає.
Живі віджети
Повзунки, індикатори, графіки, музичні програвачі та віджети чату показують, що відбувається, і реагують на дотики.

Корисно не лише для стримінгу

Продуктивність
Наступна зустріч і непрочитані листи завжди перед очима, а в задану годину можна перемикатися на робочий профіль.
Системне адміністрування
Стежте за CPU та RAM на індикаторах, запускайте команди й зберігайте їхній вивід у змінну або ставте AdGuard Home на паузу.
Розумний дім
Вмикайте світло, запускайте сцени та показуйте актуальні стани Home Assistant на кнопках, які відображають реальний стан.
Власні сценарії
Звертайтеся до будь-якого веб-API через інтеграцію HTTP або запускайте скрипти AutoHotkey у Windows.

Store плагінів

Плагіни спільноти з відстежуваним походженням

Store всередині Macro Deck пропонує плагіни, які підтримує спільнота. Його вирізняє шлях, який проходить кожен плагін: він збирається з відкритого вихідного коду, його перевіряє людина, і він підписується до того, як ви зможете його встановити.

  1. Публічний репозиторій

    Вихідний код відкритий на GitHub за ліцензією з відкритим кодом. Залежності беруться з публічних пакетів NuGet, а вбудовані готові сторонні бібліотеки не допускаються.

  2. Довірена публікація

    Випуск із тегом запускає власний робочий процес випуску Macro Deck. GitHub підтверджує репозиторій, коміт і робочий процес, тож бінарний файл, зібраний деінде, завантажити не можна, а в авторів немає ні токена публікації, ні ключа підпису.

  3. Перевірка ШІ та людиною

    Кожне перше надсилання й кожне оновлення проходять автоматичні перевірки та аналіз за допомогою ШІ, а потім потрапляють до модератора-людини, який ухвалює рішення. Під час перевірки враховують правила Store, потенційно шкідливу поведінку, проблеми безпеки та залежності.

  4. Криптографічний підпис

    Після схвалення Creator Portal підписує пакет. Його сертифікат пов’язаний ланцюжком із кореневим ключем Macro Deck, який зберігається офлайн.

  5. Офіційний Store

    Пакет публікується через підписаний реєстр. Macro Deck перевіряє його підпис перед встановленням і потім щоразу, коли запускає плагін.

Що ви бачите в Macro Deck

Дійсний підпис показує, що пакет пройшов цей процес. Непідписані плагіни, наприклад ваші власні, і далі можна встановити, але різниця залишається помітною.

  • ПідписаноВстановлюється як зазвичай. Якщо його файли згодом змінити, плагін перестане завантажуватися.
  • Не підписаноMacro Deck спершу попередить вас. Встановлення відбудеться лише після вашого підтвердження, а плагін залишиться позначеним як неперевірений.
  • Недійсний підписВідхиляється. Підпис, який не проходить перевірку, підтвердити вручну не можна.

Після публікації

Macro Deck і далі перевіряє репозиторії опублікованих плагінів. Плагін, репозиторій якого став приватним або зник, вилучається зі списку після закінчення 14 днів, а відкликаний сертифікат блокує нові встановлення й оновлення.

Чого це не гарантує

Перевірки та підписи знижують ризик і підтверджують, звідки взято пакет. Вони не гарантують, що в плагіні немає вразливостей або шкідливого коду. Плагіни не ізольовані в пісочниці: вони працюють із правами вашого облікового запису, тому ставтеся до встановлення плагіна так само, як до встановлення будь-якої іншої програми.

Володіння

Він працює на вашому комп’ютері, і підписки немає

Усе локально, обліковий запис не потрібен

Macro Deck працює на вашому власному комп’ютері, а ваші пристрої підключаються до нього напряму. Основні функції не залежать від хмарних сервісів Macro Deck, а для роботи не потрібен обліковий запис Macro Deck.

  • Розміщується у вас, на вашому комп’ютері
  • Ваша конфігурація залишається під вашим контролем
  • Обліковий запис Macro Deck не потрібен
  • Для основних функцій хмарний сервіс не потрібен
  • Хост із відкритим кодом за ліцензією Apache 2.0

Облікові записи необов’язкові й додають такі можливості, як прив’язка ліцензії Companion до вашого облікового запису або оцінювання елементів Store.

Інтеграціям з онлайн-сервісами, як-от Spotify чи Twitch, і далі потрібен доступ до інтернету, як і Store та активації покупки Companion.

Скільки це коштує

Хост Macro DeckБезкоштовноБезкоштовно і з відкритим кодом, для Windows, macOS і Linux.
Веб-клієнтБезкоштовноПовноцінний спосіб користуватися декою в сучасному браузері у вашій мережі, нічого не встановлюючи.
Застосунки CompanionОдноразова покупкаНативні застосунки для Android та iOS із закритим вихідним кодом і 7-денним безкоштовним пробним періодом на кожному пристрої.

Одна ліцензія діє на обох платформах. Ви купуєте її один раз у застосунку, строк її дії не обмежений, а Macro Deck передає її іншим вашим пристроям Android та iOS, які підключаються до вашого комп’ютера.

Застосунки малюють деки нативно, самі знаходять ваші комп’ютери в мережі та додають жести, тактильний відгук, USB без налагодження і дії для самого пристрою. У веб-клієнті ваші деки виглядають так само.

Пристрої

Використовуйте пристрої, які у вас уже є

Запасний телефон, старий планшет або вікно браузера можуть стати вашою панеллю керування, тож купувати окреме обладнання не потрібно. Підключайте одразу кілька пристроїв, кожен зі своїм профілем і компонуванням.

Настільний застосунок Macro Deck з редактором декиЕкран «Підключення» застосунку Companion на телефоні: підключення через USB і два збережені комп’ютери
Хост Macro DeckWindows, macOS і Linux
  • Веб-клієнтБудь-який сучасний браузер
  • AndroidЗастосунок Companion
  • iOSЗастосунок Companion
Через мережу
Пристрої підключаються до вашого комп’ютера напряму. Застосунки Companion знаходять його самі, а веб-клієнт відкривається за адресою або QR-кодом.
Через USB
Android підключається через ADB із застосунком Companion або веб-клієнтом. Застосунки Companion для Android та iOS можуть також підключатися без налагодження через USB, але ця можливість поки експериментальна.
Одночасно
Тримайте телефон для чату й планшет для сцен. Різні пристрої можуть одночасно відкривати різні профілі.

Розробникам

Створюйте інтеграцію, а не інфраструктуру

SDK для плагінів дає вам ті самі контракти, які використовують вбудовані інтеграції. Ви пишете на C#, а Macro Deck бере на себе пристрої, налаштування, відтворення та поширення.

SDK для плагінів
Задокументовані пакети .NET для дій, змінних, подій, віджетів, екранів налаштування та постачальників пристроїв.
CLI
macrodeck-plugin створює, запускає, тестує, перевіряє та пакує плагін без встановленого Macro Deck.
Creator Portal
Підключайте свій репозиторій, керуйте збірками, тестувальниками та випусками й публікуйте в Store.
Публічні API
Отримуйте статус і аналітику своїх проєктів через Public API для дашбордів, бейджів і CI.

А якщо хочеться зрозуміти, як щось працює, хост має відкритий вихідний код.

~ % macrodeck-plugin new --name "Hello Deck" --publisher Acme -yCreated plugin project at '~/HelloDeck'.Manifest: ~/HelloDeck/src/HelloDeck/manifest.jsonBuild configuration: ~/HelloDeck/src/HelloDeck/macrodeck-build.json~ % cd HelloDeck/src/HelloDeckHelloDeck % macrodeck-plugin run --project . --watchUsing host at http://127.0.0.1:52417.Developer Mode is enabled; a pairing prompt will appear in Macro Deck.Started process 70511 (mode: SelfRegistering, host: http://127.0.0.1:52417). Press Ctrl-C to stop.Watching the project: a saved change is applied with .NET Hot Reload, or rebuilds and restarts the plugin. Open developer previews in Macro Deck follow along.[plugin] dotnet watch 🔥 Hot reload enabled. For a list of supported edits, see https://aka.ms/dotnet/hot-reload.[plugin] dotnet watch 💡 Press Ctrl+R to restart.[plugin] dotnet watch 🔨 Building ~/HelloDeck/src/HelloDeck/HelloDeck.csproj ...[plugin] dotnet watch 🔨 Build succeeded: ~/HelloDeck/src/HelloDeck/HelloDeck.csproj...[plugin] info: MacroDeck.Plugin.Hosting.Transport.PluginConnectionHostedService[0][plugin]       Registered with the host as '"com.example.hello-deck"'....[plugin] info: HelloDeck.PluginIntegration[0][plugin]       Initialized.^CStopping the plugin...The plugin exited within its 10s grace period.HelloDeck % macrodeck-plugin test --project .Macro Deck plugin conformance report (suite 1.3.0)Plugin: com.example.hello-deck 1.0.0Started: 2026-10-21T18:20:41.3954460+00:00, duration: 00:00:21.6978993Passed: 25, Failed: 0, Skipped: 24Conformant: yes[PASS] MDC0101 The plugin id is a valid reverse-domain package id (Required)[PASS] MDC0102 Every declared capability's local id is a valid declared-kind identifier (Required)...HelloDeck % macrodeck-plugin buildBuilding linux-x64...Building osx-arm64...Building win-x64...Built linux-x64, osx-arm64, win-x64.Packed com.example.hello-deck 1.0.0 -> ./com.example.hello-deck-1.0.0.macroDeckPlugin (46 entries, 5491783 bytes uncompressed).HelloDeck % 

Macro Deck UI

Плагіни можуть приносити власний інтерфейс

Плагіни не обмежуються додаванням дій і змінних. У Macro Deck є власний декларативний UI-фреймворк для C#: ви один раз описуєте подання як дерево компонентів, а Macro Deck відтворює його там, де воно потрібне: як віджет деки, екран налаштувань, подання папки або модальне вікно.

var muted = new UiState<bool>(false);

var tile = new UiButton
{
    Key = "mute",
    Justify = UiComponentJustify.Center,
    Background = UiValue.From(() => muted.Value ? "#ff3b30" : "#2c2c2e"),
    Events = [UiEventHandler.On(UiComponentEvents.Press, () => muted.Value = !muted.Value)],
    Children = [new UiTextRun
    {
        Key = "label",
        Text = UiText.From(() => muted.Value ? "Muted" : "Mute"),
        Size = 0.14,
    }],
};

var view = new UiView(request.Surface, tile);
Віджет Macrogotchi: шкали ситості, настрою та енергії, синій піксельний улюбленець, що спить, і шість кнопок під нимВіджет Macrogotchi на деці в редакторі Macro Deck поруч із кнопками дій
Macrogotchi - віджет, повністю намальований плагіном.

Macrogotchi показує, як далеко це можна зайти. Цей плагін із відкритим кодом тримає на деці віртуального улюбленця: шкали стану, піксельний спрайт із кольорових комірок і шість кнопок, і все це в одному віджеті.

Подання збираються з компонентів Macro Deck UI, як-от стеки, сітки, графіки, індикатори та повзунки, а не з вбудованих вебсторінок, тому вони добре вписуються в решту деки.

Спільнота

Створюється разом зі спільнотою з 2018 року

Macro Deck існує, бо люди й далі ним користуються, повідомляють про помилки та створюють те, чого бракує. Багато інтеграцій у Store підтримує спільнота, хост розробляється на GitHub, а подальші плани обговорюються публічно.

Спробуйте на пристрої, який у вас уже є

Macro Deck і його веб-клієнт можна безкоштовно завантажити та використовувати.

Elgato і Stream Deck є торговельними марками їхніх власників. Macro Deck - незалежний проєкт, не пов’язаний з Elgato і не схвалений цією компанією.