salahnow-cli 0.2.0

SalahNow command-line prayer times

SalahNow CLI

Command-line prayer times using the same source logic as SalahNow Web:

• Türkiye: Diyanet (ezanvakti.emushaf.net)
• Worldwide: Muslim World League via AlAdhan (method=3, school=1)

Install

Option 1: pipx from PyPI (recommended)

pipx install salahnow-cli

Option 2: pip from PyPI

python3 -m pip install --user salahnow-cli

Option 3: local dev install

pipx install .

Option 4: install script

./scripts/install.sh

Commands

Show today's prayer times

salahnow

Check version:

salahnow --version

Next prayer + live countdown

salahnow next

Configure location/method/time format

salahnow config

Print current config:

salahnow config --show

Non-interactive example:

salahnow config \
  --city "New York" \
  --country "United States" \
  --country-code US \
  --lat 40.7128 \
  --lon -74.0060 \
  --method mwl \
  --time-format 12h

Config file path:

~/.config/salahnow/config.json

Notifications daemon

salahnow notify

• macOS: uses osascript
• Linux: uses notify-send (if available)

Zsh completion

Typer/click completion is built in:

salahnow --install-completion zsh

or print script:

salahnow --show-completion zsh

Notes

• Non-Türkiye locations are forced to mwl source (same as web behavior).
• Türkiye locations can use Diyanet, and CLI resolves diyanetIlceId from nearest TR city if missing.
• The CLI stores runtime cache in ~/.cache/salahnow/prayer_cache.json and uses cached data when APIs are temporarily unavailable.