JomSolat - Simple Prayer Times CLI

A simple and minimalist command-line tool to display today's prayer times for Malaysia.

Made by Kebalicious

Installation

Option 1: NPX (Recommended)

npx jomsolat <zone>

Option 2: Global Installation

npm install -g jomsolat

Option 3: Simple Version (No Dependencies)

If you don't have npm or want a simpler version:

# Download the files and run directly
node jomsolat-simple.js <zone>

# Or on Windows
jomsolat.bat <zone>

# Or on Unix/Linux/Mac
chmod +x jomsolat.sh
./jomsolat.sh <zone>

Quick Start

# Get prayer times for Kuala Lumpur
npx jomsolat WLY01

# Show help and all available zones
npx jomsolat help

# Case insensitive - both work the same
npx jomsolat sgr01
npx jomsolat SGR01

Usage

Get prayer times for a specific zone:

jomsolat WLY01

Show help and available zones:

jomsolat help

Case insensitive zone codes:

jomsolat sgr01    # Same as SGR01
jomsolat WLY01    # Same as wly01

Available Zones

| Code | Location | |-------|----------| | WLY01 | Wilayah Persekutuan Kuala Lumpur | | WLY02 | Wilayah Persekutuan Labuan | | WLY03 | Wilayah Persekutuan Putrajaya | | SGR01 | Shah Alam, Selangor | | SGR02 | Petaling Jaya, Selangor | | SGR03 | Klang, Selangor | | JHR01 | Johor Bahru, Johor | | JHR02 | Kota Tinggi, Johor | | JHR03 | Kluang, Johor | | KDH01 | Kota Bharu, Kelantan | | KDH02 | Pasir Mas, Kelantan | | KDH03 | Kuala Krai, Kelantan | | KTN01 | Kuala Terengganu, Terengganu | | KTN02 | Kemaman, Terengganu | | KTN03 | Dungun, Terengganu | | PRK01 | Ipoh, Perak | | PRK02 | Taiping, Perak | | PRK03 | Teluk Intan, Perak | | PLS01 | Kangar, Perlis | | PNG01 | George Town, Pulau Pinang | | PNG02 | Butterworth, Pulau Pinang | | NSN01 | Seremban, Negeri Sembilan | | NSN02 | Port Dickson, Negeri Sembilan | | MLK01 | Melaka Tengah, Melaka | | SBH01 | Kota Kinabalu, Sabah | | SBH02 | Sandakan, Sabah | | SBH03 | Tawau, Sabah | | SWK01 | Kuching, Sarawak | | SWK02 | Sibu, Sarawak | | SWK03 | Miri, Sarawak |

Example Output

🕌 Waktu Solat Hari Ini
════════════════════════════════════════
📅 Friday, 26 September 2025
📍 Shah Alam, Selangor (SGR01)
────────────────────────────────────────
🌅 Subuh    : 05:45
☀️  Syuruk   : 07:00
☀️  Zohor    : 13:15
🌤️  Asar     : 16:30
🌅 Maghrib  : 19:15
🌙 Isyak    : 20:30
────────────────────────────────────────
ℹ️  Approximate times - please verify with local mosque

Features

• ✅ Simple and minimalist design
• ✅ Support for all Malaysian prayer time zones
• ✅ Beautiful emoji-based output
• ✅ Case insensitive zone codes (SGR01 or sgr01)
• ✅ Made by Kebalicious
• ✅ Fallback prayer times when API is unavailable
• ✅ Zone validation and error handling
• ✅ No external dependencies required for basic functionality

Requirements

• Node.js 14.0.0 or higher
• Internet connection (for real-time prayer times)

License

MIT