Minimal Timer — Stopwatch & Countdown ⏱️

A clean, minimalist stopwatch and countdown timer for Visual Studio Code & Antigravity IDE.

No distracting panels, no multi-button clutter — just a simple, elegant timer that sits right in your status bar.

📸 Preview

Status Bar Display

Running quietly in the bottom bar without stealing editor focus:

Interactive Hover Tooltip

Hover over the timer to see real-time status and access one-click actions:

✨ Features

• Dual Modes:
  • ⏱️ Stopwatch (Count-Up): Starts at 0:0:0 and tracks elapsed time.
  • ⏳ Countdown Timer: Counts down from any preset (5m, 10m, 15m, 25m Pomodoro, 30m, 45m, 60m) or custom duration (mm:ss or pure minutes).
• 5-Second Audible Alarm:
  • When the countdown reaches 0:0:0, a pleasant chime rings for 5 seconds.
  • The status bar item alerts with $(bell) 0:0:0 [Stop Alarm].
  • An interactive notification appears with a "Stop Alarm" button.
• Instant Stop:
  • Click the status bar or the notification button to silence the alarm immediately.
  • If not clicked, it automatically stops ringing after 5 seconds.
• Single-Click to Start / Pause:
  • Click the timer to start, click again to pause.
• Double-Click to Reset:
  • Double-click to instantly reset:
    • In Stopwatch Mode: Resets to 0:0:0.
    • In Countdown Mode: Resets back to your configured duration (e.g. 0:10:0).
  • Intelligent double-click debouncing prevents accidental pause/play toggles when resetting.
• Zero-Drift & Sleep Precision:
  • Uses hardware-backed wall-clock timestamps (Date.now()).
  • Remains 100% accurate even if your laptop lid is closed or computer is in sleep mode — upon opening your laptop, the timer instantly reflects the exact real-world elapsed time.
• Customizable:
  • Formats: 0:0:0 (compact default), 0:00:00, 00:00:00, or 0:00.
  • Icon styles: Dynamic play/pause icons, static clock icon, or digits-only.
  • Alignment: Right (default) or Left status bar placement.

🎮 How to Use

Switching Modes & Setting Duration

Hover over the status bar timer to click:

• 🔄 Switch to Stopwatch / 🔄 Switch to Countdown: Toggles between counting up or counting down.
• ⏳ Set Duration: Choose a quick preset (5m, 10m, 15m, 25m, 30m, 45m, 60m) or enter a custom duration (e.g. 12 or 12:30).

⌨️ Command Palette

Access anytime via Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux):

• Timer: Start / Pause — Toggles the active timer
• Timer: Reset — Resets back to zero or countdown duration
• Timer: Switch Mode (Stopwatch / Countdown) — Opens mode selector
• Timer: Set Countdown Duration — Select preset or custom duration
• Timer: Stop Alarm — Silences the 5-second alarm chime
• Timer: Start — Starts the timer
• Timer: Pause — Pauses the timer

⚙️ Configuration Settings

Customize in VS Code Settings (Cmd+, or Ctrl+,):

📦 Installation

To install directly from the packaged .vsix:

code --install-extension simple-code-timer-0.0.1.vsix

Or in Antigravity IDE:

"/Applications/Antigravity IDE.app/Contents/Resources/app/bin/antigravity-ide" --install-extension simple-code-timer-0.0.1.vsix