Jellyfin
مضمّن في Macro Deckتحكّم في تطبيقات Jellyfin وأجهزة التلفاز من لوحتك، واعرض ما يُشغَّل، واستجب عند بدء التشغيل أو توقفه.
أداتا مشغّل الموسيقى تشغّلان مقطعًا، إحداهما بنمط غلاف كامل والأخرى بنمط غلاف صغير، وفي رأس كلتيهما اسم Jellyfin وشعاره
- التحكم في التشغيل ومستوى الصوت في تطبيقات Jellyfin والمتصفحات وأجهزة التلفاز
- البحث عن فيلم أو حلقة أو أغنية أو ألبوم وتشغيله
- مشغّلات عند بدء التشغيل أو إيقافه مؤقتًا أو استئنافه أو توقفه
- أداتا مشغّل الموسيقى وجلسات Jellyfin
- ربط عدة خوادم، لكل منها متغيراته الخاصة
يربط تكامل Jellyfin بين Macro Deck وخادم وسائط Jellyfin واحد أو أكثر، ويعمل مع الجلسات عليها: تطبيقات Jellyfin والمتصفحات وأجهزة التلفاز المسجّل دخولها والتي تُشغّل محتوى. لا يحتاج إلى إضافة Jellyfin. تسجّل الدخول بمفتاح API، فيتمكن Macro Deck من رؤية كل جلسة على الخادم والتحكم فيها، أو باسم مستخدم وكلمة مرور، فيقتصر على الجلسات التي يحق لهذا الحساب التحكم فيها.
ما يمكنك فعله
- التشغيل والإيقاف المؤقت والإيقاف والتخطي والانتقال إلى موضع، أو التقديم والترجيع بعدد من الثواني.
- ضبط مستوى الصوت، وكتم الصوت وإلغاء كتمه، وضبط الترتيب العشوائي والتكرار على عميل.
- البحث في الخادم عن فيلم أو حلقة أو أغنية أو ألبوم وتشغيله على جهاز باستخدام تشغيل الوسائط.
- عرض رسالة مع عنوان رئيسي على عميل Jellyfin.
- عرض ما يُشغَّل في أداة مشغّل الموسيقى، أو التشغيل على خوادمك في أداة جلسات Jellyfin.
- بدء أتمتة عند بدء التشغيل أو إيقافه مؤقتًا أو استئنافه أو توقفه، أو عند تغيّر العنصر، أو عند اتصال عميل.
بعض الأمثلة على الإعدادات:
- زر Toggle Play/Pause لتلفاز غرفة المعيشة، وبجانبه الترجيع للخلف لإعادة آخر 10 ثوانٍ.
- أتمتة على بدء التشغيل لتلفازك تخفّض الإضاءة عندما تكون قيمة
{{ event.itemType }}هيMovie، وأخرى على توقف التشغيل تعيد رفعها. - زر يعرض "العشاء جاهز" على التلفاز باستخدام عرض رسالة.
الخوادم والأجهزة
يظهر كل خادم تضيفه بشكلين أينما تختار مشغّلًا. يتبع اسم الخادم وحده الجلسة التي شغّلت شيئًا مؤخرًا. أما الخادم · الجهاز، مثل Home · Living Room TV، فيستهدف دائمًا ذلك الجهاز ويظهر غير متصل ما دام الجهاز مطفأً. يتذكر Macro Deck الأجهزة لمدة 30 يومًا بعد آخر مرة رآها فيها.
يتابع Macro Deck الخادم مباشرة عبر WebSocket الخاص به على Jellyfin 10.11 والأحدث. وعندما لا يرسل الخادم تحديثات مباشرة، يطلب الجلسات كل ثانيتين بدلًا من ذلك. عندما يختفي خادم، يواصل Macro Deck المحاولة في الخلفية ويُبلغ عنه في صفحة Jellyfin ضمن التكاملات بعد بضع محاولات فاشلة. لا يدعم كل عميل Jellyfin كل الأوامر: يفشل الأمر الذي لا يستطيع العميل تنفيذه برسالة.
ما تحتاج إليه
- خادم Jellyfin يمكن للحاسوب الذي يعمل عليه Macro Deck الوصول إليه عبر الشبكة.
- مفتاح API من لوحة تحكم Jellyfin (موصى به)، أو اسم مستخدم وكلمة مرور في Jellyfin.
- Jellyfin 10.11 أو أحدث للتحديثات المباشرة. بدونها، يطلب Macro Deck الجلسات كل ثانيتين.
خطوات الإعداد
الخطوة 1: أنشئ مفتاح API في Jellyfin
افتح لوحة تحكم Jellyfin وانتقل إلى API Keys. أنشئ مفتاحًا جديدًا وانسخه. إذا كنت تفضّل تسجيل الدخول بحساب مستخدم، فتخطَّ هذه الخطوة.
الخطوة 2: أضف تهيئة في Macro Deck
في Macro Deck، انقر التكاملات في الشريط الجانبي ثم انقر Jellyfin. في علامة التبويب نظرة عامة، انقر إضافة تهيئة في قسم الإعدادات. يفتح تشغيل المفتاح في أعلى اليسار النافذة نفسها، ويُفعَّل التكامل بعد اكتمال الإعداد.
الخطوة 3: أدخل بيانات الخادم
في نافذة الاتصال بـ Jellyfin، املأ ما يلي:
- اسم التهيئة: اسم لهذا الخادم، مثل
Home. يُستخدم في أسماء المشغّلات والمتغيرات. - عنوان الخادم: العنوان مع منفذه وأي مسار أساسي، مثل
http://192.168.1.10:8096. - تسجيل الدخول باستخدام: مفتاح API أو اسم المستخدم وكلمة المرور، ثم أدخل مفتاح API، أو اسم المستخدم وكلمة المرور.
انقر متابعة. يتحقق Macro Deck من الاتصال قبل الحفظ.
- اسم التهيئة: اسم لهذا الخادم، مثل
الخطوة 4: تحقق من الاتصال
تعرض التهيئة الجديدة متصل في قسم الإعدادات في صفحة Jellyfin. كرّر الخطوات لكل خادم إضافي.
الخطوة 5: أضف إجراءً إلى زر
في صفحة اللوحة، انقر الزر الذي تريد استخدامه. يجب أن تكون اللوحة غير مقفلة: عندما يعرض الزر في أعلى اليسار قفل، فهي غير مقفلة. يُفتح المحرر مع تحديد ضغطة قصيرة. انقر + إضافة إجراء، واختر Jellyfin على يمين نافذة إضافة إجراء، ثم اختر إجراءً مثل Toggle Play/Pause. حدّد الخادم أو الجهاز الذي يتحكم فيه، ثم انقر حفظ.
الخطوة 6: اضغط الزر
ابدأ تشغيل شيء على عميل Jellyfin واضغط الزر على لوحتك. يتوقف التشغيل مؤقتًا أو يُستأنف على ذلك العميل.
الإجراءات20
ضعها على زر أو شغّلها من تدفق.
- Play
- يستأنف التشغيل على العميل.
- Pause
- يوقف التشغيل مؤقتًا على العميل.
- Toggle Play/Pause
- يبدّل بين التشغيل والإيقاف المؤقت، ويعرض حالة التشغيل على الزر.
- إيقاف
- يوقف التشغيل على العميل.
- Next Track
- ينتقل إلى العنصر التالي.
- Previous Track
- ينتقل إلى العنصر السابق.
- Refresh State
- يقرأ حالة التشغيل الحالية فورًا.
- Seek
- ينتقل إلى موضع في العنصر الحالي، بالثواني.
- التقديم للأمام
- يتقدم في العنصر الحالي، 30 ثانية افتراضيًا.
- الترجيع للخلف
- يرجع في العنصر الحالي، 10 ثوانٍ افتراضيًا.
- Set Volume
- يضبط مستوى صوت العميل، من 0 إلى 100%.
- Volume Up
- يرفع مستوى الصوت بنسبة 10%.
- Volume Down
- يخفض مستوى الصوت بنسبة 10%.
- كتم الصوت
- يكتم صوت العميل.
- إلغاء كتم الصوت
- يعيد تشغيل صوت العميل.
- تبديل كتم الصوت
- يكتم صوت العميل أو يلغي كتمه.
- Toggle Shuffle
- يشغّل الترتيب العشوائي أو يوقفه أو يبدّل حالته.
- Set Repeat Mode
- يضبط التكرار على Off أو Repeat Track أو Repeat Album/Playlist.
- عرض رسالة
- يعرض رسالة مع عنوان رئيسي على العميل لعدد من الثواني.
- تشغيل الوسائط
- يبحث عن فيلم أو حلقة أو أغنية أو ألبوم ويشغّله على العميل، بدلًا مما يُشغَّل عليه.
المشغّلات9
يمكن لزر أو تدفق أن يستجيب لهذه الأحداث.
- بدء التشغيل
- بدأت جلسة تشغيل شيء ما.
- إيقاف التشغيل مؤقتاً
- أُوقف التشغيل مؤقتًا في جلسة.
- استئناف التشغيل
- استمر التشغيل المتوقف مؤقتًا في جلسة.
- توقف التشغيل
- توقفت جلسة عن التشغيل.
- تغيّر العنصر قيد التشغيل
- انتقلت جلسة إلى فيلم أو حلقة أو مقطع آخر.
- اتصلت الجلسة
- فتح عميل Jellyfin جلسة على الخادم.
- انقطعت الجلسة
- أغلق الخادم جلسة عميل.
- متصل
- اتصل Macro Deck بالخادم.
- غير متصل
- فقد Macro Deck الاتصال بالخادم.
المتغيرات7
اعرض هذه القيم على الأزرار والأدوات، أو استخدمها في الشروط.
jellyfin_active_sessions- الجلسات قيد التشغيل أو المتوقفة مؤقتًا على كل الخوادم معًا.
jellyfin_<server>_is_connected,jellyfin_<server>_active_sessions- ما إذا كان Macro Deck يصل إلى كل خادم، وعدد الجلسات التي تُشغّل عليه.
jellyfin_<server>_<device>_is_playing,jellyfin_<server>_<device>_is_paused,jellyfin_<server>_<device>_is_active- ما إذا كان شيء ما يُشغَّل على الجهاز أو متوقفًا مؤقتًا أو محمّلًا. الكتابة في متغير التشغيل أو الإيقاف المؤقت تشغّل أو توقف مؤقتًا.
jellyfin_<server>_<device>_title,jellyfin_<server>_<device>_series,jellyfin_<server>_<device>_album,jellyfin_<server>_<device>_media_type- العنوان والمسلسل والألبوم (أو الموسم) ونوع الوسائط للعنصر على كل جهاز.
jellyfin_<server>_<device>_position,jellyfin_<server>_<device>_duration,jellyfin_<server>_<device>_progress_percent- الموضع والمدة بالثواني، والتقدم بالنسبة المئوية. الكتابة في الموضع أو التقدم تنتقل إلى تلك النقطة.
jellyfin_<server>_<device>_user,jellyfin_<server>_<device>_client,jellyfin_<server>_<device>_device,jellyfin_<server>_<device>_is_transcoding- المستخدم والعميل والجهاز لكل جلسة، وما إذا كان الخادم يحوّل الوسائط.
jellyfin_<server>_<device>_volume,jellyfin_<server>_<device>_is_muted- مستوى الصوت وحالة الكتم لكل جهاز، حيث يُبلغ عنهما. الكتابة فيهما تضبط مستوى الصوت أو تكتمه.
الأدوات2
أضفها إلى لوحتك من منتقي الأدوات.
- مشغّل الموسيقى
- تعرض ما يُشغَّل على خادم أو جهاز، مع الصورة والتقدم وأزرار التشغيل والإيقاف المؤقت والتخطي. تتكيف الأسطر مع الأغاني والحلقات والأفلام.
- جلسات Jellyfin
- تعرض ما يُشغَّل على خادم واحد أو على كل خوادمك، مع الغلاف أو الملصق، ومن يشغّله، وعلى أي جهاز، وإلى أين وصل.
الأسئلة الشائعة
هل أستخدم مفتاح API أم اسم مستخدم وكلمة مرور؟
يُوصى بمفتاح API: إذ يرى Macro Deck حينها كل جلسة على الخادم ويتحكم فيها. مع اسم المستخدم وكلمة المرور، لا يرى إلا الجلسات التي يحق لهذا الحساب التحكم فيها. تُستخدم كلمة المرور مرة واحدة لتسجيل الدخول ولا تُخزَّن؛ ولا يحتفظ Macro Deck إلا برمز الوصول الذي يصدره Jellyfin.
هل يمكنني ربط أكثر من خادم؟
نعم. أضف تهيئة واحدة لكل خادم. لكل تهيئة متغيراتها الخاصة، مسمّاة باسمها، وتعرض ما إذا كانت متصلة.
لماذا يفشل أمر على تلفازي أو في المتصفح؟
لا يدعم كل عميل Jellyfin كل الأوامر. لا يرسل Macro Deck إلا ما يُبلغ العميل أنه قادر عليه، لذا يفشل الأمر الذي لا يستطيع تنفيذه برسالة. عادةً لا يعمل مستوى الصوت والكتم إلا في تطبيقات Jellyfin، وليس في علامة تبويب متصفح.
ماذا يحدث عندما يكون الخادم غير متصل؟
يواصل Macro Deck المحاولة في الخلفية ويعرض المشكلة خادم Jellyfin غير قابل للوصول في صفحة Jellyfin ضمن التكاملات بعد بضع محاولات فاشلة. تفشل إجراءات ذلك الخادم برسالة حتى يعود.
هل أستخدم مشغّلات Jellyfin أم مشغّلات مشغّل الموسيقى؟
مشغّلات مشغّل الموسيقى، مثل بدأ التشغيل تحت مشغّل الموسيقى، تنطلق أيضًا لـ Jellyfin، مرة للخادم ومرة للجهاز. للأتمتة، مشغّلات Jellyfin هي الخيار الأفضل: إذ تنطلق مرة واحدة لكل جهاز وتحمل المستخدم ونوع الوسائط.
المزيد في الموسيقى والصوت
Spotify
مضمّن في Macro Deckتحكّم في تشغيل Spotify، وأضف الأغاني إلى المفضلة، وأدر قوائم التشغيل، واعرض ما يُشغَّل على لوحتك.
YouTube Music Desktop App
مضمّن في Macro Deckتحكّم في YouTube Music Desktop App من لوحتك: التشغيل ومستوى الصوت والتقييمات وما يُشغَّل الآن.
WebNowPlaying
مضمّن في Macro Deckتحكّم في الموسيقى ومقاطع الفيديو التي تُشغَّل في متصفحك واعرض ما يُشغَّل، عبر إضافة WebNowPlaying.
SoundPad
مضمّن في Macro Deckشغّل الأصوات من قائمة SoundPad، وتحكّم في التسجيلات، واعرض الصوت الذي يُشغَّل على لوحتك.
Voicemeeter
مضمّن في Macro Deckتحكّم في الكسب والكتم والتوجيه وأزرار الماكرو في Voicemeeter أو Banana أو Potato من لوحتك.