   ▄▄   ▄▄▄▄   ▄    ▄   ▄▄   ▄▄   ▄        ▄    ▄ ▄    ▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄
   ██   █   ▀▄ █    █   ██   █▀▄  █        ██  ██ █    █   █    █
  █  █  █    █ █▄▄▄▄█  █  █  █ █▄ █        █ ██ █ █    █   █    █▄▄▄▄▄
  █▄▄█  █    █ █    █  █▄▄█  █  █ █  ▀▀▀   █ ▀▀ █ █    █   █    █
 █    █ █▄▄▄▀  █    █ █    █ █   ██        █    █ ▀▄▄▄▄▀   █    █▄▄▄▄▄

☾ أَذَان · the call to prayer

$ let the adhan through.

> finds your local prayer times · quiets Spotify, YouTube, anything playing · for a few minutes at each prayer · hands your volume back.
> no accounts. no cloud. one small process on your machine.

[ download latest release ][ install with uv ]

zsh — adhan-mute

$ adhan-mute
Detecting location...
Location: Algiers (36.7538, 3.0588)
Fetching today's prayer times...
Today's times: Fajr 05:15 · Dhuhr 12:44 · Asr 16:17 · Maghrib 18:59 · Isha 20:12
Next: Maghrib at 18:59 (in 42.0 min)
>>> Maghrib — muting for 5 min.
Unmuted (restored volume to 35)._

01 install

Prebuilt binaries need nothing installed — grab yours from the latest release and run it.

> from source, with uv

git clone https://github.com/wailbentafat/adhan-mute
cd adhan-mute
uv sync
uv run main.py

Requires uv. On Linux, also requires alsa-utils (usually preinstalled).

02 how it works

Detects your approximate location via IP geolocation (no account, no permissions).
Fetches today's five prayer times for that location from the Aladhan API.
Waits until the next prayer time.
Mutes system volume, waits a configurable number of minutes, then restores your previous volume.
Repeats daily.

03 options

uv run main.py --mute-minutes 5 --poll-seconds 60

`--mute-minutes`	How long to keep audio muted at each prayer time. Default: 5.
`--poll-seconds`	How often to check the clock while waiting. Default: 60.