Omahub
← All plugins
R

Hijri Date

by Randa Zraik

A multilingual Umm al-Qura Hijri date and calendar for the Omarchy bar.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
688e570
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
688e570
Reviewed
1 month ago

This is a well-structured, transparent calendar widget with no malicious or suspicious code. The only network activity is an optional, disclosed HTTPS check for updated calendar data, and the downloaded payload is strictly validated (size limits, schema checks, revision gating) before being used. No obfuscation, credential access, destructive commands, or hidden persistence were found.

  • The autoUpdate feature (enabled by default) makes an HTTPS request to raw.githubusercontent.com on startup to check for calendar updates; this is disclosed in the manifest and README, and the data is non-executable and strictly validated before use.
  • The GitHub Actions workflow 'calendar-source-check.yml' has write permissions and auto-pushes branches, but it only opens a PR for human review and does not auto-merge, which is a reasonable supply-chain posture.
How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/RandaZraik/omarchy-hijri-date --enable
Widgets #bar #quickshell #system

Hijri Date for Omarchy

A multilingual Umm al-Qura Hijri date and calendar for the Omarchy bar.

<p align="center"> <img src="preview.png" width="681" alt="Hijri date in the Omarchy bar with its anchored Arabic calendar, Gregorian dates, and Islamic occasion markers"> </p>

Install

omarchy plugin add https://github.com/RandaZraik/omarchy-hijri-date.git --enable

Place it immediately before the built-in clock:

omarchy bar move io.github.randazraik.hijri-date --before omarchy.clock

Replace omarchy.clock if you use a custom clock ID.

Features

  • Arabic, English, Turkish, and Bengali dates with native or Latin numerals
  • Full, compact, numeric, and month/day bar formats
  • Optional weekday and Islamic occasion beside the bar date
  • Localized Hijri calendar with Gregorian dates in every cell
  • Major and opt-in traditional Islamic occasion markers
  • Configurable week start and −2 to +2 local adjustment
  • Anchored or centered popup on horizontal and vertical bars
  • Mouse and keyboard controls

Options

Change every option from Settings in the popup.

Setting Key Choices
Language language Auto, English, العربية, Türkçe, বাংলা
Numerals numerals Native, Latin
Bar format format Full, Compact, Numeric, Month and day
Show weekday showWeekday On, Off
Automatic calendar updates autoUpdate On, Off
Local adjustment dayOffset −2 through +2 days
Week starts on weekStart Auto, Saturday, Sunday, Monday
Calendar markers markers Major dates, Major + traditional, Off
Today's marker in bar barMarker Off, Dot, localized Name
Panel position panelPosition Anchored, Centered
Font family fontFamily Empty to inherit Omarchy, or any installed font

Configure through the bar editor or CLI:

omarchy bar set io.github.randazraik.hijri-date language العربية
omarchy bar set io.github.randazraik.hijri-date barMarker Name

Auto language follows the desktop locale and falls back to English. On a vertical bar, both Dot and Name use a compact dot.

Controls

  • Left click: open or close the calendar
  • Right click: cycle the bar format
  • Click a day: select it and show its occasion
  • Left/right or H/L: change month
  • Up/down or K/J: change year
  • T: return to today
  • C or Enter: copy the selected Hijri date
  • Escape: close
  • Tab/Shift+Tab: move between neighboring bar panels

Markers

Major dates use the accent dot:

  • Islamic New Year — رأس السنة الهجرية
  • Ashura — عاشوراء
  • Ramadan begins — بداية رمضان
  • Eid al-Fitr — عيد الفطر
  • Day of Arafah — يوم عرفة
  • Eid al-Adha — عيد الأضحى
  • Days of Tashriq — أيام التشريق

The optional traditional tier uses a muted dot and also includes:

  • Mawlid — المولد النبوي

  • Isra and Mi'raj — الإسراء والمعراج

  • Mid-Sha'ban — ليلة النصف من شعبان

  • 27th night of Ramadan — ليلة ٢٧ من رمضان

  • White Days — الأيام البيض

  • Select a marked day to see its localized name below the grid.

  • Set barMarker to Dot or Name to show today's occasion beside the date.

  • Traditional dates vary between communities; the local adjustment shifts the date and its markers together.

Calendar data

<!-- BEGIN GENERATED CALENDAR RANGE -->
  • Current bundled data: revision 1; Hijri 1318-01-01–1500-12-30 AH; Gregorian 1900-04-30–2077-11-16.
<!-- END GENERATED CALENDAR RANGE -->
  • Calendar updates are optional; the bundled calendar remains available without internet.
  • Use dayOffset if your local authority announces a different month start.

Update or remove

Update the plugin:

omarchy plugin update io.github.randazraik.hijri-date

Remove it:

omarchy plugin remove io.github.randazraik.hijri-date

License and attribution

MIT licensed. Calendar data is provided by KACST's Umm al-Qura Calendar service.