دليل المستخدم

MACA هو تطبيق شريط القوائم. بعد التثبيت، تظهر أيقونة صغيرة في شريط قوائم macOS (الزاوية العلوية اليمنى من الشاشة). انقر عليها لفتح النافذة الرئيسية.

الإطلاق الأول

عند الإطلاق الأول، يرشدك معالج الإعداد عبر:

1. مرحباً — نظرة عامة على الأذونات التي يحتاجها MACA.
2. إذن الصوت — يستخدم MACA Core Audio Taps للتحكم في صوت كل تطبيق. يفتح زر إعدادات النظام لمنح الوصول عند الطلب.
3. الإشعارات — اختياري. يفعّل التنبيهات عند اكتشاف مشاكل صوتية أو إصلاحها تلقائياً.
4. إنهاء — ملخص اختياراتك. يمكنك العودة وتغيير أي خطوة.

التشغيل عند تسجيل الدخول

لبدء MACA تلقائياً عند تسجيل الدخول، فعّل "التشغيل عند تسجيل الدخول" في الإعدادات > عام.

يقع MACA في شريط القوائم. يمكنك الاختيار بين أربعة أنماط أيقونات في الإعدادات > عام:

أنماط الأيقونة

تفاصيل مقياس المستوى

يتم تحديث مقياس المستوى 10 مرات في الثانية ويعرض مستوى الصوت المجمع لجميع التطبيقات التي يتحكم فيها MACA.

• كشف القطع: — عندما يتجاوز الصوت 98% في أي قناة، يومض ذلك الشريط بالكامل باللون الأحمر لمدة 200 ملي ثانية.
• تحسين الطاقة: — يتوقف المقياس تلقائياً عندما تكون الشاشة في وضع السكون ويعيد التعيين بنظافة عند الاستيقاظ.

سلوكيات إضافية للأيقونة

• الرسوم المتحركة — عند التفعيل، تتحرك الأيقونة أثناء تشغيل أي تطبيق للصوت. لا ينطبق على نمط مقياس المستوى.
• الإخفاء التلقائي — عند التفعيل، تختفي أيقونة شريط القوائم بعد 5 دقائق من عدم نشاط الصوت. تظهر مجدداً فوراً عند بدء أي تطبيق بتشغيل الصوت.

انقر على أيقونة شريط القوائم لفتح النافذة الرئيسية. تحتوي على الأقسام التالية من الأعلى إلى الأسفل:

الصوت الرئيسي

شريط تمرير أفقي في الأعلى يتحكم في الصوت الرئيسي للنظام (0-100%). يمين ويسار الشريط:

• كتم الكل — يكتم جميع التطبيقات دفعة واحدة. اضغط مرة أخرى لإلغاء الكتم.
• وضع التركيز — يكتم جميع التطبيقات ما عدا تطبيقات الاتصال (انظر القسم 7).
• المعادل — يوازن تلقائياً مستويات الصوت بين التطبيقات.Pro

البحث والترتيب

• حقل البحث — اكتب لتصفية قائمة التطبيقات بالاسم. التطبيقات المستخدمة مؤخراً غير النشطة تظهر أيضاً مع زر "تشغيل".
• الترتيب — اختر بين أبجدي (A-Z) والنشاط الأخير.

منتقي ملف التعريف

قائمة منسدلة تتيح لك تفعيل أو تعطيل أو إدارة ملفات تعريف الصوت المحفوظة (انظر القسم 9).

قائمة التطبيقات

تعرض جميع التطبيقات التي تنتج صوتاً حالياً. كل تطبيق له صفه الخاص مع عناصر التحكم بالصوت.

• نقطة خضراء تشير إلى أن التطبيق يشغل صوتاً حالياً.
• شارة مكبر صوت مشطوب أحمر تشير إلى أن التطبيق مكتوم.

عمليات النظام

قسم قابل للطي بعنوان "خدمات النظام" يعرض عمليات صوت النظام مثل المكالمات الهاتفية والإشعارات ومشاركة الشاشة. مخفي افتراضياً — فعّله في الإعدادات > عام.

الأجهزة الثانوية

قسم قابل للطي يعرض عناصر التحكم بالصوت لجميع أجهزة الإخراج المتصلة بخلاف الجهاز الافتراضي (انظر القسم 10).

التذييل

• جهاز الإخراج الافتراضي — قائمة منسدلة لتغيير مخرج الصوت الافتراضي للنظام. الأجهزة مجمعة في محلي وبلوتوث وAirPlay.
• الإعدادات — (أيقونة الترس) — يفتح نافذة الإعدادات.
• إنهاء — (أيقونة الطاقة) — يعرض مربع حوار التأكيد ثم ينهي MACA. يتم تنظيف جميع مقابض الصوت والأجهزة الافتراضية عند الخروج.

كل تطبيق في القائمة يعرض:

كيف يعمل

