Transform your VS Code into a spiritual environment. Authentic Islamic reminders, Quran recitation, prayer times, and spiritual focus tools.
π 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)
CodeTune is now stable and production-ready! This major release includes:
- 5 Languages Supported: Arabic (Ψ§ΩΨΉΨ±Ψ¨ΩΨ©), English, Russian (Π ΡΡΡΠΊΠΈΠΉ), French (FranΓ§ais), Spanish (EspaΓ±ol)
- Automatic Language Detection based on VS Code locale
- RTL Support for Arabic with proper text direction
- Umm al-Qura Calendar: Official Saudi Islamic calendar implementation
- Fixed Hijri Date Issues: Corrected 2-day offset (now shows accurate dates)
- Precise Prayer Times: Enhanced Adhan library with Egyptian calculation method
- Smart Statistics Toggle: Click icon to switch between session counts and listening time
- Context-Aware Notifications: Intelligent prayer time reminders
- Friday Surah Intelligence: Auto-show Friday Surah section only when relevant
- Daily Prayer Goals Reset: Automatic daily reset for spiritual tracking
- Zero Console Spam: Clean logging with optional debug mode
- Webview Sandboxing: Proper VS Code dialog integration
- Error Resilience: Comprehensive error handling throughout
- Cross-Platform: Tested on Windows, macOS, and Linux
- Time-Aware Azkar: Automatically displays Morning Azkar (Fajr-Sunrise) and Evening Azkar (Asr-Maghrib).
- Smart Scheduling: Reminders respect your coding flow with customizable intervals (5min - 4hrs).
- Work Mode: "Working Hours Only" filter to keep professional focus.
- Authentic Content: 500+ verified Adia, Hadis, and Quranic wisdom.
- Live Countdown: Real-time countdown to the next prayer (accurate astronomical calculations).
- Hijri Date: Displays current Islamic date with Arabic numerals.
- Auto-Location: Detects timezone automatically for accurate prayer times.
- 15+ Reciters: Including Mishary Alafasy, Al-Sudais, Abdul Basit, Al-Minshawy, and more.
- Smart Auto-Reading: Auto-page turner and multi-speed reading for Khatmah.
- Background Play: Independent volume control and seamless streaming via CDN.
- Statistics: Tracks your listening sessions (Daily/Weekly/Monthly metrics).
- Open VS Code.
- Press
Ctrl+Shift+Xto open Extensions. - Search for "CodeTune".
- Click Install.
- Optional: Reload VS Code to initialize the Activity Bar icon.
Click the Mosque Icon (π) in the left Activity Bar to access the dashboard.
- View Date: See the current Hijri date.
- Prayer Status: Check time remaining for the next prayer.
- Quick Controls: Access the Quran player immediately.
You can control the player via the dashboard or Command Palette:
| Command | Shortcut | Description |
|---|---|---|
CodeTune: Play Quran |
Ctrl+Shift+Q |
Start/Resume recitation |
CodeTune: Stop |
Ctrl+Shift+S |
Stop playback |
CodeTune: Open Settings |
- | Open the configuration panel |
Reminders appear as notifications in the bottom right corner.
- Morning/Evening: Specific content appears during their respective sun times.
- General: Wisdom and Hadith appear based on your interval settings.
Manage all settings via the UI panel (No JSON editing required). Click the Gear Icon (βοΈ) in the CodeTune panel.
| Setting | Default | Description |
|---|---|---|
Enable Reminders |
True |
Master toggle for all notifications. |
Interval |
30 min |
Frequency of reminders (5 - 240 mins). |
Show Morning Azkar |
True |
Show specific Azkar after Fajr. |
Show Evening Azkar |
True |
Show specific Azkar after Asr. |
Working Hours Only |
False |
Only show reminders during 9-5 schedule. |
| Setting | Default | Description |
|---|---|---|
Reciter |
Alafasy |
Choose from 15+ high-quality reciters. |
Volume |
70% |
Independent volume level (doesn't affect system). |
- Prayer Calculation: Uses astronomical algorithms relative to Mecca coordinates for consistency.
- Audio Source: High-quality MP3 streaming from Islamic Network CDN.
- Privacy: No personal data is collected. Listening statistics are stored locally on your machine.
| Issue | Solution |
|---|---|
| Audio not playing | Check internet connection (CDN streaming) and independent volume slider. |
| Wrong Prayer Times | Ensure your system timezone is correct. The extension uses system time + astronomical calculation. |
| Settings not saving | Settings auto-save on change. If stuck, restart VS Code. |
We welcome contributions from the community!
- Fork the repository.
- Create a feature branch (
git checkout -b feature/AmazingFeature). - Commit your changes.
- Open a Pull Request.
Note: Please ensure all Islamic content additions are verified against authentic sources.
- License: MIT License.
- Credits:
- Audio provided by Islamic Network.
- Prayer times calculated via Aladhan API principles.
