CaffeineTimer 1.6.0

What's new in 1.6.0

⌥-drag the cup — instant custom timer

Hold ⌥ (Option) and drag straight from the menu-bar coffee cup to stretch out a custom duration — no menu needed. Keep the initiating ⌥ held for the minutes range; release and re-press ⌥ for seconds; hold ⇧ for hours. A tooltip on the Custom… menu item teaches the shortcut.

Plain clicks, right-clicks, and press-drag-release menu selection all work exactly as before — the gesture only fires with ⌥ held.

Rock-steady countdown

The menu-bar countdown now uses monospaced (tabular) digits, so the icons to the left of the cup no longer shuffle every second as the numbers tick.

---

Install: drag to Applications, or

brew install --cask marcvig/tap/caffeine-timer

Signed + notarized (Developer ID). Requires macOS 13+.

v1.5.0

What's new in 1.5.0

Your timer can now end with a little flourish — off by default, pick one in Settings ▸ When a timer ends (with a Preview button):

• Ripple from the cup — soft rings expanding out of the menu-bar icon
• Screen-edge glow — a brief blue-and-orange border glow
• Confetti — a burst from the cup, on every display
• Coffee steam — a gentle ghost cup with rising steam

Polite by design: it never steals focus or clicks, never wakes a sleeping display, skips the lock screen, and stays out of other apps' fullscreen Spaces. Plays only when a timer ends on its own — Stop stays silent.

Still a tiny native menu-bar app — about 1 MB, no frameworks, no telemetry.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.4.0

What's new in 1.4.0

A new Settings window, and CaffeineTimer is now battery-smart:

• Launch at login — optionally start CaffeineTimer automatically when you log in.
• Battery-smart auto-stop — optionally release the keep-awake when the battery drops below a percentage you choose, or when Low Power Mode turns on, so it won't drain your laptop if you walk away.
• Settings window — a proper home for these, plus the Allow display to sleep option (moved out of the menu).

Still a tiny, single-file native menu-bar app — under 1 MB, no Sparkle, no telemetry.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.3.2

What's new in 1.3.2

A cleaner, calmer Custom… duration drag:

• The drag now draws as a clean straight line with a glowing blue-and-orange band — easier to aim and less busy than the previous springy rainbow.
• Softer, smoother glow that diffuses gently off the line.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.3.1

What's new in 1.3.1

A small polish release for the About window:

• Roomier About window — wider layout with more breathing room so everything reads cleanly.
• Copyable Homebrew command — the brew command now sits in a tidy code box with a one-click copy button beside it.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.3.0

What's new in 1.3.0

• Check for Updates. A new "Check for Updates…" item in the menu (and a button in the redesigned About window) checks GitHub for the latest release and tells you if a newer version is available — with one-click Download or Copy brew command.
• Redesigned About window. A clean custom About panel: app icon, version, tagline, the Check for Updates button, source/support links, and the Homebrew command.

Stays a tiny, single-file native menu-bar app — no Sparkle, no extra frameworks, under 1 MB.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.2.0

What's new in 1.2.0

• Custom durations by stretching from the menu bar. Choose "Custom…" and pull a rubber band out from the cup icon — the further you pull, the longer the timer. Hold ⇧ for hours (up to 12h), ⌥ for a seconds range. Click to start, Esc to cancel.
• A little delight: the band is a soft, flowing prism glow with natural springy physics.
• "Allow display to sleep" menu toggle — keep your Mac awake while letting the screen sleep normally.
• Stop now confirms with a notification ("Your Mac is no longer set to stay awake").

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.1.0

What's new in 1.1.0

• Time-used progress bar under the menu countdown — fills left→right as your awake session elapses.
• Color ramp: the bar (and the countdown, in both the menu and the menu bar) shifts green → orange → red as time runs out, with a live % used shown in the header.
• The dropdown countdown is now bold and fully opaque, so it's easy to read.

Install / update: brew upgrade --cask caffeine-timer — or brew install --cask marcvig/tap/caffeine-timer

v1.0.1

Adds an About dialog (now the top menu item) showing the version, a Vigod Labs link, the source repo, Support, and the Homebrew update command. Also ships a compiled asset-catalog icon.

Signed & notarized; requires macOS 13+ on Apple Silicon.

Install: download CaffeineTimer-1.0.1.dmg below and drag to Applications, or:

brew upgrade --cask caffeine-timer

v1.0.0

First public release.

A tiny macOS menu-bar app that keeps your Mac awake for 15 / 30 / 60 / 120 minutes or indefinitely, using an IOKit power assertion (the same mechanism as the caffeinate CLI). Signed & notarized. Requires macOS 13+ on Apple Silicon.

Install: download CaffeineTimer-1.0.0.dmg below and drag to Applications, or:

brew install --cask marcvig/tap/caffeine-timer