9 stable releases (3 major)

3.0.0 Jul 22, 2023
2.0.2 Jan 3, 2023
2.0.1 Dec 28, 2022
1.0.6 May 18, 2022
0.1.3 Apr 19, 2021

#102 in Date and time

33 downloads per month


396 lines


Sponsor me


zman is a CLI year (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

Usage Examples

zman                                Show a year progress bar
zman month                          ... a month progress bar
zman week                           ... a week progress bar
zman year --json                    ... a year progress bar with JSON format

Integration with other programs

Using zman with i3status-rust

You can use Zman with i3status-rust to show time period in your status bar.


i3status-rust configuration Example:

block = "custom"
cycle = ["zman year -J", "zman month -J"]
on_click = "<command>"
interval = 300
json = true

Other tools

See more examples to learn other variations.

If you like zman to support your favorite status-bar, please open the issue 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 cargo-binstall

cargo binstall bilal

With Rust's package manager cargo, you can install fd via:

cargo install zman


git clone https://github.com/azzamsa/zman

# Build
cd zman
cargo build

# Run unit tests and integration tests
cargo test

# Install
cargo install --path .


To learn more read contributing.md

Origin of the name

Zman is a 'time' in Arabic/Turksih.


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


Copyright (c) 2020-2023 azzamsa

zman is distributed under the terms of the GPL v3 License.

See the LICENSE for details.


~56K SLoC