YidCal is a Yiddish Calendar Integration for Home Assistant

[!WARNING] <img src="https://cdn.jsdelivr.net/gh/twitter/twemoji@14.0.2/assets/svg/1f1ee-1f1f1.svg" alt="Israel flag" width="18"> Israel option is available, but is experimental / not fully tested. If you’re in Israel and notice any incorrect times or holiday behavior, please open a GitHub issue (include your city, date, and expected vs actual). Important for Israel users (offsets):

• Candle-lighting offset: default is 15 minutes. In Israel most people use 30–40 minutes before sunset, so change this in Options.
• Havdalah offset: default is 72 minutes. Adjust if your minhag differs.

A custom Home Assistant integration that provides a full Yiddish/Hebrew Jewish calendar experience, including holiday spans, zmanim, fast timers, special Shabbos indicators, and automation-friendly binary sensors.

All date calculations are standalone (no external Jewish-calendar integration) and use your Home Assistant latitude, longitude & timezone.

---

Devices / Services layout

Entities are grouped into these Devices/Services for clarity in Home Assistant’s “by device/service” views:

• YidCal — regular daily/weekly sensors
• YidCal — Display — sensors mainly used for dashboards
• YidCal — Holiday Attribute Sensors — sensors created from Holiday sensor attributes (only if enabled)
• YidCal — Special Binary Sensors — binary sensors such as Slichos, Eruv Tavshilin, etc.
• YidCal — Zmanim — all zmanim sensors

(Existing entity IDs stay the same; grouping is for organization.)

---

What YidCal provides (high-level)

Core binary sensors

• No Melucha (binary_sensor.yidcal_no_melucha) (e.g., on Shabbos and Yom Tov)
• No Melucha – Regular Shabbos (binary_sensor.yidcal_no_melucha_regular_shabbos) ON every regular Shabbos from Friday candle lighting to Saturday havdalah — not when Shabbos is Yom Tov (but on for Shabbos Chol HaMoed). Attributes: Now, Window_Start, Window_End
• No Melucha – Yom Tov (binary_sensor.yidcal_no_melucha_yomtov) ON for any contiguous Yom Tov span from candle before first day (sunset of day−1 − candle offset) through havdalah after last day (sunset + havdalah offset) — regardless of weekday. Attributes: Now, Window_Start, Window_End
• Bishul Allowed (binary_sensor.yidcal_bishul_allowed) Usually ON; OFF on Shabbos and Yom Kippur. Perfect for percolators with auto-fill valves. Attributes: Now, Next_Off_Window_Start, Next_Off_Window_End
• 3 Days Yom Tov (binary_sensor.yidcal_three_day_yomtov) ON from candle-lighting through Alos the morning after a continuous Shabbos + Yom Tov block (3+ days of no melacha). Only fires when the block contains both a pure Shabbos (not also YT) and at least one Yom Tov day. Attributes: שבת ואח"כ יום טוב (Shabbos first), יום טוב ואח"כ שבת (YT first)

---

Holiday Sensor attributes list (updated)

