Iman Dev - Complete Islamic Developer Tools

A comprehensive VS Code extension for Muslim developers featuring prayer times, Murattal player, Quran study, Islamic calendar, and productivity tools. Code with faith and focus.

Features

🕌 Real-time Prayer Times

• Uses Aladhan API for accurate prayer times worldwide
• Supports all 5 daily prayers (Fajr, Dhuhr, Asr, Maghrib, Isha)
• Optional Jumuah (Friday prayer) reminder
• Multiple calculation methods (ISNA, MWL, Egypt, Makkah, Karachi, Tehran, Jafari, Gulf, Kuwait)
• Automatic daily updates

🎧 Murattal Player

• Listen to Quran recitation while coding
• 7+ world-class reciters (Alafasy, Abdul Basit, Sudais, etc.)
• Background playback with volume control
• Navigate through all 114 surahs
• Auto-play on startup (optional)
• Dedicated status bar controls

📖 Quran Study Tools

• Random verse on startup for daily reflection
• Search Quran by keyword in multiple languages
• Arabic text with translations (Indonesian, English, Urdu)
• Quick access to any verse
• Beautiful formatted display

🎵 Optional Adzan

• Authentic adzan sound at prayer times
• Adjustable volume
• Can be disabled globally or per prayer
• Silent mode available

💾 Auto-Save & Worship Mode

• One-click save all open files before prayer
• Optional "worship mode" with configurable duration
• Optional soft lock to prevent typing during prayer
• Can always skip or end early

📿 Dhikr Counter

• Interactive dhikr counter with preset targets
• Tasbih, Tahmid, Takbir (33x each)
• Istighfar (100x), Salawat (10x)
• Custom dhikr and count
• Progress tracking
• Visual progress bar

📅 Islamic Calendar

• Hijri date display in status bar
• Gregorian to Hijri conversion
• Islamic holidays and events
• Quick calendar view

🧭 Qibla Direction

• Calculate Qibla direction from your location
• Shows compass bearing and direction
• Works with your configured location

📊 Smart Status Bar

• Shows countdown to next prayer
• Displays current Hijri date
• Murattal player controls
• Worship mode status
• One-click access to all features

💚 Islamic Motivation

• Qur'anic verses with translations
• Optional dhikr reminders
• Custom motivational messages
• Always respectful, never judgmental

🌙 Special Modes

• Friday Mode: Jumuah reminder with special notification
• Ramadan Mode: Iftar countdown, Sahur reminder, adjusted notifications
• Productivity Integration: Prayer breaks as Pomodoro breaks

Installation & Setup

Quick Start

1. Install from VSIX:

   • Download the latest release
   • In VS Code: Extensions → ... → Install from VSIX

2. Configure Your Location:

   • Open settings and search "Iman Dev"
   • Set your city, country, or exact coordinates
   • Choose your preferred calculation method

3. Start Coding with Faith:

   • Prayer times load automatically
   • Optional: Enable Murattal player
   • Optional: Enable random Quran verse on startup

Local Development

1. Install dependencies:

   npm install
   

2. Compile TypeScript:

   npm run compile
   

3. Test the extension:

   • Press F5 in VS Code to open Extension Development Host

Building for Distribution

npm install -g @vscode/vsce
vsce package

Configuration

Open VS Code Settings (Ctrl+,) and search for "Iman Dev":

Location Settings

• City: Your city name (e.g., "Jakarta")
• Country: Your country name (e.g., "Indonesia")
• Latitude/Longitude: For precise calculation

Prayer Settings

• Enable/disable reminders for each prayer
• Calculation method selection
• Jumuah reminder
• Break duration (5-60 minutes)

Murattal Settings

• Enable Murattal: Background Quran player
• Reciter: Choose from 7 world-class reciters
• Volume: 0.0 to 1.0
• Auto-play: Start playing on VS Code launch

Quran Settings

• Show on Startup: Random verse when opening VS Code
• Translation: Indonesian, English (Sahih/Pickthall), Urdu

Adzan Settings

• Enable Adzan: Play adzan at prayer times
• Volume: 0.0 to 1.0

Additional Settings

• Language Style: Casual, Neutral, or Polite
• Dhikr Reminders: Show during breaks
• Hijri Calendar: Display in status bar
• Ramadan Mode: Special notifications
• Pomodoro Integration: Sync with productivity timers

Commands

Access via Command Palette (Ctrl+Shift+P):

Prayer Commands

• Iman Dev: Pause Prayer Reminders
• Iman Dev: Resume Prayer Reminders
• Iman Dev: Toggle Silent Mode

Murattal Commands

• Iman Dev: Play Murattal
• Iman Dev: Pause Murattal
• Iman Dev: Next Surah
• Iman Dev: Previous Surah
• Iman Dev: Select Reciter

Quran Commands

