https://github.com/sklum/iterm2-countdown
Countdown timer for iTerm2 status bar
https://github.com/sklum/iterm2-countdown
cli countdown-timer iterm2 iterm2-plugin macos status-bar terminal
Last synced: 14 days ago
JSON representation
Countdown timer for iTerm2 status bar
- Host: GitHub
- URL: https://github.com/sklum/iterm2-countdown
- Owner: sklum
- Created: 2026-01-03T04:07:45.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2026-01-03T04:14:34.000Z (6 months ago)
- Last Synced: 2026-06-09T20:29:08.299Z (25 days ago)
- Topics: cli, countdown-timer, iterm2, iterm2-plugin, macos, status-bar, terminal
- Language: Python
- Homepage: https://iterm2.com
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# iterm2-countdown
A countdown timer for iTerm2's status bar. Set a target time from the terminal and see the remaining time in your status bar.
## Installation
```bash
uv tool install git+https://github.com/sklum/iterm2-countdown.git
```
Then install the iTerm2 status bar component:
```bash
iterm2-countdown --install
```
## iTerm2 Setup
1. Enable Python API: **iTerm2 → Settings → General → Magic → Enable Python API**
2. Restart iTerm2
3. Add the component: **Settings → Profiles → Session → Configure Status Bar**
4. Drag "Countdown Timer" to your status bar
## Usage
```bash
# Set a countdown
iterm2-countdown 8:00 PM
iterm2-countdown 20:00
iterm2-countdown 5pm
# Check status
iterm2-countdown --status
# Clear countdown
iterm2-countdown --clear
```
If the specified time has already passed today, the countdown is automatically set for tomorrow.
## Uninstall
```bash
iterm2-countdown --uninstall
uv tool uninstall iterm2-countdown
```