تخطَّ إلى المحتوى

التنبيهات

الإعداد

يرسل التنبيه رسالة على Discord أو بالبريد الإلكتروني حين يحدث شيء: طلب ينتظر، فيلم يصل، فحص سلامة يفشل. تحتاج إلى الإذن Change settings (تغيير الإعدادات).

  1. افتح Settings > Alerts (الإعدادات > التنبيهات) واختر Add an Alert (إضافة تنبيه).
  2. أعطه اسمًا في Name (الاسم) واختر نوعه في Kind (النوع): Discord أو البريد الإلكتروني.
  3. املأ حقول النوع (انظر الأنواع).
  4. تحت When to send (متى يُرسَل)، أزل العلامة عن اللحظات التي لا تريدها. كلها معلَّمة في البداية؛ ويعمل All of these (كل هذه) و None of these (لا شيء من هذه) على مجموعة كاملة.
  5. اترك Send messages (إرسال الرسائل) مفعّلًا واختر Save (حفظ).
  6. اختر Send a test (إرسال رسالة اختبار) على البطاقة. سترى الرسالة تصل والبطاقة تعرض Last sent (آخر إرسال).

في Discord، افتح إعدادات القناة، ثم Integrations > Webhooks، وانسخ الرابط. الصقه في Discord link (رابط Discord)؛ وهو يبدأ بـ https://discord.com/. من أضافوا معرّف المستخدم على Discord إلى حسابهم يُذكرون في الرسائل التي تخص طلباتهم.

البريد الإلكتروني

رابط إلى البريد الإلكتروني
الحقل ما تكتبه
Mail server (خادم البريد)، Port (المنفذ) خادم بريدك
Security (الأمان) STARTTLS (المنفذ 587)، أو TLS (المنفذ 465)، أو None. اختر None مع خادم بريد على شبكتك أنت لا غير
From address (عنوان المرسل) عنوان المرسل
Mail username (اسم مستخدم البريد)، Mail password (كلمة مرور البريد) حساب البريد
Staff addresses (عناوين فريق الإدارة) عنوان واحد أو أكثر، مفصولة بفواصل

الرسائل التي تخص طلبًا تذهب إلى من طلبوه، على عنوان حسابهم. وكل ما عداها يذهب إلى عناوين فريق الإدارة.

Telegram و ntfy و Gotify و Pushover و webhooks مؤجَّلة في هذا الإصدار من التطبيق. انظر الميزات المؤجَّلة.

اللحظة يذهب إلى متى
New request (طلب جديد) فريق الإدارة فيلم أو مسلسل أو فنان بانتظار الموافقة
Approved (تمت الموافقة) أصحاب الطلبات تمت الموافقة على طلبهم
Declined (مرفوض) أصحاب الطلبات رُفض الطلب، مع ملاحظتك
Ready (جاهز) أصحاب الطلبات الملفات في المكتبة
New episodes (حلقات جديدة) أصحاب الطلبات والمتابعون تنبيه واحد على الأكثر لكل مسلسل في الساعة. يستطيع كل شخص إيقافها
New albums (ألبومات جديدة) متابعو الفنان تنبيه واحد على الأكثر لكل فنان في الساعة
Problem reported (بلاغ عن مشكلة) فريق الإدارة أحدهم أبلغ عن عمل. البلاغات في /requests/reports
Problem fixed (حُلّت المشكلة) صاحب البلاغ مع ردّك
Sent to download (أُرسل للتنزيل) فريق الإدارة ذهب إصدار إلى برنامج تنزيل
In the Library (في المكتبة) فريق الإدارة وُضعت الملفات في مكانها، ويشمل ذلك نسخة أفضل
Renamed (أُعيدت التسمية) فريق الإدارة حصلت الملفات على أسماء جديدة
Added (أُضيف) فريق الإدارة أُضيف عمل يدويًا، أو من قائمة، أو من طلب
Deleted (حُذف) فريق الإدارة فيلم أو مسلسل أو موسم أو حلقات غادرت المكتبة
Health (سلامة النظام) فريق الإدارة فحص سلامة فشل أو أُصلح
Needs a decision (بحاجة إلى قرار) فريق الإدارة تنزيل أو استيراد يحتاج إليك

تحت القائمة، يحدّد Season packs (حزم المواسم) ما يرسله تنزيل واحد فيه حلقات كثيرة: One Alert for the pack (تنبيه واحد للحزمة)، وفيه سطر لكل حلقة، أو One Alert per episode (تنبيه لكل حلقة).

الوصول إلى الشبكة المحلية

رابط إلى الوصول إلى الشبكة المحلية

متوقف افتراضيًا. ما دام متوقفًا، تذهب تنبيهات Discord إلى discord.com لا غير، وتذهب الأنواع الأخرى إلى خوادم على الإنترنت لا غير؛ وتُرفض الروابط التي تشير إلى هذا الجهاز أو إلى شبكتك المنزلية، حتى بعد تحليل الاسم. فعّله مع خادم بريد أو مستقبِل في المنزل. ولا تُتّبع إعادات التوجيه أبدًا.

