🌙 Azkar Reminder — VS Code Extension

Azkar Reminder is a lightweight, offline-friendly VS Code extension that reminds you with Azkar (morning, evening, general) at configurable intervals. Supports Arabic and English, auto-detects morning/evening windows, and allows showing Azkar manually via commands.

✨ Features

✔ Automatic periodic reminders (every 10 minutes)
✔ Morning and evening detection based on user-configurable hours
✔ Random Azkar from 3 categories:
- Morning
- Evening
- General
✔ Localization (Arabic / English)
✔ Commands for manual display:
- Azkar: Show Next Zekr
- Azkar: Show Category…

✔ Loads Azkar dynamically from:

resources/azkar.ar.json
resources/azkar.en.json

✔ Smart time window behavior
✔ Hot reload when settings or language change

📂 How It Works

The extension reads Azkar from JSON files stored inside:

/resources/
    azkar.ar.json
    azkar.en.json

Each file contains:

{
  "morning": ["..."],
  "evening": ["..."],
  "general": ["..."]
}

🛠 Commands

Command	Description
Azkar: Show Next Zekr	Shows a random zekr based on the current time window
Azkar: Show Category…	Manually choose morning/evening/general

⚙ Extension Settings

This extension contributes the following settings:

Localization

Setting	Type	Default	Description
`azkarReminder.language`	string	`"ar"`	Choose between Arabic or English

Scheduler

Setting	Type	Default	Description
`azkarReminder.intervalMinutes`	number	`10`	Reminder interval in minutes

Morning Time Window

Setting	Type	Default	Description
`azkarReminder.morningStart`	number	`5`	Morning zekr start hour (0–23)
`azkarReminder.morningEnd`	number	`11`	Morning zekr end hour

Evening Time Window

Setting	Type	Default	Description
`azkarReminder.eveningStart`	number	`16`	Evening zekr start hour
`azkarReminder.eveningEnd`	number	`23`	Evening zekr end hour

🚀 Requirements

No external API or internet connection required. Everything works offline using JSON files bundled with the extension.

🐞 Known Issues

No known issues. If you find a bug or want to add features, feel free to open an issue.

📦 Release Notes

0.1.0

Initial release
Added morning/evening detection
Added localization (AR/EN)
Added automatic reminders + manual commands

📘 Developer Notes

This extension follows best practices recommended by the VS Code team:

Uses vscode.workspace.getConfiguration
Uses activation events to avoid unnecessary loading
Uses JSON-based dynamic resource loading
All logic isolated in timeUtils.ts and extension.ts

More info: 👉 VS Code Extension Guidelines

❤️ Enjoy!

If you'd like more features (audio recitation, Fajr/Maghrib prayer API, status bar widget), just ask!

Azkar Reminder

Mohammed Gamal