🕌 CodeTune - Islamic Coding Companion

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

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

📖 Overview

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)

✨ Features

🤖 Intelligent Reminders System

• 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.

🕌 Prayer Times & Calendar

• 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.

🎵 Premium Quran Player

• 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).

🚀 Installation

1. Open VS Code.
2. Press Ctrl+Shift+X to open Extensions.
3. Search for "CodeTune".
4. Click Install.
5. Optional: Reload VS Code to initialize the Activity Bar icon.

📖 Usage

1. Activity Bar Integration

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.

2. Quran Player

You can control the player via the dashboard or Command Palette:

3. Smart Reminders

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.

⚙️ Configuration

Manage all settings via the UI panel (No JSON editing required). Click the Gear Icon (⚙️) in the CodeTune panel.

📿 Reminders Settings

🎵 Audio Settings

🔧 Technical Details

• 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.

🐛 Troubleshooting

🤝 Contributing

We welcome contributions from the community!

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

Note: Please ensure all Islamic content additions are verified against authentic sources.

❤️ License & Attribution

• License: MIT License.
• Credits:
  • Audio provided by Islamic Network.
  • Prayer times calculated via Aladhan API principles.