2018'den beri ücretsiz, 2021'den beri açık kaynak

Neden Macro Deck?

Macro Deck bir Stream Deck alternatifinden fazlasıdır. Uzun bir geçmişi, aktif bir topluluğu ve herkesin genişletebileceği bir ekosistemi olan, esnek ve açık kaynaklı bir otomasyon platformudur.

Elinizdeki telefonları, tabletleri ve tarayıcıları bilgisayarınız için özelleştirilebilir bir kontrol yüzeyine dönüştürün ve her düğmenin arkasında neler olacağına siz karar verin.

Bir tablette deck: müzik çalar, saat, hava durumu tahmini, ses kaydırıcısı, CPU grafiği ve renkli eylem düğmeleriAynı deck, yatay tutulan bir telefonda

2018’den beri

Ücretsiz Stream Deck alternatiflerinin ilklerinden biri

Elgato’nun Stream Deck’i, özel makro tuşlarını yayıncıların masalarında tanıdık bir görüntü haline getirdi. Kasım 2018’de Macro Deck, OBS Forum’da farklı bir fikirle ortaya çıktı: elinizdeki Android cihazda çalışan, ücretsiz ve reklamsız bir makro paneli.

O günden beri sürüm sürüm büyüdü, kullananların katkısıyla şekillendi ve kısayol klasörlerinden çok platformlu bir otomasyon platformuna dönüştü.

OBS Forum’daki özgün gönderiyi okuyun
  1. Kasım 2018

    İlk sürüm

    Bir Android cihazda klavye ve multimedya kısayolları, uygulama başlatıcıları ve klasörler; bilgisayara Wi-Fi üzerinden bağlanır.

    Macro Deck Server 1.1.6 Beta penceresi: makro düğmelerinden oluşan bir ızgara, solda eylem listesi, sağda bağlantı durumu ve klasörler
  2. Macro Deck 2

    Eklentilere açıldı

    Eklentili bir Windows uygulaması; OBS Studio ve Discord gibi entegrasyonları getirdi. Kaynak kodu Kasım 2021'de Apache 2.0 lisansıyla herkese açıldı.

    Kenar çubuğu, klasörler ve saat, kulaklık pili ile sessize alınmış mikrofon gösteren düğme ızgarasıyla Macro Deck 2 penceresi
  3. Macro Deck 3

    Bir platform

    Windows, macOS ve Linux için bir ana bilgisayar uygulaması, web istemcisi, yerel Companion uygulamaları, eklenti SDK’sı ve incelenen bir Store.

    Müzik çalar, saat, hava durumu, ses kaydırıcısı, CPU grafiği ve renkli eylem düğmeleriyle Macro Deck 3 deck düzenleyicisi

Otomasyon

Sadece kısayol değil, gerçek mantık

Bir düğme kısayol tuşu göndermekten fazlasını yapabilir. Eylemler koşullar, döngüler ve beklemelerle akışlar olarak çalışır, canlı değerlere tepki verir ve otomasyonlar bunları kimse hiçbir şeye basmadan çalıştırır.

Go live

  1. PressDüğmeye kısa basış

  2. Ifstream_live true ise

    • Durdurma kısayolunu gönder
    • stream_live değerini false yap
    • Düğmeyi kırmızı yap
  3. Else ifCPU yükü 85’in üzerinde ve Spotify çalıyorsa

    • Yayına geçmek yerine bildirim gönder
  4. OtherwiseÖnünde bir engel yoksa

    • Spotify ses düzeyini düşür
    • 3 kez tekrarla: kenarlığı Yanıp sön yap, 1 saniye bekle
    • Başlatma kısayolunu gönder
    • stream_live değerini true yap
    • Düğmeyi yeşil yap
