Muslimku (Мусульманские молитвы и время намаза)

Дополнение Muslimku позволяет пользователям NVDA получать точное время молитв (намазов) направление киблы и исламскую (хиджрийскую) дату на основе выбранного местоположения.

Основные возможности

• Определение времени пяти обязательных молитв: Фаджр (Subuh) Зухр (Dzuhur) Аср (Ashar) Магриб (Maghrib) Иша (Isya).
• Отображение времени Имсака восхода солнца (Sunrise) времени Духа (Dhuha) и заката (Sunset).
• Гибкая настройка местоположения с поддержкой стран и городов а также детальными провинциями и районами для Индонезии.
• Автоматические напоминания о времени намаза с возможностью настройки оповещения за несколько минут до молитвы.
• Объединённая дата: хиджрийская и григорианская с дополнительным днём пасаран (для Индонезии).
• Определение направления Киблы из текущего местоположения с выводом в градусах и направлении света (север восток юг запад и промежуточные направления).
• Выбор метода расчёта времени намаза (MWL ISNA Umm Al-Qura Египетский Сингапурский метод Кеменаг RI и другие).
• Выбор мазхаба (Шафии или Ханафи) для коррекции времени Асра.
• Управление временем напоминаний и возможность полного отключения звуковых/речевых уведомлений.

Настройка дополнения

Все настройки находятся в диалоге «Параметры NVDA» → «Muslimku».

Основные параметры

• Язык (Language) — выбор языка интерфейса: «Indonesia» или «English».
• Страна (Country) — выбор страны для определения местоположения.
• Провинция (Province) — отображается только для Индонезии позволяет уточнить регион.
• Город/Район (City/Regency) — для Индонезии загружается список районов (кабупатен/кота). Для других стран доступен выпадающий список городов или поле ручного ввода.
• Метод расчёта (Calculation method) — один из поддерживаемых методов определения времени молитв (MWL ISNA Карачи и другие).
• Мазхаб Аср (Asr madhab) — Шафии или Ханафи (влияет на время послеполуденной молитвы).
• Включить напоминания (Enable reminders) — активирует автоматическое оповещение перед каждой молитвой.
• Напоминать за (минут) до молитвы (Reminder offset) — число минут перед наступлением времени намаза когда прозвучит уведомление.

После изменения настроек дополнение автоматически обновит расписание при следующем запросе.

Жесты управления (горячие клавиши)

По умолчанию используются следующие комбинации (все можно переназначить в диалоге «Жесты ввода» категория Muslimku).

Время отдельных молитв

• NVDA+Control+Shift+1 — объявить время Фаджр (Subuh).
• NVDA+Control+Shift+2 — объявить время Зухр (Dzuhur).
• NVDA+Control+Shift+3 — объявить время Аср (Ashar).
• NVDA+Control+Shift+4 — объявить время Магриб (Maghrib).
• NVDA+Control+Shift+5 — объявить время Иша (Isya).

Другие временные интервалы

• NVDA+Control+Shift+6 — объявить время Имсак.
• NVDA+Control+Shift+7 — объявить время восхода солнца (Sunrise).
• NVDA+Control+Shift+8 — объявить время Духа (Dhuha).
• NVDA+Control+Shift+9 — объявить время заката (Sunset).

Общая информация

• NVDA+Control+Shift+H — объявить сегодняшнюю дату: хиджрийская и григорианская а также день пасаран (для Индонезии).
• NVDA+Control+Shift+W — объявить время следующей молитвы и сколько осталось до неё (часы и минуты).
• NVDA+Control+Shift+L — объявить текущее сохранённое местоположение (страна город/район).
• NVDA+Control+Shift+Q — проверить направление Киблы (требуется интернет для геокодирования).

Особенности работы с датой и напоминаниями

Хиджрийская и григорианская дата

Дополнение получает данные с API Aladhan. Если местное время превысило время Магриб то хиджрийская дата автоматически увеличивается на один день что соответствует исламскому началу новых суток после заката.

Для Индонезии дополнительно рассчитывается день пятидневного цикла пасаран (Legi Pahing Pon Wage Kliwon) на основе григорианской даты.

Напоминания о молитвах

Проверка времени выполняется в фоновом потоке каждые 15 секунд. Когда текущее время достигает момента «время молитвы минус смещение (offset)» дополнение произносит сообщение на выбранном языке и показывает всплывающее уведомление Windows (тост).

Сообщение для Индонезии призывает отойти от компьютера и совершить молитву. Сообщение на английском языке информирует о наступлении времени молитвы.

Поведение горячих клавиш (двойное нажатие)

Все команды объявления времени и даты поддерживают двойное нажатие (быстрое повторное нажатие той же комбинации в течение 1,5 секунды).

• При одиночном нажатии NVDA произносит результат (например время молитвы или дату).
• При двойном нажатии тот же самый текст копируется в системный буфер обмена а затем NVDA произносит подтверждение «Текст скопирован» («Result copied to clipboard»).

Это удобно чтобы быстро сохранить время молитвы или дату в буфер обмена.

Определение Киблы

При нажатии NVDA+Control+Shift+Q дополнение выполняет следующие действия:

1. Формирует запрос к геокодеру Nominatim (OpenStreetMap) на основе сохранённого местоположения (район/город + провинция + страна).
2. Получает широту и долготу.
3. Рассчитывает угол поворота от текущего местоположения к Каабе (Мекка).
4. Преобразует угол в одно из восьми направлений: север, северо-восток, восток, юго-восток, юг, юго-запад, запад, северо-запад.
5. Выводит сообщение вроде «Qibla Detected! Qibla direction from your location is X degrees (northeast)».

Во время расчёта NVDA издаёт короткий звуковой сигнал и произносит «Проверка Киблы в процессе» («Checking the Qibla... in progress»). После завершения расчёта звучит второй сигнал и объявляется результат.

Важно: Для работы определения Киблы требуется активное интернет-соединение.

Примечания по расположению настроек

• Поля «Провинция» и «Район» доступны только при выборе страны «Indonesia».
• Для всех остальных стран используется либо выпадающий список городов (загружается через API) либо поле ручного ввода.
• Если загрузка списка городов не удалась отображается предупреждение и предлагается ввести название города вручную.

Технические детали (для сведения)

• API для времени молитв: Aladhan (api.aladhan.com).
• API для городов мира: countriesnow.space.
• API для геокодирования: Nominatim OpenStreetMap.
• API для индонезийских провинций и районов: emsifa.com/api-wilayah-indonesia.

Дополнение кэширует полученные данные для снижения числа сетевых запросов (тайм-аут кэша 5 минут для времени молитв и 6 часов для хиджрийской даты).

Известные ограничения

• Для корректного определения Киблы необходимо разрешение на определение местоположения через настройки самого дополнения (фактически используется введённый город/район а не IP адрес).
• Без интернета недоступны обновление времени молитв (кроме кэша) и расчёт Киблы.
• Для Индонезии требуется дополнительный API-запрос для получения списка районов что может вызвать небольшую задержку при открытии панели настроек.