התראות

התראה שולחת הודעת 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

ב-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 (פרקים חדשים)	מבקשים ועוקבים	לכל היותר 1 לסדרה בשעה. כל אחד יכול לכבות אותן
New albums (אלבומים חדשים)	עוקבים אחרי אמן	לכל היותר 1 לאמן בשעה
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 וסוגים אחרים רק לשרתים באינטרנט; קישורים למחשב הזה או לרשת הביתית שלך נדחים, גם אחרי חיפוש שם. הפעל אותו עבור שרת דואר או מקלט בבית. HolyArrs אף פעם לא עוקב אחרי הפניות מחדש.

השהיית התראה

בטל את הסימון של Send messages. הכרטיס מציג Off (כבוי) וההתראה נשארת.

סיסמאות ו-tokens

נשמרים מוצפנים, ואז מוצגים כ-Stored (שמור). השאר את השדה ריק כדי להשאיר אותו. כשאתה מכוון התראה לשרת אחר, אתה מקליד את הסוד שוב; סוד שמור אף פעם לא הולך למקום חדש.

אם זה לא עובד

תסמין:

Paste the Discord link

סיבה: הקישור לא מתחיל ב-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. סיבה: הקישור או ה-token שגויים. אין ניסיון חוזר במקרים האלה. פתרון: תקן אותו ולחץ על Send a test.

תסמין: מי שביקש לא קיבל כלום. סיבה: אין כתובת אימייל או מזהה משתמש ב-Discord בחשבון שלו, הרגע לא מסומן, או שהוא כיבה פרקים חדשים. פתרון: בדוק את שלושת אלה.

למומחים

ניסיונות חוזרים

אחרי timeout, תשובת האטה או שגיאת שרת, HolyArrs מנסה שוב אחרי 5 שניות, 30 שניות ו-2 דקות. אם השרת מבקש להמתין יותר, 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 אופציונלי. כל מי שיודע את ה-topic יכול לקרוא אותו
Gotify	Server address, App token
Pushover	User key (גם מפתחות קבוצה עובדים), App token
Webhook (JSON)	Webhook link, 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 <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 אומרת שההודעה נמסרה.

קשור

• בדיקות תקינות
• אישור בקשות
• משתמשים ותפקידים