عن المشروع

SpotMenu يجلب عناصر تحكم تشغيل Spotify وApple Music مباشرة إلى شريط قوائم macOS. مبني بـ Swift وSwiftUI، يوفر تجربة مستخدم بسيطة وأصلية لإدارة تشغيل الموسيقى دون مقاطعة سير عملك. الميزات الرئيسية - **تكامل شريط القوائم**: يعرض عنوان الفنان والأغنية الحالية مباشرة في شريط القوائم. - **عناصر تحكم التشغيل**: يوفر overlay عند التمرير تشغيل، إيقاف، تخطي، وإعجاب بالمسار بجانب غلاف الألبوم. - **اختصارات لوحة المفاتيح**: متوفرة اختصارات عامة للتحكم في التشغيل من أي مكان في النظام. - **إعجاب بالمسار**: تحديدًا لـ Spotify، يمكن للمستخدمين الإعغاء أو إلغاء الإعغاء بالمسارات باستخدام Spotify Web API. - **عرض مضغوط**: التبديل بين وضع العرض الكامل والمضغوط لتوفير مساحة في شريط القوائم. - **تحديثات حية**: يتزامن التطبيق تلقائيًا مع تغييرات تشغيل الوسائط النشطة. - **دعم متعدد المشغلات**: يكتشف تلقائيًا المشغل النشط أو يسمح بالاختيار اليدوي بين Spotify وApple Music. التثبيت يمكن للمستخدمين تثبيت SpotMenu عبر عدة طرق: - **التنزيل المباشر**: احصل على أحدث ملف .app.zip الموقع والمُوثق من صفحة الإصدارات على GitHub، والذي يتضمن تحديثات تلقائية عبر Sparkle. - **Homebrew**: ثبت بسهولة باستخدام الأمر `brew install --cask spotmenu`. - **البناء من المصدر**: يتطلب macOS 13+ (Ventura) وXcode 15+. استنسخ المستودع وافتح `SpotMenu.xcodeproj`. إعداد مطور Spotify لتفعيل إعجاب المسار، يجب على المستخدمين إنشاء تطبيق على لوحة تحكم مطوري Spotify، وتكوين URI إعادة التوجيه إلى `com.github.kmikiy.spotmenu://callback»، وإدخال معرّف العميل المولد في تفضيلات SpotMenu. التخصيص والتفضيلات يوفر التطبيق خيارات تخصيص واسعة ضمن قائمة التفضيلات: - **اختيار مشغل الموسيقى**: اختر بين الكشف التلقائي، Spotify، أو Apple Music. - **تحكمات المظهر**: ضبط ألوانTint عند التمرير، ألوان المقدمة، شدة التمويه، والشفافية للطبقة التشغيل. - **مرئيات شريط القوائم**: تبديل رؤية أسماء الفنانين، عناوين الأغاني، الأيقونات، وضبط الحد الأقصى للعرض (40–300 نقطة). - **تعيين الاختصارات**: ضبط اختصارات عامة لتشغيل/إيقاف، المسار التالي/السابق، وإعجاب/إلغاء الإعجاب. دليل الاستخدام - **النقر izquierdo**: إظهار أو إخفاء لوحة التشغيل. - **النقر الأيمن**: فتح القائمة السياقية. - **التمرير على اللوحة**: كشف عناصر التحكم التفصيلية للتشغيل. SpotMenu يُصدر تحت رخصة MIT.