مقدمة
أحد الفوائد الرئيسية لاستخدام مديري النوافذ هي القدرة على إضافة الوظائف بسهولة عبر أدوات سطر الأوامر الصغيرة. 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 Linux | AUR |
| غير ذلك | أرشيف عام |
في التوزيعات الأخرى، يلجأ السكريبت إلى الأرشيف العام ويثبّت 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 من أول مسار موجود من المسارات التالية:
$XDG_CONFIG_HOME/go-pray$HOME/.config/go-pray$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.
