https://github.com/pando85/timer
Simple countdown terminal alarm. Useful for pomodoros too.
https://github.com/pando85/timer
cli countdown pomodoro pomodoro-timer productivity rust timer
Last synced: about 1 year ago
JSON representation
Simple countdown terminal alarm. Useful for pomodoros too.
- Host: GitHub
- URL: https://github.com/pando85/timer
- Owner: pando85
- License: gpl-3.0
- Created: 2021-11-20T14:43:24.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-27T18:33:05.000Z (about 1 year ago)
- Last Synced: 2025-03-30T01:12:32.357Z (about 1 year ago)
- Topics: cli, countdown, pomodoro, pomodoro-timer, productivity, rust, timer
- Language: Rust
- Homepage:
- Size: 329 KB
- Stars: 45
- Watchers: 2
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
Timer
Simple count down terminal alarm.
- [Features](#features)
- [Installation](#installation)
- [Cargo](#cargo)
- [Archlinux](#archlinux)
- [Binaries](#binaries)
- [Beep](#beep)
- [Terminal bell](#terminal-bell)
## Features
- Parse multiple input options
- Play sound when finished (Beep included!)
- Send terminal bell
- Big centered output
- Repeat countdown infinitely
## Installation
### Cargo
```bash
cargo install timer-cli
```
### Archlinux
```bash
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](https://github.com/pando85/timer/releases).
```bash
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`](PERMISSIONS.md) file.
## Terminal bell
If executed with `-t, --terminal-bell` option it will send a bell character. Same as:
```bash
echo -e '\a'
```
This is useful for visual bell. Remember that you have to enable it in your terminal configuration.
Usage example:
```bash
timer -t -s 11:00
```