Repository files navigation

Bilal

bilal is a CLI salah time.

• Everything works completely offline.
• Display all salah times for the current day.
• Show the current salah time and its remaining time.
• Display the next salah time.
• Use both 12-hour and 24-hour formats.
• Fancy error message

bilal all                            Show all salahstimebilal current                        ... current salahtimebilal current --json                  .... with JSON format

To configure Bilal, first create a file namedconfig.toml in~/.config/bilal/ on Unix-like systems. On Windows, place it under\AppData\Bilal\. If you prefer a custom location, simply set theBILAL_CONFIG environment variable.

Next, add your configuration details to theconfig.toml file:

latitude =-6.18233995longitude =106.84287154madhab ="Shafi"method ="Egyptian"

To see more options, please read thewiki

You can use Bilal withi3status-rust to show salah time in your status.

i3status-rust configuration Example:

[[block]]block ="custom"cycle = ["bilal current -J","bilal next -J",        ]on_click ="<command>"interval = 300json =true

Seemore examples to learn other variations.

If you likebilal to support your favourite status-bar, please open new issuewith the valid input of your status-bar. In i3status-rustthe valid input it would be{"icon": "ICON", "state": "STATE", "text": "YOURTEXT"}.

Therelease page includespre-compiled binaries for GNU/Linux, macOS and Windows.

If you encounter a security warning on macOS stating "Apple could not verify 'bilal' is free of malware...", you can resolve this by:

xattr -d com.apple.quarantine /path/to/bilal

Usingcargo-binstall

cargo binstall bilal

Using Rust's package managercargo:

cargo install bilal

git clone https://github.com/azzamsa/bilal# Buildcd bilalcargo build# Run unit tests and integration testscargotest# Installcargo install --path.

To learn more readcontributing.md

The name Bilal was chosen in reference to the Bilal bin Rabah. The firstmu'azzin, chosen by Muhammad PBUH himself.

Copyright (c) 2020-2024 azzamsa

Bilal is distributed under the terms ofGPL V3 License.