تلاوة — Tilawa

Daily Quran Ayah Desktop App

A beautiful Electron desktop app that displays random Quran Ayahs (verses) in Arabic with English translation, rotating every 2 minutes. Sends a daily notification at 8:00 AM.

---

Features

• 📖 Arabic text — Uthmani script via quran-uthmani edition
• 🌍 English translation — Muhammad Asad's translation
• 🔄 Auto-rotation — New random Ayah every 2 minutes
• 🔔 Daily 8AM notification — A fresh Ayah to start your morning
• 🖥️ System tray — Lives quietly in your menu bar / taskbar
• 🎨 Islamic-inspired UI — Dark parchment, gold accents, Amiri Arabic font
• ✅ macOS, Windows, Linux

---

Quick Start

# 1. Install dependencies
npm install

# 2. Run in development
npm start

---

Build for Distribution

# macOS (DMG)
npm run build:mac

# Windows (NSIS installer)
npm run build:win

# Linux (AppImage + DEB)
npm run build:linux

# All platforms
npm run build:all

Builds output to dist/ folder.

---

API Used

alquran.cloud — Free, no API key, no rate limits
Endpoint: https://api.alquran.cloud/v1/ayah/{number}/editions/quran-uthmani,en.asad

• quran-uthmani → Uthmani Arabic script
• en.asad → Muhammad Asad English translation
• 6,236 total Ayahs across 114 Surahs

---

Window Controls

Button	Action
🔴 Red	Quit Tilawa
🟡 Yellow	Minimise window
🟢 Green	Hide to tray

Right-click the tray icon for options:

• Open Tilawa
• New Ayah Now
• Quit

---

Project Structure

tilawa/
├── src/
│   ├── main.js         ← Electron main process
│   ├── preload.js      ← Secure IPC bridge
│   └── renderer.html   ← UI (HTML/CSS/JS)
├── assets/
│   └── icon.png        ← App icon (add your own)
├── package.json
└── README.md

---

Built with Electron · alquran.cloud API · Amiri font
by Nwamini Emmanuel O.