يستخدم MACA تقنية Apple Core Audio Taps لاعتراض تدفق الصوت لكل تطبيق. يتم تطبيق الصوت في الوقت الفعلي باستخدام معالجة الإشارات الرقمية. تمر جميع قنوات الصوت دون تعديل — يتم ضبط الكسب فقط.

انقر على أيقونة مكبر الصوت/الجهاز في أي صف تطبيق لفتح منتقي جهاز الإخراج. يتيح لك إرسال صوت تطبيق فردي إلى جهاز إخراج مختلف عن الافتراضي.

منتقي الأجهزة

• استخدام الافتراضي — يوجه هذا التطبيق عبر المخرج الافتراضي. هذا هو السلوك الافتراضي.
• الأجهزة المتاحة — يسرد جميع أجهزة الإخراج المتصلة: مكبرات الصوت المدمجة، واجهات USB، مخارج HDMI، سماعات بلوتوث والمزيد.
• قسم البلوتوث — يعرض أجهزة صوت بلوتوث المقترنة بشكل منفصل.

انقر على زر EQ في أي صف تطبيق لفتح نافذة EQ منفصلة لذلك التطبيق.

عناصر التحكم في نافذة EQ

ملفات تعريف EQ مخصصةPro

أنشئ ملفات تعريف EQ مخصصة في الإعدادات > المعادل. تظهر الملفات المخصصة في أعلى منتقي الإعدادات المسبقة في كل نافذة EQ. يمكنك إعادة التسمية والتحرير والحذف من الإعدادات.

EQ في الإعدادات

الإعدادات > المعادل يعرض نظرة عامة على جميع ملفات تعريف EQ المخصصة وجميع التطبيقات ذات إعدادات EQ. من هناك يمكنك فتح نافذة EQ لأي تطبيق أو إعادة تعيين EQ أو إدارة ملفاتك المخصصة.

وضع التركيز يكتم جميع الأصوات ما عدا تطبيقات الاتصال. فعّله بـ:

• النقر على أيقونة الهاتف في منطقة التحكم الرئيسية.
• استخدام اختصار لوحة المفاتيح (الافتراضي: Option + Command + F).

عند التفعيل، تتحول أيقونة الهاتف للأخضر. اضغط مرة أخرى أو استخدم الاختصار لإلغاء التفعيل.

يقوم المعادل تلقائياً بموازنة مستويات الصوت عبر جميع التطبيقات بحيث لا يكون أي تطبيق أعلى أو أخفض بشكل ملحوظ من الآخرين.Pro

فعّله بالنقر على زر المعادل في منطقة التحكم الرئيسية. عندما يقوم المعادل بضبط المستويات بأكثر من 0.5 dB، يظهر مؤشر كسب صغير بجانب الزر:

• برتقالي اللون عند التعزيز (dB إيجابي)
• سماوي اللون عند التخفيض (dB سلبي)

تحفظ ملفات التعريف لقطة من تكوين الصوت الخاص بك — صوت كل تطبيق، حالة الكتم، تعيين جهاز الإخراج وإعدادات EQ — للتبديل بين الإعدادات بنقرة واحدة.

إنشاء ملف تعريف

1. افتح الإعدادات > ملفات التعريف.
2. انقر على زر "+".
3. أدخل اسماً واختر أيقونة من الشبكة (10 أيقونات متاحة).
4. اختيارياً فعّل "التقاط الحالة الحالية" لحفظ إعدادات جميع التطبيقات قيد التشغيل في ملف التعريف الجديد.

تفعيل ملف تعريف

• من القائمة المنسدلة لمنتقي ملفات التعريف في النافذة الرئيسية.
• من الإعدادات > ملفات التعريف بالتمرير فوق ملف تعريف والنقر على علامة الاختيار أو النقر المزدوج.
• عبر تطبيق الاختصارات: إجراء "تحميل ملف التعريف".

الحفظ التلقائي

كل ملف تعريف لديه مفتاح حفظ تلقائي. عند التفعيل، يتم حفظ أي تغييرات في الصوت أو الكتم أو الجهاز أو EQ تلقائياً في ملف التعريف.

تحرير ملف تعريف

في الإعدادات > ملفات التعريف، حدد ملف تعريف وانقر على زر التحرير. تعرض العرض التفصيلي:

• منتقي الأيقونات (قائمة منسدلة مع SF Symbols).
• حقل الاسم.
• قائمة بجميع التطبيقات في ملف التعريف مع: أيقونة، اسم، مفتاح كتم، شريط صوت، منتقي جهاز إخراج، منتقي إعداد EQ مسبق وزر إزالة.
• زر "إضافة تطبيق" لتضمين تطبيقات إضافية.

يعرض قسم الأجهزة الثانوية في أسفل النافذة الرئيسية عناصر التحكم بالصوت لجميع أجهزة الإخراج المتصلة بخلاف الجهاز الافتراضي الحالي.

كل صف جهاز يتضمن:

• أيقونة الجهاز (بناءً على نوع النقل: مدمج، USB، بلوتوث، HDMI، إلخ).
• اسم الجهاز.
• شريط الصوت.
• زر الكتم.
• زر المعلومات (يفتح نافذة منبثقة مع تفاصيل الجهاز).

