🕌 PlayOuran - Modern Quran Reading App for macOS

🌙 A modern Quran reading application for macOS with French interface. Built with Electron for a native desktop experience.

📖 Interface en Français - Designed for French-speaking Muslims 🇫🇷

Keywords: quran app, islamic software, quran reader, french islamic app, lecteur coran, logiciel islamique

✨ Current Features

📖 Quran Reading Experience

• 🎨 Arabic Typography - Clean fonts for Quranic text reading
• 📑 Surah Navigation - Browse through different chapters
• 📱 Responsive Interface - Adapts to window size
• 🌐 French Interface - Complete interface in French language

🕌 Islamic Utilities

• ⏰ Prayer Times - Basic prayer time display
• 🧭 Qibla Direction - Simple compass feature
• 📅 Islamic Calendar - Basic Hijri date display
• 🌙 Islamic Themes - Light and dark modes

🌟 Desktop Experience

• 🍎 Native macOS - Optimized for macOS
• ⚡ Fast Performance - Built with Electron
• 🔒 Privacy-Focused - No data tracking

🖼️ Screenshots

Interface Principale - Lecture du Coran

Sélection des Sourates

Heures de Prière et Méteo

Interface Complète de l'Application

📥 Download & Installation

System Requirements

• macOS 10.15 (Catalina) or later
• Intel or Apple Silicon (M1/M2/M3) processor
• 300 MB free disk space

Installation Steps

1. Download PlayOuran-1.5.0-Universal.dmg from Releases
2. Open the DMG file
3. Drag PlayOuran to your Applications folder
4. Launch from Applications or Spotlight

Note: On first launch, right-click → "Open" to allow the application.

🛠️ Technology Stack

Frontend	Platform	APIs

Core Technologies

• Electron - Cross-platform desktop framework
• Node.js - JavaScript runtime
• HTML5, CSS3, ES6+ - Modern web technologies
• French Localization - Complete French interface

External APIs

• Prayer Times API - For accurate prayer calculations
• Islamic Calendar API - For Hijri date conversion
• Quran Text API - For Quranic content

🏗️ Development Setup

# Clone the repository
git clone https://github.com/yani2298/PlayOuran.git
cd PlayOuran

# Install dependencies
npm install

# Start development server
npm start

# Build for macOS
npm run build:mac

Project Structure

PlayOuran/
├── 📁 assets/           # Images, icons, and media files
├── 📁 scripts/          # Build and deployment scripts
├── 📄 main.js           # Electron main process
├── 📄 renderer.js       # Application logic and UI
├── 📄 index.html        # Main application HTML
├── 📄 style.css         # Styling and themes
└── 📄 package.json      # Dependencies and scripts

🤝 Contributing

We welcome contributions from the Muslim developer community!

Ways to Contribute

• 🐛 Bug Reports - Create Issue
• 💡 Feature Requests - Suggest Enhancement
• 🔧 Code Contributions - Submit pull requests
• 🌐 Translations - Help with Arabic translations
• 📖 Documentation - Improve guides and docs

Development Guidelines

1. Fork the repository
2. Create a feature branch: git checkout -b feature/prayer-enhancement
3. Make your changes following coding standards
4. Test on macOS
5. Commit: git commit -m "feat: add new prayer calculation"
6. Push: git push origin feature/prayer-enhancement
7. Open a Pull Request

📱 Community & Support

• GitHub Issues: Report bugs and request features
• Discussions: Community Q&A

🌟 Roadmap

Planned Features

• Audio Recitations - Add Quran audio playback
• Additional Languages - Arabic interface option
• Windows/Linux Support - Cross-platform versions
• Enhanced Prayer Times - More calculation methods
• Hadith Integration - Daily hadith feature
• Export Features - Save and share verses

📄 License

This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 - see the LICENSE file for details.

📋 What You CAN Do

• ✅ Personal use - Use for your own spiritual practice
• ✅ Educational use - Use in schools, mosques, Islamic centers
• ✅ Modify and share - Adapt the software and share improvements
• ✅ Community projects - Use in non-profit Islamic initiatives

❌ What You CANNOT Do

• ❌ Commercial use - Selling or using for profit is STRICTLY PROHIBITED
• ❌ Paid distribution - Cannot include in paid software packages
• ❌ Revenue generation - Cannot use to make money in any form
• ❌ Commercial apps - Cannot integrate into commercial products

🕌 Islamic Principles

This software is developed as Sadaqah (charity) for the Muslim Ummah. Commercial exploitation goes against the charitable spirit of this project.

🙏 Acknowledgments

"And We made from them leaders guiding by Our command when they were patient and were certain of Our signs."

— Quran 32:24

Special Thanks

• 📖 The Noble Quran - Our ultimate source of guidance
• 🕌 Islamic API Providers - For reliable Islamic content
• 👥 French Muslim Community - For feedback and support
• 🤝 All Contributors - Every contribution matters

Support the Project

This project is developed as Sadaqah (charity) for the Muslim Ummah. Your duas and stars are appreciated.

---

📊 Project Statistics

---

🌙 PlayOuran - Interface en Français pour les Musulmans 🌙

Made with ❤️ for the French-speaking Muslim community

---

🏷️ Keywords for Discovery

Quran app • Islamic software • Muslim app • French Islamic app • Lecteur Coran • Logiciel islamique • Prayer times • Heures de prière • Islamic desktop • macOS Quran • Electron Islamic app • Open source Islamic software

---

⭐ Star this repository to support French Islamic software development ⭐

"The best of people are those who benefit humanity" - Prophet Muhammad ﷺ