• Holiday Sensor (sensor.yidcal_holiday) with boolean attributes for every holiday, including (all default false):

  • א׳ סליחות
  • ערב ראש השנה
  • ראש השנה א׳
  • ראש השנה ב׳
  • ראש השנה א׳ וב׳
  • מוצאי ראש השנה
  • עשרת ימי תשובה
  • צום גדליה
  • שלוש עשרה מדות
  • ערב יום כיפור
  • יום הכיפורים
  • מוצאי יום הכיפורים
  • ערב סוכות
  • סוכות (כל חג)
  • סוכות א׳
  • סוכות ב׳
  • סוכות א׳ וב׳
  • א׳ דחול המועד סוכות
  • ב׳ דחול המועד סוכות
  • ג׳ דחול המועד סוכות
  • ד׳ דחול המועד סוכות
  • חול המועד סוכות
  • שבת חול המועד סוכות
  • הושענא רבה
  • שמיני עצרת
  • שמחת תורה
  • שמיני עצרת/שמחת תורה
  • מוצאי סוכות
  • אסרו חג סוכות
  • ערב חנוכה
  • חנוכה
  • ערב שבת חנוכה
  • שבת חנוכה
  • שבת חנוכה ראש חודש
  • א׳ דחנוכה
  • ב׳ דחנוכה
  • ג׳ דחנוכה
  • ד׳ דחנוכה
  • ה׳ דחנוכה
  • ו׳ דחנוכה
  • ז׳ דחנוכה
  • זאת חנוכה
  • מוצאי חנוכה
  • שובבים
  • שובבים ת"ת
  • צום עשרה בטבת
  • חמשה עשר בשבט
  • תענית אסתר מוקדם
  • שבת ערב פורים
  • תענית אסתר
  • פורים
  • שושן פורים
  • מוצאי שושן פורים
  • ערב בדיקת חמץ
  • ליל בדיקת חמץ
  • ערב פסח מוקדם
  • שבת ערב פסח
  • ערב פסח
  • פסח (כל חג)
  • פסח א׳
  • פסח ב׳
  • פסח א׳ וב׳
  • א׳ דחול המועד פסח
  • ב׳ דחול המועד פסח
  • ג׳ דחול המועד פסח
  • ד׳ דחול המועד פסח
  • חול המועד פסח
  • שבת חול המועד פסח
  • שביעי של פסח
  • אחרון של פסח
  • שביעי/אחרון של פסח
  • מוצאי פסח
  • אסרו חג פסח
  • פסח שני
  • ל"ג בעומר
  • מוצאי ל"ג בעומר
  • ערב שבועות
  • שבועות א׳
  • שבועות ב׳
  • שבועות א׳ וב׳
  • מוצאי שבועות
  • אסרו חג שבועות
  • צום שבעה עשר בתמוז
  • מוצאי צום שבעה עשר בתמוז
  • ערב תשעה באב
  • תשעה באב
  • תשעה באב נדחה
  • מוצאי תשעה באב
  • ט"ו באב
  • יום כיפור קטן
  • ראש חודש
  • שבת ראש חודש
  • ערב שבת
  • ערב יום טוב
  • מוצאי שבת
  • מוצאי יום טוב
  • ערב שבת שחל ביום טוב
  • ערב יום טוב שחל בשבת
  • מוצאי שבת שחל ביום טוב
  • מוצאי יום טוב שחל בשבת

If enabled in config flow options, many of these attributes can also be exposed as separate binary sensors under YidCal — Holiday Attribute Sensors.

---

Erev / Motzi sensors (timing notes)

• Erev (binary_sensor.yidcal_erev) Turns on at Alos on qualifying Erev days (Erev-Shabbos or weekday Erev-Yom-Tov) and turns off at candle-lighting.

  Holiday Erev binary sensors (attribute-derived): these specific Erev holiday binaries now start at Tzeis the night before (instead of Alos):

  • ערב ראש השנה
  • ערב סוכות
  • ערב פסח מוקדם
  • ערב פסח
  • ערב שבועות

  Note: The Day Type “Erev” behavior remains Alos → candle-lighting.

• Motzi (binary_sensor.yidcal_motzi) Turns on after Havdalah, and stays ON until Alos. Attribute: יקנה"ז (added on this Motzi binary sensor — not on the Zman Motzi sensor).

  Motzi holiday sensors (attribute-derived) — Shabbos overlap rule: If a holiday’s “motzi moment” is swallowed by Shabbos (example: the holiday ends Friday night after sunset), then its Motzi-holiday sensor is skipped entirely (you just continue with regular Shabbos → Motzi Shabbos). Exception — major Yom Tov deferral: For מוצאי ראש השנה, מוצאי סוכות, מוצאי פסח, מוצאי שבועות, and מוצאי יום הכיפורים, if YT ends Friday going into a 3-day block, the motzei sensor defers to Motzaei Shabbos (Saturday havdalah → Sunday Alos) instead of being skipped. Exception: In a Purim Meshulash year, מוצאי שושן פורים turns on Sunday Tzeis → Monday Alos.

