countdown

command module
v0.0.0-...-26988db Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 17, 2025 License: MIT Imports: 14 Imported by: 0

README

countdown

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

https://user-images.githubusercontent.com/96601789/182011443-15b35466-3969-490c-9f74-b30dcbd29a41.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.

Screenshot_20220730_230038

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.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL