15 releases (9 stable)
1.7.0 | Sep 3, 2023 |
---|---|
1.5.1 | Aug 30, 2023 |
1.3.0 | Jun 22, 2023 |
1.2.0 | Jan 22, 2023 |
0.1.8 | Apr 22, 2021 |
#260 in Date and time
26 downloads per month
140KB
311 lines
bilal is a CLI salah time.
Features
- Show all salah time in current day
- Show current salah time and its remaining time
- Show next salah time
- Fancy error message
Usage
bilal all Show all salahs time
bilal current ... current salah time
bilal current --json .... with JSON format
Create a file named bilal.toml
in ~/.config/bilal/
. If you are on Windows
, put it under \AppData\Bilal\
. Then add your configuration:
latitude = -6.18233995
longitude = 106.84287154
madhab = "Shafi"
method = "Egyptian"
To see more options, please read the wiki
Integration with other programs
You can use Bilal with i3status-rust
to show salah time in your status.
i3status-rurts
configuration Example:
[[block]]
block = "custom"
cycle = [
"bilal current -J",
"bilal next -J",
]
on_click = "<command>"
interval = 300
json = true
See more examples to learn other variations.
If you like bilal
to support your favourite status-bar, please open new issue
with the valid input of your status-bar. In i3status-rust
the valid input it would be {"icon": "ICON", "state": "STATE", "text": "YOURTEXT"}
.
Installation
From binaries
The release page includes pre-compiled binaries for GNU/Linux, macOS and Windows.
From source
Using cargo-binstall
cargo binstall bilal
Using Rust's package manager cargo:
cargo install bilal
Development
git clone https://github.com/azzamsa/bilal
# Build
cd bilal
cargo build
# Run unit tests and integration tests
cargo test
# Install
cargo install --path .
Contributing
To learn more read contributing.md
Origin of the name
The name Bilal was chosen in reference to the Bilal bin Rabah. The first mu'azzin, chosen by Muhammad PBUH himself.
License
Copyright (c) 2020-2023 azzamsa
Bilal is distributed under the terms of GPL V3 License.
Dependencies
~5.5–7.5MB
~144K SLoC