A salah time utilities

3d1201f docs: add missing link in public inbox

4 months ago

5756572 docs: update contributing

5 months ago


Sponsor me


bilal is a CLI salah time.


  • Show all salah time in current day
  • Show current salah time and its remaining time
  • Show next salah time


#Usage Examples

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:

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

To see more options, please read the wiki

#Command-line options

    bilal [FLAGS] [OPTIONS] [salah]

    <salah>    A Salah to show [default: all]

    -h, --help       Prints help information
    -J, --json       Display Salah in JSON formatted string
    -V, --version    Prints version information

        --color <WHEN>    Display Salah in colored output [default: always]

#Usage with other tools

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



i3status-rurts configuration Example:

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 hit me in the [mailing-list][mailing-list] with the valid input of your status-bar. In i3status-rust the valid input it would be {"icon": "ICON", "state": "STATE", "text": "YOURTEXT"}.


#From binaries

The release page includes pre-compiled binaries for GNU/Linux, macOS and Windows.

#From source

Using Rust's package manager cargo:

cargo install bilal


git clone https://git.sr.ht/~azzamsa/bilal.rs
cd bilal.rs

# Run unit tests and integration tests
cargo test

# Install
cargo install --path .


Please send patches and questions to my public-inbox mailing list.

Bugs and Todo here: https://todo.sr.ht/~azzamsa/Bilal

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.


Copyright (c) 2020 Azzamsa

Bilal is distributed under the terms of GPL V3 License.