https://github.com/antonmedv/countdown
Terminal countdown timer
https://github.com/antonmedv/countdown
Last synced: 1 day ago
JSON representation
Terminal countdown timer
- Host: GitHub
- URL: https://github.com/antonmedv/countdown
- Owner: antonmedv
- License: mit
- Created: 2019-03-20T15:14:32.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-02-18T14:08:04.000Z (about 2 months ago)
- Last Synced: 2025-04-06T10:03:51.229Z (9 days ago)
- Language: Go
- Homepage:
- Size: 353 KB
- Stars: 1,108
- Watchers: 16
- Forks: 115
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- my-awesome-starred - antonmedv/countdown - Terminal countdown timer (Go)
README
# Countdown
## Install
```sh
brew install countdown
```
```sh
go install github.com/antonmedv/countdown@latest
```
Or download prebuilt binary from [releases](https://github.com/antonmedv/countdown/releases).
## Usage
Specify duration in Go format `1h2m3s` or a target time: `02:15pm`, `14:15`.
```sh
countdown 25s
countdown 11:32
```
Add a command with `&&` to run after the countdown.
```sh
countdown 1m30s && say "Hello, world"
```
Count from up from the zero.
```sh
countdown -up 30s
```
Announce (via macOS `say` command) last 10 seconds.
```sh
countdown -say 10s
```
Display a title below the countdown timer.
```sh
countdown -title "Hello, world" 30s
```
## Key binding
- `Space`: Pause/Resume the countdown.
- `Esc` or `Ctrl+C`: Stop the countdown without running the next command.
## Related
- [fx](https://github.com/antonmedv/fx) – terminal JSON viewer
- [walk](https://github.com/antonmedv/walk) – terminal file manager
- [howto](https://github.com/antonmedv/howto) – terminal command LLM helper
## License
[MIT](LICENSE)