مجاني منذ 2018، ومفتوح المصدر منذ 2021

لماذا Macro Deck؟

Macro Deck أكثر من مجرد بديل لـ Stream Deck. إنه منصة أتمتة مرنة ومفتوحة المصدر، لها تاريخ طويل ومجتمع نشط ومنظومة يمكن لأي شخص توسيعها.

حوّل الهواتف والأجهزة اللوحية والمتصفحات التي تملكها بالفعل إلى لوحة تحكم قابلة للتخصيص لحاسوبك، وقرّر ما يحدث خلف كل زر.

لوحة على جهاز لوحي: مشغّل موسيقى وساعة وتوقعات الطقس ومنزلق للصوت ورسم بياني لاستخدام CPU وأزرار إجراءات ملوّنةاللوحة نفسها على هاتف مُمسَك بالوضع الأفقي

تأسس عام 2018

من أوائل بدائل Stream Deck المجانية

جعل Stream Deck من Elgato أزرار الماكرو المخصصة مشهدًا مألوفًا على مكاتب البثّاثين. وفي نوفمبر 2018 ظهر Macro Deck على OBS Forum بفكرة مختلفة: لوحة ماكرو مجانية وبلا إعلانات تعمل على جهاز Android الذي تملكه بالفعل.

ومن هناك نما إصدارًا بعد إصدار، وصاغه مستخدموه، من مجلدات اختصارات إلى منصة أتمتة تعمل على عدة أنظمة تشغيل.

اقرأ المنشور الأصلي على OBS Forum
  1. نوفمبر 2018

    الإصدار الأول

    اختصارات لوحة المفاتيح والوسائط ومشغّلات التطبيقات والمجلدات على جهاز Android، متصلة بحاسوب عبر Wi-Fi.

    نافذة Macro Deck Server 1.1.6 Beta: شبكة من أزرار الماكرو، وقائمة إجراءات على اليسار، وحالة الاتصال والمجلدات على اليمين
  2. Macro Deck 2

    منفتح على الإضافات

    تطبيق Windows مع إضافات، جلب تكاملات مثل OBS Studio وDiscord. نُشرت شيفرته المصدرية بموجب ترخيص Apache 2.0 في نوفمبر 2021.

    نافذة Macro Deck 2 مع شريط جانبي ومجلدات وشبكة أزرار تعرض ساعة وبطارية سماعة الرأس وميكروفونًا مكتومًا
  3. Macro Deck 3

    منصة

    مضيف لأنظمة Windows وmacOS وLinux، وعميل ويب، وتطبيقات Companion الأصلية، وSDK للإضافات، ومتجر تجري مراجعته.

    محرر Deck في Macro Deck 3 مع مشغل موسيقى وساعة وطقس وشريط تمرير لمستوى الصوت ورسم بياني للمعالج وأزرار إجراءات ملونة

الأتمتة

منطق حقيقي، لا مجرد اختصارات

يستطيع الزر أن يفعل أكثر من إرسال اختصار لوحة مفاتيح. تعمل الإجراءات كتدفقات فيها شروط وحلقات وانتظار، وتتفاعل مع القيم الحية، وتشغّلها الأتمتة دون أن يضغط أحد على شيء.

Go live

  1. ضغطضغطة قصيرة على الزر

  2. Ifقيمة stream_live هي true

    • اضغط اختصار الإيقاف
    • اضبط stream_live على false
    • حوّل لون الزر إلى الأحمر
  3. Else ifحمل CPU فوق 85 وSpotify قيد التشغيل

    • أرسل إشعارًا بدلًا من بدء البث
  4. Otherwiseلا شيء يعترض الطريق

    • اخفض مستوى صوت Spotify
    • التكرار 3 مرات: ضبط الإطار على وميض، ثم الانتظار ثانية واحدة
    • اضغط اختصار البدء
    • اضبط stream_live على true
    • حوّل لون الزر إلى الأخضر
ضغطة واحدة، ثلاث نتائج. هذا هو التدفق الحقيقي خلف الزر، كما يظهر في المحرر.
تدفق Go live في محرر Macro Deck: كتلة If / Else مع Else if تجمع شرطين، وفرع Otherwise يضم حلقة تكرار وانتظارًا واختصارات ومتغيرات وتغييرات ألوان
الشروط والحلقات
If وElse if وElse مع شروط مركّبة، إضافة إلى التكرار والانتظار.
المتغيرات
قيم حية من حاسوبك والتكاملات، تُعرض على الأزرار وتُستخدم في الشروط.
الأحداث
شغّل أتمتة وفق جدول زمني، أو عند اتصال جهاز، أو تغيّر متغير، أو بدء OBS للبث.
حالات الزر
امنح الزر عدة حالات لكل منها مظهره الخاص، أو اجعله يتبع متغيرًا مثل حالة كتم الصوت في Discord.
حواسيب أخرى
مع Macro Deck Delegate يشغّل الزر سكربتًا على حاسوب آخر ويستورد المتغيرات التي يشاركها.
ودجات حية
منزلقات ومقاييس ورسوم بيانية ومشغّلات موسيقى وودجات دردشة تعرض ما يحدث وتستجيب للمس.

مفيد إلى ما هو أبعد من البث

الإنتاجية
اطّلع على اجتماعك القادم وبريدك غير المقروء بنظرة واحدة، وبدّل إلى ملف العمل في وقت محدد.
إدارة الأنظمة
راقب CPU وRAM على المقاييس، ونفّذ الأوامر واحتفظ بمخرجاتها في متغير، أو أوقف AdGuard Home مؤقتًا.
أتمتة المنزل
شغّل الأضواء ونفّذ المشاهد واعرض حالات Home Assistant الحية على أزرار تعكس الحالة الفعلية.
سير عمل مخصص
استدعِ أي واجهة Web API عبر تكامل HTTP، أو شغّل سكربتات AutoHotkey على Windows.