Tek basış, üç sonuç. Bu, düğmenin arkasındaki gerçek akıştır ve düzenleyicide göründüğü gibidir.
Macro Deck düzenleyicisinde Go live akışı: iki koşulu birleştiren bir Else if içeren If / Else bloğu ile Repeat döngüsü, Wait beklemesi, kısayol tuşları, değişkenler ve renk değişiklikleri içeren bir Otherwise dalı
Koşullar ve döngüler
Birleştirilmiş koşullarla If, Else if ve Else, ayrıca Repeat ve Wait.
Değişkenler
Bilgisayarınızdan ve entegrasyonlardan gelen, düğmelerde gösterilen ve koşullarda kullanılan canlı değerler.
Olaylar
Bir otomasyonu zamanlanmış olarak, bir cihaz bağlandığında, bir değişken değiştiğinde veya OBS yayına başladığında çalıştırın.
Düğme durumları
Bir düğmeye kendi görünümü olan birkaç durum verin ya da onu Discord’daki sessize alma durumunuz gibi bir değişkeni izleyecek şekilde ayarlayın.
Diğer bilgisayarlar
Macro Deck Delegate ile bir düğme başka bir bilgisayarda betik çalıştırır ve o bilgisayarın paylaştığı değişkenleri içe aktarır.
Canlı widget’lar
Kaydırıcılar, göstergeler, grafikler, müzik çalarlar ve sohbet widget’ları olup biteni gösterir ve dokunmaya yanıt verir.

Yayıncılığın çok ötesinde de kullanışlı

Verimlilik
Bir sonraki toplantınızı ve okunmamış e-postalarınızı tek bakışta görün, belirlediğiniz saatte iş profilinize geçin.
Sistem yönetimi
CPU ve RAM’i göstergelerde izleyin, komutlar çalıştırıp çıktılarını bir değişkende tutun ya da AdGuard Home’u duraklatın.
Ev otomasyonu
Işıkları açıp kapatın, sahneleri çalıştırın ve gerçek durumu yansıtan düğmelerde Home Assistant durumlarını canlı gösterin.
Özel iş akışları
HTTP entegrasyonuyla herhangi bir web API’sini çağırın ya da Windows’ta AutoHotkey betikleri çalıştırın.

Eklenti Store’u

Kaynağı izlenebilir topluluk eklentileri

Macro Deck içindeki Store, topluluk tarafından sürdürülen eklentiler sunar. Onu farklı kılan, bir eklentinin oraya nasıl ulaştığıdır: her biri herkese açık kaynak koddan derlenir, bir kişi tarafından incelenir ve siz kurmadan önce imzalanır.

  1. Herkese açık depo

    Kaynak kod, açık kaynak lisansıyla GitHub’da herkese açıktır. Bağımlılıklar herkese açık NuGet paketlerinden gelir; önceden derlenmiş üçüncü taraf kitaplıklarının pakete eklenmesine izin verilmez.

  2. Güvenilir yayınlama

    Etiketlenmiş bir sürüm, Macro Deck’in kendi sürüm iş akışını çalıştırır. GitHub depoyu, commit’i ve iş akışını doğrular; böylece başka yerde derlenmiş bir ikili dosya yüklenemez ve geliştiricilerde yayınlama belirteci ya da imzalama anahtarı bulunmaz.

  3. Yapay zekâ ve insan incelemesi

    Her ilk gönderim ve her güncelleme otomatik kontrollerden ve yapay zekâ destekli analizden geçer, ardından kararı veren bir insan moderatöre gider. İncelemeler Store kurallarına, olası kötü amaçlı davranışlara, güvenlik sorunlarına ve bağımlılıklara bakar.

  4. Kriptografik imzalama

    Onaydan sonra Creator Portal paketi imzalar. Sertifikası, çevrimdışı tutulan bir Macro Deck kök anahtarına bağlanır.

  5. Resmî Store

    Paket, imzalı bir kayıt defteri üzerinden yayınlanır. Macro Deck, paketi kurmadan önce ve eklentiyi her başlattığında imzasını doğrular.

Macro Deck’te gördükleriniz

