<img src="https://vhs.charm.sh/vhs-1q9uo4hkLStOL4UHZFfQ4W.gif" alt="Made with VHS">
<a href="https://vhs.charm.sh">
    <img src="https://stuff.charm.sh/vhs/badge.svg">
</a>



<h1 align="center">timer</h1>

A sleep with progress.

---

Timer is a small CLI, similar to the sleep everyone already knows and love, with a couple of extra features:

• a progress bar indicating the progression of said timer
• a timer showing how much time is left
• named timers

Usage

timer <duration>
timer -n <name> <duration>
man timer
timer --help

It is possible to pass a time unit for <duration>.

Valid time units are "ns", "us" (or "µs"), "ms", "s", "m", "h". If no unit is passed, it defaults to seconds ("s").

If you want to show the start time in 24-hour format, use --format 24h. For example:

timer 5s --format 24h -n Demo

Currently, the two formats supported by the --format option are: - kitchen: the default, example: 9:16PM. - 24h: 24-hour time format, example: 21:16.

Install

homebrew:

brew install caarlos0/tap/timer

macports:

sudo port install timer

snap:

snap install timer

apt:

echo 'deb [trusted=yes] https://repo.caarlos0.dev/apt/ /' | sudo tee /etc/apt/sources.list.d/caarlos0.list
sudo apt update
sudo apt install timer

yum:

echo '[caarlos0]
name=caarlos0
baseurl=https://repo.caarlos0.dev/yum/
enabled=1
gpgcheck=0' | sudo tee /etc/yum.repos.d/caarlos0.repo
sudo yum install timer

arch linux:

yay -S timer-bin

deb/rpm/apk:

Download the .apk, .deb or .rpm from the releases page and install with the appropriate commands.

manually:

Download the pre-compiled binaries from the releases page or clone the repo build from source.

Badges