timer icon indicating copy to clipboard operation
timer copied to clipboard

Simple countdown terminal alarm. Useful for pomodoros too.


logo
Timer

demo

Build status Timer license

Simple count down terminal alarm.

  • Features
  • Installation
    • Cargo
    • Archlinux
    • Binaries
  • Beep
  • Terminal bell

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