Transform your VS Code into a spiritual environment.
Authentic Islamic reminders, Quran recitation, prayer times, and spiritual focus tools — all without leaving your editor.

🚀 Installation • ✨ Features • 📖 Usage • ⚙️ Configuration • 🐛 Troubleshooting

CodeTune integrates spirituality seamlessly into your development workflow. It helps you maintain faith and focus by providing context-aware Islamic content, prayer times based on your location, and a high-quality Quran player — all without leaving your editor.

"Indeed, in the remembrance of Allah do hearts find rest." (Surah Ar-Ra'd, 13:28)

• Fajr-Based Day Tracking: Daily goals now reset at Fajr (dawn) instead of midnight
• Timezone-Safe Date Arithmetic: Noon-anchored date calculations prevent DST errors
• Smart Streak Calculation: Streak survives until next Fajr, not midnight
• Fajr Time Sync: Prayer times flow from API to SpiritualTracker automatically

• Accumulator Pattern: Short listening sessions (45s) no longer lost — milliseconds accumulate until a full minute
• Webview-to-Extension Bridge: localStorage data now properly crosses to SpiritualTracker
• Real-Time Dashboard Update: Quran listening minutes show in progress bar immediately

• Config registration, 403 Forbidden, message handlers, duplicate buttons, dhikr counter sync, modal transparency, and more

• Coding-Aware Notifications: Detects when you're actively typing and pauses reminders automatically
• Auto-Resume: Notifications resume after you stop coding — never breaking your flow again
• Quiet Hours: Configurable night hours where all notifications are fully silenced

• Daily Goals Tracker: Visual progress bars for Quran listening minutes and Dhikr count
• Streak System: Tracks consecutive days of spiritual activity with motivational messages
• Achievements: Unlock badges like "One Week Warrior" (7-day streak) and "Legend" (30-day streak)
• Weekly Summary: Overview of your spiritual activity over the last 7 days
• All-Time Stats: Total Quran minutes, Dhikr count, and personal records

• "You're Offline" Screen: Beautiful network status UI with pending retry queue
• Auto-Retry: Automatically re-attempts failed audio streaming when connection returns
• User-Friendly Errors: No scary stack traces — just clear, helpful messages
• Exponential Backoff: Smart retry logic that doesn't hammer the server

• XSS Protection: All dynamic content is fully sanitized before rendering
• Memory Leak Prevention: All intervals, timers, and event listeners are properly disposed
• Error Black Box: Background error logging for debugging without UI clutter
• Retry Manager: Robust network request handling with configurable max retries

• Detects active coding (typing, file saves) and pauses non-urgent reminders
• Quiet Hours setting prevents notifications during sleep/prayer times
• Zero configuration — works intelligently out of the box

• Daily Goals: Log Quran listening time and Dhikr count with simple modal inputs
• Streak Counter: Days-in-a-row tracker with midnight-safe date logic
• Achievements: Gamified spiritual milestones to keep you motivated
• Weekly Heatmap: See which days you were most spiritually active

• Time-Aware Azkar: Morning Azkar (Fajr → Sunrise), Evening Azkar (Asr → Maghrib)
• Friday Special: Enhanced Friday content — Jumu'ah duas, Surah Al-Kahf enforcement, Salawat
• Customizable: Intervals from 5 minutes to 4 hours
• Authentic Content: 500+ verified Adia, Hadis, and Quranic wisdom

• Live Countdown: Real-time countdown to next prayer with precise astronomical calculation
• Hijri Date: Umm al-Qura calendar with accurate date display
• Auto-Location: Automatic timezone detection — no manual setup needed

• 15+ Reciters: Mishary Alafasy, Al-Sudais, Abdul Basit, Al-Minshawy, Maher Al-Muaiqly, and more
• Smart Auto-Reading: Auto-page turner with adaptive speed for Khatmah
• Background Play: Independent volume and seamless CDN streaming
• Statistics: Daily/Weekly/Monthly listening metrics

• Tasbih (سُبْحَانَ اللَّهِ / الْحَمْدُ لِلَّهِ / اللَّهُ أَكْبَرُ)
• Istighfar, Salawat with Friday-aware daily targets
• Adhkar collection with one-click increment
• Persistent cross-session storage

1. Open VS Code
2. Press Ctrl+Shift+X to open Extensions
3. Search for "CodeTune"
4. Click Install
5. Click the 🕌 Mosque icon in the Activity Bar to open the dashboard

Click the Mosque Icon (🕌) in the left Activity Bar to access everything.

In the Spiritual Progress section:

• Click 📖 Log Quran Time → enter minutes → dashboard updates automatically
• Click ✨ Track Dhikr → enter count → streak and goals update

Just code normally — the extension watches your activity. When you stop typing for 30+ seconds, any pending notifications are delivered. You'll never see a popup mid-keystroke.

All settings are available in the UI panel. No JSON editing required.

• Prayer Calculation: Adhan library with Egyptian calculation method
• Audio: High-quality MP3 streaming from Islamic Network CDN
• Privacy: No data collected. All stats stored locally on your machine
• Architecture: Clean Extension Host / Webview separation with secure postMessage bridge
• Error Handling: Background ErrorReporter with exponential backoff RetryManager

1. Fork the repository
2. Create a feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes
4. Open a Pull Request

Please ensure all Islamic content additions are verified against authentic sources (Quran, Bukhari, Muslim, etc.)

• License: MIT
• Audio: Islamic Network CDN
• Prayer Times: Adhan.js
• Fonts: Google Fonts — Amiri Quran, Scheherazade New, Noto Naskh Arabic