{"id":41328584,"url":"https://github.com/yani2298/PlayOuran","last_synced_at":"2026-02-24T23:00:48.789Z","repository":{"id":307325015,"uuid":"1029139307","full_name":"yani2298/PlayOuran","owner":"yani2298","description":"🕌 Modern Quran reading app with prayer times, hadith, and Islamic utilities for desktop. Cross-platform Islamic software for Muslims worldwide.","archived":false,"fork":false,"pushed_at":"2026-02-17T05:13:02.000Z","size":6226,"stargazers_count":8,"open_issues_count":0,"forks_count":2,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-17T11:09:36.147Z","etag":null,"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"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yani2298.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-07-30T15:23:57.000Z","updated_at":"2026-02-17T05:13:05.000Z","dependencies_parsed_at":"2025-07-30T18:33:30.137Z","dependency_job_id":null,"html_url":"https://github.com/yani2298/PlayOuran","commit_stats":null,"previous_names":["yani2298/playouran"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/yani2298/PlayOuran","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yani2298%2FPlayOuran","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yani2298%2FPlayOuran/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yani2298%2FPlayOuran/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yani2298%2FPlayOuran/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yani2298","download_url":"https://codeload.github.com/yani2298/PlayOuran/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yani2298%2FPlayOuran/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29804138,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-24T22:43:48.403Z","status":"ssl_error","status_checked_at":"2026-02-24T22:43:18.536Z","response_time":75,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["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"],"created_at":"2026-01-23T06:11:49.933Z","updated_at":"2026-02-24T23:00:48.784Z","avatar_url":"https://github.com/yani2298.png","language":"JavaScript","funding_links":[],"categories":["Other (122 projects)"],"sub_categories":["JavaScript"],"readme":"# 🕌 PlayOuran - Modern Quran Reading App for macOS\n\n[![GitHub release](https://img.shields.io/github/v/release/yani2298/PlayOuran?style=for-the-badge\u0026logo=github)](https://github.com/yani2298/PlayOuran/releases)\n[![License CC BY-NC-SA](https://img.shields.io/badge/License-CC%20BY--NC--SA%204.0-red?style=for-the-badge)](LICENSE)\n[![macOS Support](https://img.shields.io/badge/Platform-macOS-blue?style=for-the-badge\u0026logo=apple)](https://www.apple.com/macos/)\n[![Built with Electron](https://img.shields.io/badge/Built%20with-Electron-47848f?style=for-the-badge\u0026logo=electron)](https://electronjs.org/)\n[![French Interface](https://img.shields.io/badge/Interface-Français-blue?style=for-the-badge)](https://fr.wikipedia.org/wiki/Français)\n\n\u003e **🌙 A modern Quran reading application for macOS with French interface. Built with Electron for a native desktop experience.**\n\n\u003cdiv align=\"center\"\u003e\n\n### 📖 **Interface en Français - Designed for French-speaking Muslims** 🇫🇷\n\n**Keywords**: *quran app, islamic software, quran reader, french islamic app, lecteur coran, logiciel islamique*\n\n\u003c/div\u003e\n\u003cimg width=\"1489\" height=\"966\" alt=\"CleanShot 2025-07-30 at 16 54 12\" src=\"https://github.com/user-attachments/assets/491c00e9-5a5f-4567-9962-ccbbbcb42754\" /\u003e\n\u003cimg width=\"1489\" height=\"966\" alt=\"CleanShot 2025-07-30 at 16 54 18\" src=\"https://github.com/user-attachments/assets/308d5911-4550-4f10-b404-cf256ee4677a\" /\u003e\n\u003cimg width=\"1489\" height=\"966\" alt=\"CleanShot 2025-07-30 at 16 54 25\" src=\"https://github.com/user-attachments/assets/e249d390-e647-43d7-ae47-de2f385fc593\" /\u003e\n\u003cimg width=\"1489\" height=\"966\" alt=\"CleanShot 2025-07-30 at 16 54 31\" src=\"https://github.com/user-attachments/assets/8262c73c-2a3b-4759-8a40-85ffeba2af4e\" /\u003e\n\n\n\n## ✨ Current Features\n\n### 📖 **Quran Reading Experience**\n- 🎨 **Arabic Typography** - Clean fonts for Quranic text reading\n- 📑 **Surah Navigation** - Browse through different chapters\n- 📱 **Responsive Interface** - Adapts to window size\n- 🌐 **French Interface** - Complete interface in French language\n\n### 🕌 **Islamic Utilities**\n- ⏰ **Prayer Times** - Basic prayer time display\n- 🧭 **Qibla Direction** - Simple compass feature\n- 📅 **Islamic Calendar** - Basic Hijri date display\n- 🌙 **Islamic Themes** - Light and dark modes\n\n### 🌟 **Desktop Experience**\n- 🍎 **Native macOS** - Optimized for macOS\n- ⚡ **Fast Performance** - Built with Electron\n- 🔒 **Privacy-Focused** - No data tracking\n\n## 🖼️ Screenshots\n\n\u003cdiv align=\"center\"\u003e\n\n### **Interface Principale - Lecture du Coran**\n\u003cimg width=\"1489\" height=\"966\" alt=\"PlayOuran - Interface de lecture du Coran\" src=\"https://github.com/user-attachments/assets/ee74d0bf-ff9d-4e09-a8b6-7e5c035598ee\" /\u003e\n\n### **Sélection des Sourates**\n\u003cimg width=\"1489\" height=\"966\" alt=\"PlayOuran - Sélection des sourates\" src=\"https://github.com/user-attachments/assets/364eb8c6-a337-4d06-99a3-d90ebc20319d\" /\u003e\n\n### **Heures de Prière et Méteo**\n\u003cimg width=\"1489\" height=\"966\" alt=\"PlayOuran - Heures de prière\" src=\"https://github.com/user-attachments/assets/9d46f3c1-1a29-49ef-afe0-a799390e4558\" /\u003e\n\n### **Interface Complète de l'Application**\n\u003cimg width=\"1489\" height=\"966\" alt=\"PlayOuran - Vue d'ensemble\" src=\"https://github.com/user-attachments/assets/f981d9f6-edc4-4a92-8e94-1c854117aeee\" /\u003e\n\n\u003c/div\u003e\n\n## 📥 Download \u0026 Installation\n\n### **System Requirements**\n- **macOS 10.15** (Catalina) or later\n- **Intel** or **Apple Silicon** (M1/M2/M3) processor\n- **300 MB** free disk space\n\n### **Installation Steps**\n1. Download `PlayOuran-1.5.0-Universal.dmg` from [Releases](https://github.com/yani2298/PlayOuran/releases/latest)\n2. Open the DMG file\n3. Drag **PlayOuran** to your Applications folder\n4. Launch from Applications or Spotlight\n\n\u003e **Note**: On first launch, right-click → \"Open\" to allow the application.\n\n## 🛠️ **Technology Stack**\n\n\u003cdiv align=\"center\"\u003e\n\n| **Frontend** | **Platform** | **APIs** |\n|-------------|-------------|----------|\n| ![Electron](https://img.shields.io/badge/Electron-47848f?style=for-the-badge\u0026logo=electron) | ![macOS](https://img.shields.io/badge/macOS-000000?style=for-the-badge\u0026logo=apple) | ![APIs](https://img.shields.io/badge/Islamic%20APIs-green?style=for-the-badge) |\n| ![HTML5](https://img.shields.io/badge/HTML5-E34F26?style=for-the-badge\u0026logo=html5\u0026logoColor=white) | ![JavaScript](https://img.shields.io/badge/JavaScript-F7DF1E?style=for-the-badge\u0026logo=javascript\u0026logoColor=black) | ![REST](https://img.shields.io/badge/REST%20APIs-blue?style=for-the-badge) |\n\n\u003c/div\u003e\n\n### **Core Technologies**\n- **[Electron](https://electronjs.org/)** - Cross-platform desktop framework\n- **[Node.js](https://nodejs.org/)** - JavaScript runtime\n- **HTML5, CSS3, ES6+** - Modern web technologies\n- **French Localization** - Complete French interface\n\n### **External APIs**\n- **Prayer Times API** - For accurate prayer calculations\n- **Islamic Calendar API** - For Hijri date conversion\n- **Quran Text API** - For Quranic content\n\n## 🏗️ **Development Setup**\n\n```bash\n# Clone the repository\ngit clone https://github.com/yani2298/PlayOuran.git\ncd PlayOuran\n\n# Install dependencies\nnpm install\n\n# Start development server\nnpm start\n\n# Build for macOS\nnpm run build:mac\n```\n\n### **Project Structure**\n```\nPlayOuran/\n├── 📁 assets/           # Images, icons, and media files\n├── 📁 scripts/          # Build and deployment scripts\n├── 📄 main.js           # Electron main process\n├── 📄 renderer.js       # Application logic and UI\n├── 📄 index.html        # Main application HTML\n├── 📄 style.css         # Styling and themes\n└── 📄 package.json      # Dependencies and scripts\n```\n\n## 🤝 **Contributing**\n\nWe welcome contributions from the Muslim developer community!\n\n### **Ways to Contribute**\n- 🐛 **Bug Reports** - [Create Issue](https://github.com/yani2298/PlayOuran/issues/new?template=bug_report.md)\n- 💡 **Feature Requests** - [Suggest Enhancement](https://github.com/yani2298/PlayOuran/issues/new?template=feature_request.md)\n- 🔧 **Code Contributions** - Submit pull requests\n- 🌐 **Translations** - Help with Arabic translations\n- 📖 **Documentation** - Improve guides and docs\n\n### **Development Guidelines**\n1. Fork the repository\n2. Create a feature branch: `git checkout -b feature/prayer-enhancement`\n3. Make your changes following coding standards\n4. Test on macOS\n5. Commit: `git commit -m \"feat: add new prayer calculation\"`\n6. Push: `git push origin feature/prayer-enhancement`\n7. Open a Pull Request\n\n## 📱 **Community \u0026 Support**\n\n- **GitHub Issues**: [Report bugs and request features](https://github.com/yani2298/PlayOuran/issues)\n- **Discussions**: [Community Q\u0026A](https://github.com/yani2298/PlayOuran/discussions)\n\n## 🌟 **Roadmap**\n\n### **Planned Features**\n- [ ] **Audio Recitations** - Add Quran audio playback\n- [ ] **Additional Languages** - Arabic interface option\n- [ ] **Windows/Linux Support** - Cross-platform versions\n- [ ] **Enhanced Prayer Times** - More calculation methods\n- [ ] **Hadith Integration** - Daily hadith feature\n- [ ] **Export Features** - Save and share verses\n\n## 📄 **License**\n\nThis project is licensed under the **Creative Commons Attribution-NonCommercial-ShareAlike 4.0** - see the [LICENSE](LICENSE) file for details.\n\n### **📋 What You CAN Do**\n- ✅ **Personal use** - Use for your own spiritual practice\n- ✅ **Educational use** - Use in schools, mosques, Islamic centers\n- ✅ **Modify and share** - Adapt the software and share improvements\n- ✅ **Community projects** - Use in non-profit Islamic initiatives\n\n### **❌ What You CANNOT Do**\n- ❌ **Commercial use** - Selling or using for profit is STRICTLY PROHIBITED\n- ❌ **Paid distribution** - Cannot include in paid software packages\n- ❌ **Revenue generation** - Cannot use to make money in any form\n- ❌ **Commercial apps** - Cannot integrate into commercial products\n\n### **🕌 Islamic Principles**\nThis software is developed as **Sadaqah (charity)** for the Muslim Ummah. Commercial exploitation goes against the charitable spirit of this project.\n\n## 🙏 **Acknowledgments**\n\n\u003cdiv align=\"center\"\u003e\n\n### **\"And We made from them leaders guiding by Our command when they were patient and were certain of Our signs.\"**\n*— Quran 32:24*\n\n\u003c/div\u003e\n\n#### **Special Thanks**\n- **📖 The Noble Quran** - Our ultimate source of guidance\n- **🕌 Islamic API Providers** - For reliable Islamic content\n- **👥 French Muslim Community** - For feedback and support\n- **🤝 All Contributors** - Every contribution matters\n\n#### **Support the Project**\n*This project is developed as Sadaqah (charity) for the Muslim Ummah. Your duas and stars are appreciated.*\n\n---\n\n## 📊 **Project Statistics**\n\n\u003cdiv align=\"center\"\u003e\n\n![GitHub stars](https://img.shields.io/github/stars/yani2298/PlayOuran?style=for-the-badge\u0026logo=github\u0026color=yellow)\n![GitHub forks](https://img.shields.io/github/forks/yani2298/PlayOuran?style=for-the-badge\u0026logo=github\u0026color=blue)\n![GitHub downloads](https://img.shields.io/github/downloads/yani2298/PlayOuran/total?style=for-the-badge\u0026color=purple)\n\n![GitHub last commit](https://img.shields.io/github/last-commit/yani2298/PlayOuran?style=for-the-badge)\n![GitHub issues](https://img.shields.io/github/issues/yani2298/PlayOuran?style=for-the-badge)\n\n\u003c/div\u003e\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌙 **PlayOuran - Interface en Français pour les Musulmans** 🌙\n\n**Made with ❤️ for the French-speaking Muslim community**\n\n[![Download](https://img.shields.io/badge/📱%20Download-Latest%20Release-green?style=for-the-badge)](https://github.com/yani2298/PlayOuran/releases)\n[![Documentation](https://img.shields.io/badge/📚%20Docs-User%20Guide-orange?style=for-the-badge)](https://github.com/yani2298/PlayOuran#readme)\n[![Community](https://img.shields.io/badge/💬%20Community-Discussions-purple?style=for-the-badge)](https://github.com/yani2298/PlayOuran/discussions)\n\n---\n\n### 🏷️ **Keywords for Discovery**\n\n**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**\n\n---\n\n**⭐ Star this repository to support French Islamic software development ⭐**\n\n*\"The best of people are those who benefit humanity\"* - Prophet Muhammad ﷺ\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyani2298%2FPlayOuran","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyani2298%2FPlayOuran","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyani2298%2FPlayOuran/lists"}