- name
- islamic-daily-reflection
- version
- 1.0.0
- description
- Daily Islamic reflections with Python script. Provides formatted spiritual guidance with calendar awareness (Ramadan, Jummah, Dhul Hijjah). Authentic Quran/Hadith references and practical daily challenges.
- author
- clinicode
Islamic Daily Reflection
CRITICAL: Always Run the Script
When user requests a reflection, you MUST execute the Python script:
python scripts/reflection.pyDisplay the complete output exactly as returned by the script.
The script provides:
- ✅ Formatted output with ═══ borders
- ✅ Hijri calendar awareness
- ✅ Ramadan/Jummah/Regular reflections
- ✅ Actionable daily challenges
- ✅ Quran/Hadith references
DO NOT generate your own reflection. ALWAYS run the script.
User Commands
Users may ask:
- "daily reflection"
- "islamic reminder"
- "inspire me"
- "motivate me islamically"
- "friday reflection"
- "ramadan reflection"
For ALL of these: run python scripts/reflection.py
Script Output Format
The script returns formatted text like:
═══════════════════════════════════════
📅 Thursday, 13 February 2026 | 25 Sha'ban 1447
🤲 Patience in Small Trials
[Reflection content...]
💡 Today's Action (X min):
[Actionable challenge...]
📖 [Quran/Hadith reference]
═══════════════════════════════════════Display this output exactly as received - preserve all formatting, emojis, and borders.
Technical Details
The script (scripts/reflection.py):
- Detects current date (Gregorian + Hijri)
- Selects appropriate reflection type:
- Ramadan days 1-30 (specific reflections) - Jummah (Friday reflections) - Regular days (30 rotating themes)
- Formats with consistent structure
- No external dependencies (uses stdlib only)
Reflection Themes
Regular days rotate through: Patience, Gratitude, Tawakkul, Taqwa, Ikhlas, Humility, Contentment, Hope, Khashyah, Love for Allah, Brotherhood, Honesty, Justice, Mercy, Forgiveness, Charity, Good Character, Dhikr, Knowledge, Kindness to Parents, Neighbors, Promises, Avoiding Backbiting, Controlling Anger, Thankful in Trials, Dua, Quran Reading, Tahajjud, Fasting, Remembering Death
Special occasions:
- Ramadan (Month 9): Day-specific reflections
- Dhul Hijjah (Month 12, Days 1-10): Hajj themes
- Jummah (Fridays): Friday-specific
- Muharram (Day 10): Ashura
Version
1.0.0 - Python script with pre-written reflections