متجر الإضافات

إضافات مجتمعية ذات مصدر يمكن تتبّعه

يقدّم المتجر داخل Macro Deck إضافات يتولى المجتمع صيانتها. ما يميّزه هو الطريقة التي تصل بها الإضافة إليه: كل إضافة تُبنى من شيفرة مصدرية عامة، ويراجعها شخص، وتُوقَّع قبل أن تتمكن من تثبيتها.

  1. مستودع عام

    الشيفرة المصدرية عامة على GitHub بترخيص مفتوح المصدر. وتأتي الاعتمادات من حزم NuGet العامة؛ ولا يُسمح بتضمين مكتبات خارجية مُجمَّعة مسبقًا.

  2. نشر موثوق

    يشغّل الإصدار الموسوم سير عمل الإصدار الخاص بـ Macro Deck. ويتحقق GitHub من المستودع والالتزام وسير العمل، فلا يمكن رفع ملف ثنائي بُني في مكان آخر، ولا يحتفظ المبدعون برمز نشر أو مفتاح توقيع.

  3. مراجعة بالذكاء الاصطناعي وبشرية

    يمر كل إرسال أول وكل تحديث بفحوصات آلية وتحليل بمساعدة الذكاء الاصطناعي، ثم إلى مشرف بشري يتخذ القرار. تنظر المراجعات في إرشادات المتجر والسلوك الضار المحتمل والمشكلات الأمنية والاعتمادات.

  4. توقيع تشفيري

    بعد الموافقة يوقّع Creator Portal الحزمة. وترتبط شهادته بمفتاح جذري لـ Macro Deck يُحفظ دون اتصال بالإنترنت.

  5. المتجر الرسمي

    تُنشر الحزمة عبر سجل موقَّع. ويتحقق Macro Deck من توقيعها قبل تثبيتها، ومرة أخرى في كل مرة يشغّل فيها الإضافة.

ما تراه في Macro Deck

يدل التوقيع الصالح على أن الحزمة مرّت بهذه العملية. ويمكنك مع ذلك تثبيت إضافات غير موقَّعة، مثل إضافاتك الخاصة، لكن الفرق يبقى ظاهرًا.

  • موقَّعةتُثبَّت بشكل طبيعي. وإذا تغيّرت ملفاتها بعد ذلك، لا تعود الإضافة تُحمَّل.
  • غير موقَّعةينبّهك Macro Deck أولًا. ولا تُثبَّت إلا بعد تأكيدك، وتبقى الإضافة موسومة بأنها غير موثَّقة.
  • توقيع غير صالحتُرفض. لا يمكن تجاوز توقيع فشل التحقق منه بتأكيد يدوي.

بعد النشر

يواصل Macro Deck فحص مستودعات الإضافات المنشورة. فالإضافة التي يصبح مستودعها خاصًا أو يختفي تُزال من القائمة بعد مهلة 14 يومًا، وتمنع الشهادة الملغاة التثبيتات الجديدة والتحديثات.

ما لا يمكن أن يعد به هذا النظام

تقلّل المراجعات والتوقيعات المخاطر وتحدد مصدر الحزمة، لكنها لا تضمن خلو الإضافة من الثغرات أو الشيفرة الضارة. والإضافات غير معزولة في بيئة معزولة (sandbox): فهي تعمل بصلاحيات حساب المستخدم الخاص بك، لذا تعامل مع تثبيت إضافة كما تتعامل مع تثبيت أي برنامج آخر.

الملكية

يعمل على حاسوبك، وبلا اشتراك

محلي أولًا، دون حاجة إلى حساب

يعمل Macro Deck على حاسوبك الخاص، وتتصل به أجهزتك مباشرةً. لا تعتمد وظائفه الأساسية على خدمات Macro Deck السحابية، ولا تحتاج إلى حساب Macro Deck لاستخدامه.

  • يستضيفه حاسوبك أنت
  • إعدادك يبقى تحت سيطرتك
  • لا حاجة إلى حساب Macro Deck
  • لا حاجة إلى خدمة سحابية للوظائف الأساسية
  • مضيف مفتوح المصدر بترخيص Apache 2.0

الحسابات اختيارية وتضيف خدمات مثل حفظ ترخيص Companion مع حسابك أو تقييم عناصر المتجر.

تظل التكاملات مع الخدمات عبر الإنترنت مثل Spotify أو Twitch بحاجة إلى اتصال بالإنترنت، وكذلك المتجر وتفعيل شراء 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
اربط مستودعك، وأدر الإصدارات المبنية والمختبرين والإصدارات، وانشر في المتجر.
واجهات 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 إطار واجهات تصريحي خاص بلغة 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 لأن الناس يواصلون استخدامه والإبلاغ عن الأخطاء وبناء ما ينقصه. كثير من التكاملات في المتجر يصونها المجتمع، ويُطوَّر المضيف على GitHub، وما سيأتي لاحقًا يُخطَّط له علنًا.

جرّبه على جهاز تملكه بالفعل

تنزيل Macro Deck وعميل الويب الخاص به واستخدامهما مجاني.

Elgato وStream Deck علامتان تجاريتان لأصحابهما. Macro Deck مشروع مستقل وليس تابعًا لـ Elgato ولا معتمدًا منها.