Geçerli bir imza, paketin bu süreçten geçtiğini gösterir. İmzasız eklentileri, örneğin kendi eklentilerinizi, yine de kurabilirsiniz ama fark görünür kalır.

  • İmzalıNormal şekilde kurulur. Dosyaları sonradan değiştirilirse eklenti artık yüklenmez.
  • İmzasızMacro Deck önce sizi uyarır. Yalnızca onayladıktan sonra kurar ve eklenti doğrulanmamış olarak işaretli kalır.
  • Geçersiz imzaReddedilir. Doğrulanmayan bir imza onaylanarak geçilemez.

Yayından sonra

Macro Deck, yayınlanmış eklentilerin depolarını denetlemeyi sürdürür. Deposu özel hale gelen veya ortadan kaybolan bir eklenti 14 günlük sürenin sonunda listeden kaldırılır; iptal edilen bir sertifika ise yeni kurulumları ve güncellemeleri engeller.

Bunun vaat edemeyeceği şeyler

İncelemeler ve imzalar riski azaltır ve bir paketin nereden geldiğini belirler. Bir eklentinin güvenlik açıklarından veya kötü amaçlı koddan arınmış olduğunu garanti edemez. Eklentiler korumalı alanda (sandbox) çalışmaz: kullanıcı hesabınızın yetkileriyle çalışırlar, bu yüzden bir eklenti kurmayı diğer herhangi bir program kurmak gibi ele alın.

Sahiplik

Bilgisayarınızda çalışır ve abonelik yoktur

Önce yerel, hesap gerekmez

Macro Deck kendi bilgisayarınızda çalışır ve cihazlarınız ona doğrudan bağlanır. Temel işlevleri Macro Deck bulut hizmetlerine bağlı değildir ve kullanmak için bir Macro Deck hesabına ihtiyacınız yoktur.

  • Sizin tarafınızdan, kendi makinenizde barındırılır
  • Kurulumunuz sizin kontrolünüzde kalır
  • Macro Deck hesabı gerekmez
  • Temel işlevler için bulut hizmeti gerekmez
  • Apache 2.0 lisanslı, açık kaynaklı ana bilgisayar uygulaması

Hesaplar isteğe bağlıdır ve Companion lisansını hesabınızda saklamak ya da Store öğelerini puanlamak gibi hizmetler ekler.

Spotify veya Twitch gibi çevrimiçi hizmetlerle entegrasyonlar, Store ve bir Companion satın alımının etkinleştirilmesi gibi internet bağlantısı gerektirmeye devam eder.

Maliyeti nedir

Macro Deck ana bilgisayar uygulamasıÜcretsizWindows, macOS ve Linux için ücretsiz ve açık kaynaklı.
Web istemcisiÜcretsizDeck’lerinizi ağınızdaki güncel bir tarayıcıdan, hiçbir şey kurmadan kullanmanın eksiksiz bir yolu.
Companion uygulamalarıTek seferlik satın almaAndroid ve iOS için kapalı kaynaklı yerel uygulamalar; her cihazda 7 günlük ücretsiz deneme sunar.

Tek bir lisans her iki platformu da kapsar. Uygulama içinden bir kez satın alırsınız, süresi dolmaz ve Macro Deck onu, bilgisayarınıza bağlanan diğer Android ve iOS cihazlarınıza aktarır.

Uygulamalar deck’leri yerel olarak çizer, bilgisayarlarınızı ağda bulur ve hareketler, dokunsal geri bildirim, hata ayıklama gerektirmeyen USB ve cihazın kendisine yönelik eylemler ekler. Deck’leriniz web istemcisinde de aynı görünür.

Cihazlar

Elinizdeki cihazları kullanın

Yedek bir telefon, eski bir tablet ya da bir tarayıcı penceresi kontrol yüzeyiniz olabilir; yani satın almanız gereken özel bir donanım yoktur. Her biri kendi profili ve düzeniyle birkaç cihazı aynı anda bağlayın.

Deck düzenleyicisiyle Macro Deck masaüstü uygulamasıBir telefonda Companion uygulamasının Bağlantılar ekranı; bir USB bağlantısı ve kayıtlı iki bilgisayar görünüyor
Macro Deck ana bilgisayar uygulamasıWindows, macOS ve Linux
  • Web istemcisiHerhangi bir güncel tarayıcı
  • AndroidCompanion uygulaması
  • iOSCompanion uygulaması
