Skip to content
/ timer Public

Simple countdown terminal alarm. Useful for pomodoros too.

License

Notifications You must be signed in to change notification settings

pando85/timer

Repository files navigation


logo
Timer

demo

Build status Timer license

Simple count down terminal alarm.

Features

  • Multiple input options
  • Play sound when finished (Beep included!)
  • Send terminal bell
  • Big centered output

Installation

Cargo

cargo install timer_core

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