Professional macOS menu bar application for Islamic prayer times
Discreet, accurate, and beautiful prayer times in your macOS menu bar
Download Latest Release โข View Documentation โข Report Issue
Salat Now is a professional macOS menu bar application designed for Muslim professionals who need quick, discreet access to accurate prayer times without leaving their workflow.
Built specifically for macOS, it integrates seamlessly into your menu bar, providing prayer times, weather information, and Hijri calendar data at a glance.
- ๐ฅ๏ธ Native macOS Menu Bar Integration - Quick access without interrupting your work
- ๐ฐ๏ธ Accurate Prayer Times - Multiple calculation methods (ISNA, MWL, Karachi, etc.)
- ๐ Global Location Support - Automatic city detection or manual selection
- ๐ค๏ธ Weather Integration - Current conditions alongside prayer times
- ๐ Hijri Calendar - Islamic date display with important events
- ๐ Smart Notifications - Customizable prayer reminders
- โ๏ธ Professional Interface - Clean, minimal design that respects your workflow
- ๐ Privacy First - No data collection, works offline
- ๐ Completely Free - No subscriptions, no ads, open source
- Download the latest release from GitHub Releases
- Unzip the downloaded file
- Move
Salat Now.appto your/Applicationsfolder - Launch the app - it will appear in your menu bar
- Grant location permission for automatic prayer times (optional)
- macOS 10.15 (Catalina) or later
- Location Services (optional, for automatic city detection)
The prayer calculation engine is also available as a standalone npm package for developers building Islamic applications.
# Public npm registry
npm install salat-times-calculator
# GitHub Package Registry
npm install @yani2298/salat-times-calculatorimport { SalatTimesCalculator, CalculationMethod } from 'salat-times-calculator';
const calculator = new SalatTimesCalculator();
// Get prayer times for any city
const prayerTimes = await calculator.getPrayerTimes({
city: 'Paris',
country: 'France',
calculationMethod: CalculationMethod.ISNA
});
console.log('Next prayer:', calculator.getCurrentPrayer(prayerTimes));๐ Documentation: View npm package โข View GitHub package
- Node.js 18.0+
- macOS development environment
- Xcode Command Line Tools
# Clone the repository
git clone https://github.com/yani2298/salat-now.git
cd salat-now
# Install dependencies
npm install
# Start development server
npm run electron:dev
# Build for production
npm run electron:buildsalat-now/
โโโ src/ # React application source
โ โโโ components/ # UI components
โ โโโ services/ # Prayer times, weather, location services
โ โโโ types/ # TypeScript definitions
โโโ electron/ # Electron main process
โโโ public/ # Static assets
โโโ build/ # Production builds
Salat Now follows a clean, modular architecture optimized for menu bar applications:
- Frontend: React 19 with TypeScript for type safety and modern UI patterns
- Backend: Electron for native macOS integration and menu bar functionality
- API Integration: Aladhan API for accurate prayer calculations
- State Management: React hooks with local storage persistence
- Styling: Tailwind CSS for consistent, maintainable design
| Category | Technology |
|---|---|
| Framework | Electron + React 19 |
| Language | TypeScript |
| Styling | Tailwind CSS |
| APIs | Aladhan Prayer Times API |
| Build System | Vite |
| Testing | Jest (planned) |
Current Language: French ๐ซ๐ท
Seeking Contributors for translation to:
- Arabic ๐ธ๐ฆ (ุนุฑุจู)
- English ๐บ๐ธ
- Urdu ๐ต๐ฐ (ุงุฑุฏู)
- Indonesian ๐ฎ๐ฉ (Bahasa Indonesia)
- Turkish ๐น๐ท (Tรผrkรงe)
- Malay ๐ฒ๐พ (Bahasa Melayu)
Request Translation โข Translation Guide
We welcome contributions from the global Muslim developer community!
- ๐ Report bugs using our issue templates
- ๐ก Suggest features for improving the user experience
- ๐ Add translations to make the app accessible globally
- ๐ Improve documentation for better developer experience
- ๐ง Submit pull requests for bug fixes or enhancements
- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
Please read our Contributing Guide for detailed information.
This project is licensed under the MIT License - see the LICENSE file for details.
Anis Mosbah (@yani2298)
- Email: contact@salatnow.app
- Building Islamic software for the global ummah
- Aladhan API - Reliable Islamic prayer times calculations
- Islamic Network - Open source Islamic software inspiration
- macOS Developer Community - Menu bar app best practices
- Global Muslim Developers - Feature requests and testing
- English translation completion
- Arabic RTL support implementation
- Advanced notification customization
- Prayer time adjustments UI enhancement
- Multiple location support for travelers
- Qibla direction indicator
- Islamic calendar events integration
- Community prayer times sharing
- iOS companion app for seamless sync
- Widget support for macOS Big Sur+
- Apple Watch complications
- Mosque finder integration
Made with โค๏ธ for the global Muslim community
โญ Star this repository if it helps you in your daily prayers
Report Bug โข Request Feature โข Join Discussion
// Updated: 2025-07-29T19:15:49.072Z
// Updated: 2025-07-29T19:15:51.545Z