Command-line companion for prayer timings, Quran verses, and more.

go install github.com/hjr265/deen@latest

Show the next prayer time:

~ » deen adhan:next
Fajr 04:05

Show an ayah (verse) of the Quran:

~ » deen quran:ayah 2:255
[Al-Baqara 2:255, Saheeh International] Allah - there is no deity except Him, the Ever-Living, the Sustainer of [all] existence...

The reference format is surah:ayah (e.g. 2:255 for Ayat al-Kursi). Ranges are also supported (e.g. 2:13-15).

Multiple editions can be configured to show each verse in all editions.

Deen reads its configuration from ~/.config/deen/config.toml. Use --config to specify an alternative path:

deen --config /path/to/config.toml adhan:next

[database]
path = "/home/user/.local/share/deen/deen.db"

[adhan]
method = 3
city = "Dhaka"
country = "Bangladesh"
time_format = "24h" # or "12h"

[quran]
editions = ["en.asad"]

Prayer times are fetched from the Aladhan API and cached locally in a BoltDB database. Quran verses are fetched from the Al Quran Cloud API. Available editions can be found in the API documentation.

Deen is available under the BSD 3-Clause License.