Skip to content
 
 

Repository files navigation

Salaty – Beautiful Islamic Prayer Times Desktop App

A beautiful, lightweight, always-on-top Electron.js desktop app that shows accurate Islamic prayer times with a modern glassmorphism design and 11 stunning themes.

Made with love for the Muslim Ummah


Features

  • ⏰ Accurate prayer times powered by Aladhan.com API
  • 🎨 11 hand-crafted themes
    Navy • Green • Brown • Gold • Pink • Purple • Emerald • Ocean • Royal • Indigo • Classic
  • 🕒 Live countdown to next prayer
  • ✨ Current & next prayer highlight
  • 📅 Hijri + Gregorian date
  • 🖥️ Always on top & frameless window
  • 💾 Remembers city, country, theme, and window position
  • 🪟 Glassmorphism UI with smooth animations
  • 🌐 Offline capable after first load
  • 💻 Cross-platform: Windows • macOS • Linux
Home (Navy Theme) Settings Royal Theme

Quick Start

Prerequisites

  • Node.js ≥ 14
  • npm or yarn

Run locally

git clone https://github.com/yassindaboussi/Salaty.git
cd Salaty
npm install
npm start

Build for your platform

npm run build    # Build for current platform
npm run dist     # Create distributables

How To Use

  • First Launch 🆕: App opens with default location (Tunis, Tunisia)
  • Change Location 📍: Click the ⚙️ settings gear → Enter your city and country
  • Select Theme 🎨: Choose from 11 color themes in settings
  • View Prayers 🕌: All five daily prayers, current prayer highlighted
  • Countdown ⏳: Real-time countdown to next prayer

Technical Details

Built With

  • Electron – Cross-platform desktop framework
  • HTML/CSS/JavaScript – Frontend technologies
  • Aladhan API – Accurate prayer times calculation
  • Font Awesome – Beautiful icons

API Integration
Uses Aladhan API for precise prayer times based on:

  • 🗺️ Geographic location (city/country)
  • 📅 Current date
  • 📿 Islamic calendar dates

Key Features

  • Frameless Window 🪟 – Custom title bar with minimize/close controls
  • Auto-refresh 🔄 – Updates prayer times hourly
  • Error Handling 🛡️ – Graceful network error management
  • Responsive Design 📱 – Adapts to different screen sizes

Theme Preview

Theme Color & Style
🟦 Navy Deep Blue, Professional
🟩 Green Natural Green, Calming
🟫 Brown Earthy Brown, Traditional
🟨 Gold Rich Gold, Elegant
🟥 Pink Vibrant Pink, Modern
🟪 Purple Royal Purple, Regal
🟦 Emerald Sophisticated Teal, Refined
🌊 Ocean Fresh Blue, Clean
👑 Royal Classic Blue, Timeless
🟦 Indigo Deep Indigo, Night
⚫ Classic Minimal Dark, Simple

Contributing

Contributions are very welcome!
Whether it's a new theme, better calculation method, adhan playback, widgets, or translations – everything helps the Ummah.

Steps to contribute:

  1. Fork the repo
  2. Create your feature branch (git checkout -b feature/amazing-idea)
  3. Commit your changes (git commit -m 'Add amazing idea')
  4. Push to the branch (git push origin feature/amazing-idea)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.


Acknowledgments

About

Modern 🖥️ desktop prayer 🕌 times app with beautiful 🌸 themes 🎨 & live⏳countdown 📿

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages