/timer

Simple countdown terminal alarm. Useful for pomodoros too.

Primary LanguageRustGNU General Public License v3.0GPL-3.0


logo
Timer

demo

Build status Timer license

Simple count down terminal alarm.

Features

  • Parse multiple input options
  • Play sound when finished (Beep included!)
  • Send terminal bell
  • Big centered output
  • Repeat countdown infinitely

Installation

Cargo

cargo install timer-cli

Archlinux

yay -S timer-rs

Binaries

Binaries are made available each release for the Linux and MacOS operating systems.

You can download a prebuilt binary from our Releases.

curl -s https://api.github.com/repos/pando85/timer/releases/latest \
  | grep browser_download_url \
  | grep $(uname -m) \
  | grep linux \
  | cut -d '"' -f 4 \
  | xargs curl -L \
  | tar xvz
sudo mv timer /usr/local/bin

Beep

If you want to enable beep from your built-in case speaker you will need to run one of these kernel modules: pcspkr (recommended) or snd-pcsp.

In addition, to use beep as normal user read the PERMISSIONS.md file.

Terminal bell

If executed with -t, --terminal-bell option it will send a bell character. Same as:

echo -e '\a'

This is useful for visual bell. Remember that you have to enable it in your terminal configuration. Usage example:

timer -t -s 11:00