jomsolat

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