🧘 ZenTabTimer

"ZenTabTimer lets you launch a timer for a work session, and visually track how much time's left in that browser tab while you work elsewhere in other tabs. Make sure to pin the tab for the best experience. The rest of this readme and the rest of this "app" is aggressively vibegentically agenteered. Is it AI slop? Yes. Can AI slop still be beautiful and wonderous at times? You tell me."

— Kevin Kraftsmith

A little pie that knows when to leave the party.

Stop squinting at 01:48:10 like it’s ancient Sanskrit. ZenTabTimer turns your Chrome tab favicon into a fat, calm countdown pie — full at the start, empty when it’s time to stand up, stretch, and pretend you hydrated.

🥧⏱️✨ No app store. No npm. No “sync your chakras to the cloud.” Just one HTML file and a browser that believes in you.

---

⚠️ A solemn (lol) disclaimer

This project is vibe-coded, AI-generated, agentically engineered slop — the artisanal kind, hand-stirred by a human who said “make it zen” and an agent who said “bet.”

If it works: 🎉
If it doesn’t: 🫠 chef’s kiss, as intended
If the pie looks like a lime Pac-Man: you’re welcome.

No warranty. No SLA. No spiritual enlightenment guarantee. Timer may cause sudden awareness that you’ve been doomscrolling for 50 minutes. 🐉

---

🎯 What it does

The page UI is intentionally boring. You’re not supposed to look at it. You’re supposed to look at other tabs while this one silently judges your focus. 👁️

---

🚀 Quick start (pie to go)

1. Clone or download this repo.
2. Open timer.html in Chrome:

• Double-click it, or
• Go to file:///path/to/ZenTabTimer/timer.html

3. Pin the tab (right-click tab → Pin) so Chrome doesn’t ghost your session. 📌
4. Click a preset. Watch the favicon fill with purpose. Work. Exist. Softly.

Bookmark it. Name the bookmark something profound like “⏱ pie.”

---

🔔 Notifications: don’t get crusty

Chrome is weird about file:// notifications — it often won’t even ask for permission.

Serving locally works better:

cd ZenTabTimer
python3 -m http.server 8000

Then open http://localhost:8000/timer.html, start a timer, and Allow notifications when prompted.

The in-page ding still works without notification permission. The OS toast is just extra seasoning. 🧂

---

🧠 How it works (for the curious crust)

• One self-contained timer.html — HTML + CSS + JS, no backend, no build step.
• Deadline math: endsAt = now + duration (so throttled background tabs don’t “lose seconds” like a forgetful oven timer).
• Each tick redraws a tiny canvas pie and sets it as the favicon.
• On finish: beep + optional Notification.
• If Chrome naps through the exact moment: wake-up listeners catch up and announce “done” when the page stirs again. 😴→😮

---

🧘 Suggested ritual

1. Pin ZenTabTimer.
2. Hit 50.
3. Go do the thing.
4. When the pie is gone, the universe (or at least your OS) whispers: timer done.
5. Touch grass. Or coffee. Or both. ☕🌿

---

📜 License / liability / karma

Do whatever you want with this. If it breaks, you get to keep both pieces of the pie. 🥧💔

— shipped with love, recursion, and an inappropriate number of emojis