---

Key daily sensors

• Molad (sensor.yidcal_molad → friendly attribute) Full human-friendly Molad string in Yiddish

• Full Display Sensor (sensor.yidcal_full_display) displays it all in one (e.g פרייטאג פרשת קרח ~ ב׳ ד׳ראש חודש תמוז)

• Parsha (sensor.yidcal_parsha) weekly Torah portion. During weeks where Yom Tov falls on Shabbos (no regular parsha), the sensor shows the next upcoming parsha with an א׳ suffix (e.g. "פרשת שמיני א׳") if there's a regular Mon/Thu kriah that week before Yom Tov. The following week when the parsha is actually leined shows a ב׳ suffix. During the actual Yom Tov / Chol HaMoed days, the parsha is intentionally empty. Sukkos weeks are always empty. Works correctly for both Israel and Diaspora.

• Rosh Chodesh Today (sensor.yidcal_rosh_chodesh_today) i.e.: א' ד'ראש חודש שבט if today (after nightfall) is Rosh Chodesh

• Perek Avos: current Perek rendered in אבות פרק ה׳

• Morid Geshem/Tal Sensor (sensor.yidcal_morid_geshem_or_tal) Indicates when to change the prayer between “Morid HaGeshem”/“Morid HaTal”

• Tal U’Matar (sensor.yidcal_tal_umatar) Indicates when to change the prayer between “V’sen Tal u’Matar”/“V’sen Beracha”

• No Music (binary_sensor.yidcal_no_music) Indicates when music is prohibited (e.g., in Sefirah, Three Weeks)

• Upcoming Shabbos Mevorchim (binary_sensor.yidcal_upcoming_shabbos_mevorchim) on if the upcoming Shabbos is Mevorchim

• Shabbos Mevorchim (binary_sensor.yidcal_shabbos_mevorchim) on if today is Shabbos Mevorchim

• Special Prayer Sensor (sensor.yidcal_special_prayer)

  • Aggregates liturgical insertions (מוריד הגשם/הטל, ותן טל ומטר/ותן ברכה, יעלה ויבוא, על הניסים, עננו, נחם, etc.)
  • Attribute הושענות – daily Hoshana during Sukkot
  • Adds פרשת המן on ג׳ בשלח

• Special Shabbos Sensor (sensor.yidcal_special_shabbos) Special Shabbat names (שבת זכור, שבת נחמו, etc.) Attributes include: individual boolean attributes for each special Shabbos, שבת מברכים / חודש_מברכים, and שבת הפסקה (true when the upcoming Shabbos falls between the ד׳ פרשיות without having one of its own).

• Sefirah Counter (sensor.yidcal_sefirah_counter) Day-count of Sefiras HaOmer

• Sefirah Middos (sensor.yidcal_sefirah_counter_middos) Middos (qualities) of the day in the Omer count

• Tehilim Daily (sensor.yidcal_tehilim_daily) Five-chapter rotation of Tehilim (e.g. א–ה, ו–ט)

• Tehilim Daily - Pupa (sensor.yidcal_tehilim_daily_pupa)

• Date (sensor.yidcal_date) Current Hebrew date in Yiddish (e.g., כ"ה חשון תשפ"ה)

• Day Label Yiddish (sensor.yidcal_day_label_yiddish) (e.g. זונטאג, מאנטאג, ערש"ק, מוצש"ק)

• Day Label Hebrew (sensor.yidcal_day_label_hebrew) (e.g. יום א' יום ב)

• Nine Days (binary_sensor.yidcal_nine_days) turns on Rosh Chodesh Av & turns off 10 Av at Chatzos.

• Day Type (`binary_sensor.yidcal_