Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/antonmedv/countdown
Terminal countdown timer
https://github.com/antonmedv/countdown
Last synced: about 6 hours 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 (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-12-25T22:39:49.000Z (about 1 month ago)
- Last Synced: 2025-01-18T17:02:17.927Z (7 days ago)
- Language: Go
- Homepage:
- Size: 350 KB
- Stars: 1,089
- Watchers: 17
- Forks: 113
- Open Issues: 12
-
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.
## License
[MIT](LICENSE)