countdown

Countdown is terminal based multi-event countdown timer. It uses the Bubble Tea TUI framework from Charm_.

countdown.mp4

Installation

Install using Golang's tools

go install github.com/aldernero/countdown@latest

or clone and build

git clone https://github.com/aldernero/countdown.git
cd countdown
go build -o countdown main.go

When you launch it for the first time an events.json file will be created in the user's system-defined config directory:

• Linux: ~/.config/countdown/
• macOS: ~/Library/Application Support/countdown/
• Windows: %APPDATA%\countdown\

On the first startup, just one prepopulated event (Golang's next anniversary) will be shown.

As you add and remove events, the events.json file will be updated.

Usage

The controls are

• "+" to add an event
• "-" to remove an event
• "/" to filter events

The rest of the controls are what you would expect, up/down to traverse the list, tab to move between fields in the event input form.