azaan

Islamic prayer times CLI with automatic location detection

Automatic Everything

Just run azaan — it handles the rest:

• Auto-detects your location via IP (3 fallback providers)
• Auto-recommends calculation method based on your country
• Auto-detects timezone for accurate prayer times
• Auto-highlights current and next prayer with countdown

No configuration needed. Just run and pray.

Install

npx azaan

# Or install globally and update manually
npm install -g azaan
# Then run:
azaan
# To update later:
npm install -g azaan@latest

Usage

# Show today's prayer times (auto-setup on first run)
azaan

# Show next prayer with countdown
azaan next

# Show Qibla direction
azaan qibla

# Show monthly calendar
azaan month

# JSON output for scripting
azaan --json

# Single line for status bars (tmux, polybar, waybar)
azaan --status

# List calculation methods
azaan methods

# Configure settings
azaan config

Output

  AZAAN - Prayer Times CLI

  📍 San Francisco, USA
  🕐 America/Los_Angeles
  📅 01 Feb 2026
  🌙 13 Shaʿbān 1447 AH

  🌅  Fajr       5:59 AM
  ☀️  Sunrise    7:14 AM
  🌞  Dhuhr      12:23 PM
  🌤️  Asr        3:12 PM ← current
  🌇  Maghrib    5:34 PM ← next in 24m
  🌙  Isha       6:48 PM

Commands

| Command | Description | |---------|-------------| | azaan | Today's prayer times | | azaan next | Next prayer with countdown | | azaan qibla | Qibla direction from your location | | azaan month | Monthly prayer calendar | | azaan methods | List calculation methods | | azaan config | Configure settings | | azaan --reset | Reset all settings |

Options

-v, --version     Show version
-h, --help        Show help
-c, --city        Override city
-C, --country     Override country
--lat             Override latitude
--lon             Override longitude
-p, --plain       Plain text (no colors/emojis)
-j, --json        JSON output
-s, --status      Single line status
--reset           Reset settings

JSON Output

azaan --json

{
  "location": {
    "city": "San Francisco",
    "country": "USA",
    "timezone": "America/Los_Angeles"
  },
  "date": {
    "gregorian": "01 Feb 2026",
    "hijri": "13 Shaʿbān 1447"
  },
  "timings": {
    "fajr": "05:59",
    "sunrise": "07:14",
    "dhuhr": "12:23",
    "asr": "15:12",
    "maghrib": "17:34",
    "isha": "18:48"
  },
  "current": "asr",
  "next": {
    "prayer": "maghrib",
    "time": "17:34",
    "remaining": "24m"
  }
}

Status Bar

azaan --status
# Maghrib 5:34 PM (24m)

Use in tmux, polybar, waybar, or any status bar.

Qibla Direction

azaan qibla

  🕋  Qibla Direction

  ➡️  118.42° (ESE)

  From: 37.7749, -122.4194
  Direction is degrees clockwise from North

Configuration

# Interactive setup
azaan config

# Set location
azaan config --city "Makkah" --country "Saudi Arabia"

# Set calculation method
azaan config --method 4

# Set school (0=Shafi, 1=Hanafi)
azaan config --school 1

# Use 24-hour format
azaan config --24h

# Show current config
azaan config --show

# Clear config
azaan config --clear

Calculation Methods

| ID | Method | Region | |----|--------|--------| | 0 | Jafari | Shia | | 1 | Karachi | Pakistan | | 2 | ISNA | North America | | 3 | MWL | Europe | | 4 | Makkah | Saudi Arabia | | 5 | Egypt | Egypt | | 7 | Tehran | Iran | | 15 | Moonsighting | Worldwide | | 16 | Dubai | UAE |

Run azaan methods for full list of 23 methods.

Features

Zero-config:

• Auto-detects location via IP (3 fallback providers)
• Auto-recommends calculation method for your country
• Auto-detects timezone

Smart display:

• Highlights current prayer
• Shows next prayer with countdown
• Displays Hijri date

Flexible output:

• JSON output for scripting (--json)
• Status bar mode for tmux/polybar (--status)
• Plain text mode (--plain)

Comprehensive:

• 23 calculation methods worldwide
• Qibla direction from your location
• Monthly prayer calendar
• Interactive setup wizard

Aliases

After installing globally, all these aliases work:

• azaan
• athan
• azan

API

Powered by Aladhan Prayer Times API

Author

Ahmad Awais

License

MIT