Ağ üzerinden
Cihazlar bilgisayarınıza doğrudan bağlanır. Companion uygulamaları onu sizin için bulur; web istemcisi bir adresten ya da QR kodundan açılır.
USB üzerinden
Android, Companion uygulaması veya web istemcisiyle ADB üzerinden bağlanır. Android ve iOS’taki Companion uygulamaları USB hata ayıklaması olmadan da bağlanabilir; bu hâlâ deneysel.
Yan yana
Sohbet için bir telefon, sahneler için bir tablet kullanın. Farklı cihazlar aynı anda farklı profilleri açabilir.

Geliştiriciler

Altyapıyı değil, entegrasyonu geliştirin

Eklenti SDK’sı size yerleşik entegrasyonların kullandığı sözleşmelerin aynısını verir. Siz C# yazarsınız; cihazları, ayarları, görüntülemeyi ve dağıtımı Macro Deck üstlenir.

Eklenti SDK’sı
Eylemler, değişkenler, olaylar, widget’lar, kurulum ekranları ve cihaz sağlayıcıları için belgelenmiş .NET paketleri.
CLI
macrodeck-plugin, Macro Deck kurulu olmadan bir eklenti oluşturur, çalıştırır, test eder, doğrular ve paketler.
Creator Portal
Deponuzu bağlayın, derlemeleri, test edenleri ve sürümleri yönetin ve Store’da yayınlayın.
Herkese açık API’ler
Projelerinizin durumunu ve analizlerini Public API üzerinden okuyun; panolar, rozetler ve CI için.

Bir şeyin nasıl çalıştığını öğrenmek istediğinizde de ana bilgisayar uygulaması açık kaynaklıdır.

~ % 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

Eklentiler kendi arayüzlerini getirebilir

Eklentiler yalnızca eylem ve değişken eklemekle sınırlı değildir. Macro Deck’in C# için kendi bildirimsel UI çatısı vardır: bir görünümü bileşenlerden oluşan bir ağaç olarak bir kez tanımlarsınız, Macro Deck de onu gerektiği her yerde (deck widget’ı, yapılandırma ekranı, klasör görünümü ya da kalıcı iletişim penceresi olarak) görüntüler.

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 widget’ı: yemek, mutluluk ve enerji için durum çubukları, uyuyan mavi piksel sanat evcil hayvan ve altında altı düğmeMacro Deck düzenleyicisindeki bir deck’te, eylem düğmelerinin yanında Macrogotchi widget’ı
Macrogotchi, tamamen bir eklenti tarafından çizilen bir widget.

Macrogotchi bunun ne kadar ileri gidebildiğini gösterir. Bu açık kaynaklı eklenti, deck’inizde sanal bir evcil hayvan tutar; durum çubukları, renkli hücrelerden çizilen bir piksel sanat sprite’ı ve altı düğme, hepsi tek bir widget içinde.

Görünümler gömülü web sayfalarından değil, yığınlar, ızgaralar, grafikler, göstergeler ve kaydırıcılar gibi Macro Deck UI bileşenlerinden oluşturulur; bu yüzden deck’inizin geri kalanıyla uyum sağlar.

Topluluk

2018'den beri topluluğuyla birlikte geliştiriliyor

Macro Deck, insanlar onu kullanmaya, nelerin yanlış olduğunu bildirmeye ve eksik olanı geliştirmeye devam ettiği için var. Store’daki birçok entegrasyon topluluk tarafından sürdürülür, ana bilgisayar uygulaması GitHub’da geliştirilir ve sırada ne olduğu herkese açık planlanır.

Elinizdeki bir cihazda deneyin

Macro Deck ve web istemcisi ücretsiz olarak indirilir ve kullanılır.

Elgato ve Stream Deck, ilgili sahiplerinin ticari markalarıdır. Macro Deck bağımsız bir projedir; Elgato ile bağlantılı değildir ve Elgato tarafından onaylanmamıştır.