https://github.com/yani2298/PlayOuran

🕌 Modern Quran reading app with prayer times, hadith, and Islamic utilities for desktop. Cross-platform Islamic software for Muslims worldwide.
https://github.com/yani2298/PlayOuran

arabic coran desktop-app hadith hadith-api hadiths islam islamic-prayer-times islamic-software islamic-utilities muslim-app muslim-application quran quran-api quran-app quran-audio recitation recitations

Last synced: 4 months ago
JSON representation

🕌 Modern Quran reading app with prayer times, hadith, and Islamic utilities for desktop. Cross-platform Islamic software for Muslims worldwide.

Host: GitHub
URL: https://github.com/yani2298/PlayOuran
Owner: yani2298
License: other
Created: 2025-07-30T15:23:57.000Z (11 months ago)
Default Branch: main
Last Pushed: 2026-02-17T05:13:02.000Z (4 months ago)
Last Synced: 2026-02-17T11:09:36.147Z (4 months ago)
Topics: arabic, coran, desktop-app, hadith, hadith-api, hadiths, islam, islamic-prayer-times, islamic-software, islamic-utilities, muslim-app, muslim-application, quran, quran-api, quran-app, quran-audio, recitation, recitations
Language: JavaScript
Homepage:
Size: 5.94 MB
Stars: 8
Watchers: 0
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md

Awesome Lists containing this project

awesome-islamic-open-source-apps - PlayOuran

README

# 🕌 PlayOuran - Modern Quran Reading App for macOS

[![GitHub release](https://img.shields.io/github/v/release/yani2298/PlayOuran?style=for-the-badge&logo=github)](https://github.com/yani2298/PlayOuran/releases)
[![License CC BY-NC-SA](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-red?style=for-the-badge)](LICENSE)
[![macOS Support](https://img.shields.io/badge/Platform-macOS-blue?style=for-the-badge&logo=apple)](https://www.apple.com/macos/)
[![Built with Electron](https://img.shields.io/badge/Built%20with-Electron-47848f?style=for-the-badge&logo=electron)](https://electronjs.org/)
[![French Interface](https://img.shields.io/badge/Interface-Français-blue?style=for-the-badge)](https://fr.wikipedia.org/wiki/Français)

> **🌙 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**
PlayOuran - Interface de lecture du Coran

### **Sélection des Sourates**
PlayOuran - Sélection des sourates

### **Heures de Prière et Méteo**
PlayOuran - Heures de prière

### **Interface Complète de l'Application**
PlayOuran - Vue d'ensemble

## 📥 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](https://github.com/yani2298/PlayOuran/releases/latest)
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** |
|-------------|-------------|----------|
| ![Electron](https://img.shields.io/badge/Electron-47848f?style=for-the-badge&logo=electron) | ![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge&logo=apple) | ![APIs](https://img.shields.io/badge/Islamic%20APIs-green?style=for-the-badge) |
| ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge&logo=html5&logoColor=white) | ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge&logo=javascript&logoColor=black) | ![REST](https://img.shields.io/badge/REST%20APIs-blue?style=for-the-badge) |

### **Core Technologies**
- **[Electron](https://electronjs.org/)** - Cross-platform desktop framework
- **[Node.js](https://nodejs.org/)** - 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**

```bash
# 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](https://github.com/yani2298/PlayOuran/issues/new?template=bug_report.md)
- 💡 **Feature Requests** - [Suggest Enhancement](https://github.com/yani2298/PlayOuran/issues/new?template=feature_request.md)
- 🔧 **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](https://github.com/yani2298/PlayOuran/issues)
- **Discussions**: [Community Q&A](https://github.com/yani2298/PlayOuran/discussions)

## 🌟 **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](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**

![GitHub stars](https://img.shields.io/github/stars/yani2298/PlayOuran?style=for-the-badge&logo=github&color=yellow)
![GitHub forks](https://img.shields.io/github/forks/yani2298/PlayOuran?style=for-the-badge&logo=github&color=blue)
![GitHub downloads](https://img.shields.io/github/downloads/yani2298/PlayOuran/total?style=for-the-badge&color=purple)

![GitHub last commit](https://img.shields.io/github/last-commit/yani2298/PlayOuran?style=for-the-badge)
![GitHub issues](https://img.shields.io/github/issues/yani2298/PlayOuran?style=for-the-badge)

---

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

**Made with ❤️ for the French-speaking Muslim community**

[![Download](https://img.shields.io/badge/📱%20Download-Latest%20Release-green?style=for-the-badge)](https://github.com/yani2298/PlayOuran/releases)
[![Documentation](https://img.shields.io/badge/📚%20Docs-User%20Guide-orange?style=for-the-badge)](https://github.com/yani2298/PlayOuran#readme)
[![Community](https://img.shields.io/badge/💬%20Community-Discussions-purple?style=for-the-badge)](https://github.com/yani2298/PlayOuran/discussions)

---

### 🏷️ **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 ﷺ

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/yani2298/PlayOuran

Awesome Lists containing this project

README