أوقف تنبيهًا مؤقتًا

رابط إلى أوقف تنبيهًا مؤقتًا

أزل العلامة عن Send messages (إرسال الرسائل). تعرض البطاقة Off (متوقف) ويبقى التنبيه.

كلمات المرور والرموز

رابط إلى كلمات المرور والرموز

تُخزَّن مشفّرة، ثم تظهر بالكلمة Stored (مخزَّن). اترك الحقل فارغًا لتبقى كما هي. إذا وجّهت تنبيهًا إلى خادم آخر كتبت السر من جديد؛ فالسر المخزَّن لا يذهب إلى مكان جديد أبدًا.

العَرَض:

Paste the Discord link (الصق رابط Discord)

السبب: الرابط لا يبدأ بـ https://discord.com/. الحل: انسخ رابط الـ webhook من جديد. ومع خادم شبيه بـ Discord في المنزل، فعّل Reach the local network (الوصول إلى الشبكة المحلية).

العَرَض:

Points to the local network, which this Alert may not reach (يشير إلى الشبكة المحلية، وهذا التنبيه غير مسموح له بالوصول إليها)

السبب: الخادم على هذا الجهاز أو على شبكتك المنزلية. الحل: فعّل Reach the local network.

العَرَض: Last try failed (فشلت آخر محاولة) مع رد 401 أو 404. السبب: الرابط أو الرمز خاطئ. هذه الحالات لا تُعاد محاولتها. الحل: صحّحه واختر Send a test.

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

إعادة المحاولة

انتهاء المهلة، أو رد يطلب التمهّل، أو خطأ في الخادم: تُعاد المحاولة بعد 5 ثوانٍ ثم 30 ثانية ثم دقيقتين. وإذا طلب الخادم انتظارًا أطول، يلتزم به HolyArrs حتى 5 دقائق. الرفض، مثل رابط خاطئ، لا تُعاد محاولته. كل فشل يضيف إلى السجل صفًّا نصه “Alert could not be sent” (تعذّر إرسال التنبيه).

الأنواع المؤجَّلة وحقولها

تظهر مع تفعيل المفتاح alert_channels_more لا غير.

النوع الحقول
Telegram Bot token (رمز البوت) من @BotFather، و Chat ID (معرّف المحادثة: معرّف مستخدم أو مجموعة أو قناة، أو @channel). راسل البوت أو أضفه إلى المجموعة أولًا
ntfy Server address (عنوان الخادم؛ الفارغ يعني ntfy.sh)، و Topic (الموضوع)، و Access token (رمز الوصول) اختياري. كل من يعرف الموضوع يستطيع قراءته
Gotify Server address، و App token (رمز التطبيق)
Pushover User key (مفتاح المستخدم؛ مفاتيح المجموعات تعمل)، و App token
Webhook (JSON) Webhook link (رابط الـ webhook)، و Secret (السر) اختياري، و What the secret does (وظيفة السر)
ما يستقبله الـ webhook

طلب POST واحد لكل رسالة، مع Content-Type: application/json، وهذه الترويسات:

الترويسة القيمة
X-HolyArrs-Event اللحظة، مثل import أو test
X-HolyArrs-Delivery معرّف عشوائي لهذه الرسالة
X-HolyArrs-Timestamp مع Signs each message (يوقّع كل رسالة): الثواني منذ 1970
X-HolyArrs-Signature مع Signs each message: sha256= ثم HMAC-SHA256 بالصيغة الست عشرية للنص <timestamp>.<delivery>.<body>، ومفتاحه سرّك
Authorization مع Is sent as a bearer token (يُرسَل رمزَ bearer): Bearer <secret>

مع Nothing (لا شيء)، لا يُرسَل أي سر. عند التوقيع، ارفض الطوابع الزمنية القديمة ومعرّفات التسليم التي رأيتها من قبل، حتى لا يُعاد إرسال رسالة منسوخة.

{
"moment": "import",
"event_kind": "import_done",
"subject": "In the Library: Arrival (2016)",
"text": "Import done: 1 placed by hardlink",
"at": "2025-01-01T18:04:11Z",
"movie": { "id": 12, "name": "Arrival", "year": 2016, "tmdb": "329865", "imdb": "tt2543164" },
"data": { "from": "/downloads/Arrival.2016.1080p" }
}

تظهر حقول أخرى حين تنطبق: test، و show و episodes، و artist و tracks، و report، و people. يحوي people أسماء أصحاب الطلبات، لا العناوين أبدًا. ويحوي data الأسباب والمسارات من صف السجل الذي وراء الرسالة. أي رد 2xx يُعدّ تسليمًا ناجحًا.

HolyArrs مجاني. إذا وفّر عليك وقتًا، امنحه نجمة على GitHub أو ادعمه ماليًا أو ادعُني إلى فنجان قهوة.