A time progress bar utilities
build: bump version to v0.1.2
build: add warning to update related release file
fix: wrong name in argument doc



You can also use your local clone with git send-email.


zman is a CLI time progress that small, fast, and just one single binary.



  • Show year progress
  • Show month, and week progress
  • Show result in JSON format
  • Cross-platform


#With cargo (from source)

$ git clone https://git.sr.ht/~azzamsa/zman
$ cd zman
$ cargo build --release
$ cp target/release/bilal /usr/local/bin/

#From binaries

Download the binary from the Release

Available binaries:

  • *Nix
  • Window PC

#Usage with other tools

You can use Zman with i3status-rs to show salah time in your status bar.


i3status-rs configuration Example:

block = "custom"
cycle = ["zman -y -j", "zman -m -j"]
on_click = "<command>"
interval = 300
json = true


For reporting issues, visit the tracker here: https://todo.sr.ht/~azzamsa/Zman

Please send patches to ~azzamsa/zman-devel@lists.sr.ht

#Unsure how to contribute?

#Origin of the name

Zman is a 'time' in Arabic/Turksih.

#Inspired By

Please check out this previous work that helped inspire the creation of zman.


Copyright (c) 2020 Azzamsa

Bilal is distributed under the terms of GPL V3 License.