Zakereen — Islamic Mindfulness Companion

Stay spiritually mindful without leaving your editor. Zakereen brings gentle dhikr reminders, prayer times, a digital tasbih, and quiet moments of reflection into VS Code and compatible IDEs.

Highlights

• Gentle dhikr reminders with Focus, Balanced, and Frequent rhythms
• Prayer times calculated for your city through AlAdhan
• Manual mosque times when you prefer your local timetable
• Prayer notifications before Salah and when prayer time begins
• Five-minute snooze from prayer notifications
• Digital tasbih with goals of 33, 99, or 100
• Daily dhikr history and per-remembrance breakdown
• Friday mode with Jummah reminders and salawat
• Quiet-moment reflections after a configurable period of editor inactivity
• Next-prayer status bar with today's dhikr count
• Native editor themes, responsive layout, keyboard navigation, and screen-reader semantics

Getting Started

1. Install Zakereen from the Extensions view.
2. Select the Zakereen crescent in the Activity Bar.
3. Open Settings in the Zakereen dashboard.
4. Enter your city and country, then select your calculation method and madhab.
5. Choose a reminder rhythm and begin counting dhikr.

Zakereen defaults to Makkah with the Umm al-Qura calculation method. Review the settings after installation so prayer times match your location and preferred method.

Dashboard

Home

See a daily remembrance, today's count, the next prayer, a hadith, and your reminder rhythm.

Prayers

View Fajr, Sunrise, Dhuhr, Asr, Maghrib, and Isha in your local display format. The next prayer is highlighted, and the dashboard shows whether times came from AlAdhan or your manual mosque timetable.

Tasbih

Select a remembrance, choose a target, and count from the dashboard. Your current session and daily totals persist between editor restarts.

Press Ctrl+Alt+D on Windows or Linux, or Cmd+Alt+D on macOS, to count from anywhere in the editor when an input is not focused.

Settings

Configure prayer calculation, reminders, Friday mode, quiet-moment reflections, and the status-bar summary. Select Use my mosque's manual times to enter all five Salah times in 24-hour format.

Commands

Open the Command Palette with Ctrl+Shift+P or Cmd+Shift+P, then search for Zakereen.

Configuration

Settings are available from the Zakereen dashboard or through Settings → Extensions → Zakereen.

Privacy and Network Use

Zakereen does not read, collect, or transmit your source code, file contents, terminal output, project names, or workspace data.

When automatic prayer calculation is enabled, the configured city, country, calculation method, and madhab are sent to the AlAdhan prayer-time service. Prayer data, settings, tasbih state, and dhikr totals are stored locally by the editor. Choose manual mosque times if you do not want to request calculated prayer times.

Reminders run only while the editor extension host is active. Zakereen is not an operating-system prayer alarm and cannot notify you while the IDE is fully closed.

Compatibility

Zakereen supports VS Code 1.85 or newer and compatible desktop IDEs that implement the VS Code Extension API. A separate Open VSX publication may be required for IDEs that do not use the Visual Studio Marketplace.

Support

• Report an issue
• View the source repository

When reporting a prayer-time problem, include your city, country, calculation method, madhab, and expected time. Do not include private workspace or account information.

License

Zakereen is available under the MIT License.