• Iman Dev: Show Random Quran Verse
• Iman Dev: Search Quran

Other Commands

• Iman Dev: Open Dhikr Counter
• Iman Dev: Show Islamic Date
• Iman Dev: Show Qibla Direction
• Iman Dev: Open Settings

Usage Examples

Daily Workflow

Morning (Fajr):

1. Start VS Code
2. Read random Quran verse
3. Get Fajr reminder with adzan
4. Auto-save and take prayer break
5. Return to coding

While Coding:

1. Enable Murattal player for peaceful background
2. Status bar shows next prayer countdown
3. Check Hijri date anytime
4. Use Dhikr counter during short breaks

Friday:

1. Get special Jumuah reminder at 11:30 AM
2. Prepare for Friday prayer
3. Extension respects your worship time

Murattal Player Usage

1. Click Murattal icon in status bar
2. Or use Command Palette: "Iman Dev: Play Murattal"
3. Control playback:
   • Click icon to pause/play
   • Next/Previous surah commands
   • Change reciter anytime
4. Adjust volume in settings

Quran Study

Random Verse:

• Shows automatically on startup (if enabled)
• Or run: "Iman Dev: Show Random Quran Verse"
• Read Arabic + translation
• Click "Next Verse" for another

Search Quran:

• Run: "Iman Dev: Search Quran"
• Enter keyword (e.g., "patience", "sabr")
• Browse results
• Click to read full verse

Dhikr Counter

1. Run: "Iman Dev: Open Dhikr Counter"
2. Select preset (Tasbih, Tahmid, Takbir, Istighfar, Salawat)
3. Or create custom dhikr
4. Click "Count (+1)" or "Add 10"
5. Track progress with visual bar
6. Get completion notification

API Integration

Iman Dev uses free, open-source Islamic APIs:

• Aladhan API (aladhan.com): Prayer times, Islamic calendar
• AlQuran Cloud API (alquran.cloud): Quran text, translations, audio
• Islamic Network CDN: High-quality Murattal audio

All APIs are:

• Free and open-source
• No authentication required
• No rate limits for personal use
• Reliable and fast

Privacy & Ethics

✅ Zero tracking or analytics
✅ No worship statistics
✅ No gamification of ibadah
✅ All data local (prayers, dhikr count)
✅ Only internet for API calls
✅ Completely respectful and non-judgmental
✅ Open source and transparent

Technical Details

• Built with TypeScript & VS Code Extension API
• Real-time API integration with Aladhan & AlQuran Cloud
• Offline-capable with graceful degradation
• Lightweight and performant
• No bundled audio files (streams from CDN)
• Minimal dependencies

Why Iman Dev?

For Muslim Developers Who Want To:

• Never miss prayers while deep in code
• Listen to Quran for peace and focus
• Quick access to Quran and Islamic tools
• Integrate faith into daily workflow
• Maintain productivity with spirituality

What Makes It Different:

• All-in-one Islamic productivity suite
• Real-time API integration (always accurate)
• Professional-grade Murattal player
• Comprehensive Quran study tools
• Beautiful, respectful UI
• Made by Muslims, for Muslims

Keyboard Shortcuts (Suggested)

You can add custom keybindings in VS Code:

{
  "key": "ctrl+shift+m",
  "command": "imanDev.murattal.play"
},
{
  "key": "ctrl+shift+q",
  "command": "imanDev.quran.randomVerse"
},
{
  "key": "ctrl+shift+d",
  "command": "imanDev.dhikr.counter"
}

Troubleshooting

Prayer times not showing?

• Check your internet connection (needs API access)
• Verify location settings are correct
• Try different calculation method

Murattal not playing?

• Check internet connection (streams audio)
• Verify volume settings
• Try different reciter

Quran search not working?

• Check internet connection
• Try simpler search terms
• Use different translation

Contributing

Contributions welcome! Please maintain:

• Respectful, non-judgmental tone
• Islamic values and ethics first
• Privacy and user respect
• No gamification of worship
• Clean, documented code

Roadmap

Planned features:

• Qiyam al-Layl (tahajjud) reminder
• Duas collection
• Asmaul Husna
• More reciters and translations
• Offline mode improvements
• Mobile sync (future)

License

MIT License - Free to use, modify, and distribute.

Credits

• APIs: Aladhan.com, AlQuran.cloud
• Reciters: Mishary Alafasy, Abdul Basit, Sudais, and others
• Community: All Muslim developers worldwide

Support & Feedback

Found a bug? Have a suggestion? Want a feature? Create an issue on GitHub or reach out to the community.

May Allah accept this humble effort and make it beneficial for Muslim developers everywhere.

Iman Dev - Code with Faith, Focus with Peace

"Indeed, prayer prohibits immorality and wrongdoing." (QS. Al-Ankabut: 45)