يدعم MACA اختصارات لوحة مفاتيح عالمية تعمل من أي تطبيق. قم بتكوينها في الإعدادات > الاختصارات.

الاختصارات الافتراضية

تخصيص الاختصارات

انقر على حقل التسجيل بجانب أي اختصار لتعيين تركيبة مفاتيح جديدة. اضغط على الاختصار المطلوب ثم انقر في مكان آخر للتأكيد. استخدم زر "إعادة التعيين للافتراضي" لاستعادة جميع الاختصارات.

افتح تطبيق الاختصارات، أنشئ اختصاراً جديداً وابحث عن "MACA" للعثور على هذه الإجراءات:

افتح الإعدادات من أيقونة الترس في تذييل النافذة الرئيسية، أو بالنقر بزر الماوس الأيمن على أيقونة شريط القوائم.

عام

رؤية التطبيقات

تحكم في التطبيقات التي تظهر في النافذة الرئيسية.

• تبديل الرؤية للتطبيقات الفردية (أيقونة العين).
• البحث باسم التطبيق أو معرف الحزمة.
• التصفية لإظهار التطبيقات المخفية فقط.
• "إظهار جميع التطبيقات" يعيد جميع التطبيقات للظهور.
• "مسح السجل" يزيل سجل التطبيقات المرئية سابقاً.

رؤية الأجهزة

تحكم في أجهزة الإخراج التي تظهر في قسم الأجهزة الثانوية.

• تبديل الرؤية للأجهزة الفردية (أيقونة العين).
• البحث باسم الجهاز.
• كل جهاز يعرض نوع النقل والمعرف الفريد.
• "إظهار جميع الأجهزة" يعيد الكل للظهور.
• "مسح السجل" يزيل سجل الأجهزة المرئية سابقاً.

النظام

حول

• إصدار MACA ورقم البناء.
• شارة مستوى Pro أو Free.
• لمستخدمي Pro: رسالة شكر. لمستخدمي Free: زر "الترقية إلى Pro".
• روابط لموقع MACA، بريد الدعم، صفحة App Store وسجل الإصدارات.

يقوم MACA بتشغيل فحص صحة تلقائي كل 30 ثانية في الخلفية. يبحث عن:

• أجهزة مجمعة يتيمة — من أعطال سابقة أو إنهاءات غير طبيعية.
• مقابض صوت يتيمة — لم تعد متصلة بتطبيق قيد التشغيل.
• تطبيقات منافسة — قد تتداخل مع MACA.

عند العثور على مشكلة، يحاول MACA إصلاحها تلقائياً. يمكنك مراجعة الإصلاحات في الإعدادات > النظام > سجل الإصلاحات.

التنظيف عند الخروج

عند إنهاء MACA (أو إذا تم إنهاء العملية بواسطة SIGTERM أو SIGINT أو SIGQUIT)، يتم تدمير جميع مقابض الصوت والأجهزة المجمعة لترك نظامك في حالة نظيفة.

للترقية، انقر على زر "الترقية إلى Pro" في الإعدادات > حول، أو انقر على أيقونة القفل على أي ميزة مقيدة بـ Pro. يتم التعامل مع الشراء عبر App Store ويمكن استعادته على أي جهاز مسجل بنفس Apple ID.

لخطوات حل المشكلات المفصلة، قم بزيارة صفحتنا المخصصة:

يوفر MACA واجهة REST API محلية تتيح لك التحكم في جميع تطبيقات الصوت برمجيًا. مثالي لسير العمل الآلي وتكاملات Stream Deck وإعدادات المنزل الذكي والبرامج النصية المخصصة.

curl http://127.0.0.1:59622/v1/status

{
  "app": "MACA",
  "version": "1.1.12",
  "build": "084",
  "apiVersion": "1",
  "features": {
    "perAppVolume": true,
    "perAppMute": true,
    "perAppRouting": true,
    "focusMode": true,
    "volumePreview": true,
    "masterVolume": true,
    "masterMute": true
  }
}

curl http://127.0.0.1:59622/v1/apps

curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_GENERAL_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Status
curl -s http://127.0.0.1:59622/v1/status | python3 -m json.tool

# List apps
curl -s http://127.0.0.1:59622/v1/apps | python3 -m json.tool

# Get single app
curl -s http://127.0.0.1:59622/v1/apps/com.spotify.client | python3 -m json.tool

# List output devices
curl -s http://127.0.0.1:59622/v1/output-devices | python3 -m json.tool

# Set volume (needs token)
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/volume \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"volume": 0.5}'

# Mute an app
curl -X PUT http://127.0.0.1:59622/v1/apps/com.spotify.client/mute \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"muted": true}'

# Change default output device
curl -X PUT http://127.0.0.1:59622/v1/default-output-device \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"deviceUID": "BuiltInSpeakerDevice"}'

# Toggle focus mode
curl -X PUT http://127.0.0.1:59622/v1/focus-mode \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"active": true}'