Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/azzamsa/zman
A time progress bar utilities
https://github.com/azzamsa/zman
Last synced: about 1 month ago
JSON representation
A time progress bar utilities
- Host: GitHub
- URL: https://github.com/azzamsa/zman
- Owner: azzamsa
- License: gpl-3.0
- Created: 2021-11-14T11:30:18.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-08-07T00:57:05.000Z (4 months ago)
- Last Synced: 2024-10-07T01:17:43.787Z (2 months ago)
- Language: Rust
- Homepage:
- Size: 511 KB
- Stars: 57
- Watchers: 4
- Forks: 5
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-made-by-indonesian - zman - `A time progress bar utilities` *by [Azzam S.A.](https://github.com/azzamsa)* (Z)
- made-in-indonesia - zman - `A time progress bar utilities` *by [Azzam S.A.](https://github.com/azzamsa)* (Z)
README
zman
---
**zman** is a CLI year (time) progress that small, fast, and just one single binary.
## Features
- Show year progress
- Show month, and week progress
- Show result in JSON format
- Cross-platform
## Usage Examples
```bash
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:
```bash
[[block]]
block = "custom"
cycle = ["zman year -J", "zman month -J"]
on_click = ""
interval = 300
json = true
```
### Other tools
See [more examples](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"}`.
## Installation
### From binaries
The [release page](https://github.com/azzamsa/zman/releases) includes
pre-compiled binaries for GNU/Linux, macOS and Windows.
### From source
Using [cargo-binstall](https://github.com/cargo-bins/cargo-binstall)
```bash
cargo binstall bilal
```
With Rust's package manager [cargo](https://github.com/rust-lang/cargo), you can install fd via:
```bash
cargo install zman
```
## Development
```bash
git clone https://github.com/azzamsa/zman
# Build
cd zman
cargo build
# Run unit tests and integration tests
cargo test
# Install
cargo install --path .
```
## Contributing
To learn more read [contributing.md](docs/dev/contributing.md)
## Origin of the name
Zman is a 'time' in Arabic/Turksih.
## Inspirations
Please check out this previous work that helped inspire the creation of zman.
- [@year_progress](https://twitter.com/year_progress) - The only progress bar you'd rather see go slower. [source](https://github.com/filiph/progress_bar)
## License
Copyright (c) 2020-2023 azzamsa
`zman` is distributed under the terms of the GPL v3 License.
See the [LICENSE](LICENSE) for details.