مقدمة

أحد الفوائد الرئيسية لاستخدام مديري النوافذ هي القدرة على إضافة الوظائف بسهولة عبر أدوات سطر الأوامر الصغيرة. go-pray أداة سطر أوامر لمواقيت الصلاة تناسب هذا الأسلوب: فهي تعرض الصلاة القادمة في شريط الحالة، وتعرض تقويم الصلاة لأي تاريخ، وتعمل كخدمة في الخلفية ترسل إشعارًا وتشغّل الأذان عند دخول وقت الصلاة.

كانت هذه التدوينة تستخدم سابقًا سكريبت باش prayer-times. يحل go-pray محله كملف تنفيذي واحد، فلم يعد يحتاج إلى at أو yad أو mpv أو curl أو وحدة Systemd.

التثبيت

ثبّت أحدث إصدار بأمر واحد:

curl -fsSLo - https://github.com/0xzer0x/go-pray/raw/refs/heads/main/install.sh | bash

يثبّت السكريبت الحزمة المناسبة لتوزيعتك:

التوزيعةطريقة التثبيت
Debian / Ubuntuحزمة .deb
Fedora / RHELحزمة .rpm
Alpineحزمة .apk
Arch LinuxAUR
غير ذلكأرشيف عام

في التوزيعات الأخرى، يلجأ السكريبت إلى الأرشيف العام ويثبّت go-pray في ./bin. انقل الملف التنفيذي إلى مجلد ضمن PATH.

لتثبيت إصدار محدد، اضبط INSTALL_VERSION (غير مدعوم في Arch Linux):

curl -sLo - https://github.com/0xzer0x/go-pray/raw/refs/heads/main/install.sh \
| env INSTALL_VERSION=0.1.3 bash

Nix

إذا كنت تستخدم Nix، أضف الحزمة من Flake المشروع إلى ملفك الشخصي:

nix profile add github:0xzer0x/go-pray

لإعداد NixOS ووحدة Home Manager، راجع صفحة التثبيت في الويكي.

التهيئة

يقرأ go-pray ملف config.yml من أول مسار موجود من المسارات التالية:

  1. $XDG_CONFIG_HOME/go-pray
  2. $HOME/.config/go-pray
  3. $HOME/.go-pray

ويمكنك تحديد ملف آخر باستخدام --config. تحتاج التهيئة الأساسية إلى موقعك وطريقة الحساب:

# ~/.config/go-pray/config.yml
language: ar
timezone: Africa/Cairo

location:
  lat: 30.001780
  long: 31.290419

calculation:
  # EGYPT, MWL, KARACHI, UAQ, DUBAI, ISNA, KUWAIT, QATAR, SINGAPORE, UOIF, or OTHER
  method: EGYPT

# Athan to play at prayer time (required for the daemon)
adhan: $HOME/.local/share/qatami_takbeer.mp3

notification:
  icon: dialog-information
  title: "مواقيت الصلاة"
  body: "حان الآن وقت صلاة {{ .CalendarName }}"
  • احصل على إحداثياتك من Map Coordinates.
  • يقبل timezone منطقة زمنية بصيغة IANA، والقيمة الافتراضية هي منطقتك الزمنية المحلية.
  • language تحدد لغة المخرجات: ar للعربية أو en للإنجليزية (الافتراضية).

CalendarName هو اسم الصلاة الحالية، ويصبح الجمعة بدلًا من الظهر يوم الجمعة. لمعاملات الحساب المخصصة وتعديل المواقيت، راجع صفحة التهيئة في الويكي.

الاستخدام

عرض الصلاة القادمة:

go-pray next

عرض الموعد القادم لصلاة محددة (fajr أو sunrise أو dhuhr أو asr أو maghrib أو isha):

go-pray next fajr

عرض تقويم الصلاة لليوم، أو لأي تاريخ بصيغة YYYY-MM-DD أو @yesterday أو @tomorrow:

go-pray calendar
go-pray calendar @tomorrow 2026-12-01

استخدم --format للاختيار بين المخرجات short (الافتراضية) وtable وjson.

الإشعارات

يرسل go-pray daemon إشعارًا ويشغّل الأذان عند دخول وقت كل صلاة. شغّله ضمن أوامر بدء التشغيل في مدير النوافذ. على سبيل المثال، في إعدادات Hyprland:

exec-once = go-pray daemon

شريط الحالة

Waybar

المتطلبات:

أضف السكريبت التالي باسم scripts/go-pray في مجلد إعدادات Waybar، واجعله قابلًا للتنفيذ:

#!/usr/bin/env bash
set -euo pipefail

# WARN: make sure go-pray is in your PATH
_text="$(go-pray next)"
_calendar="$(go-pray calendar)"
_class="$(cut -d' ' -f1 <<<"${_text}")"

jq \
  --null-input \
  --unbuffered \
  --compact-output \
  --arg class "${_class}" \
  --arg text "${_text}" \
  --arg calendar "${_calendar}" \
  '{ "text": "\($text)", "tooltip": "\($calendar)", "class": "\($class)" }'

ثم أضف الوحدة إلى إعدادات Waybar:

"custom/go-pray": {
  "interval": 60,
  "return-type": "json",
  "exec": "$HOME/.config/waybar/scripts/go-pray",
  "format": "󱠧  {}",
}

تعرض الوحدة الصلاة القادمة، ويعرض التلميح تقويم اليوم. يمكنك تنسيقها في ملف CSS الخاص بـ Waybar باستخدام اسم الصلاة القادمة كفئة (class)، وهو الاسم بلغة المخرجات المحددة في language.