New Chronos System Tray & Bullet-Proof Buffers as Timer Breaks (Fingers Crossed)

Author: Jeetski

assets/chronos.ico

@@ -165,12 +165,17 @@ def _is_break_or_buffer_block(block):
         return False
     if bool(block.get("is_buffer")) or bool(block.get("is_break")):
         return True
+    # Dynamic/template buffer rows often carry buffer_type without explicit flags.
+    if str(block.get("buffer_type") or "").strip():
+        return True
     subtype = str(block.get("subtype") or "").strip().lower()
     if subtype in {"buffer", "break"}:
         return True
     schedule_type = str(block.get("type") or block.get("schedule_type") or "").strip().lower()
     if schedule_type in {"buffer", "break"}:
         return True
+    if "buffer" in schedule_type:
+        return True
     return False
 
 

commands/start.py

@@ -0,0 +1,151 @@
+import os
+import sys
+import subprocess
+
+
+ROOT_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
+TRAY_SCRIPT = os.path.join(ROOT_DIR, "utilities", "tray", "app.py")
+PID_DIR = os.path.join(ROOT_DIR, "user", "Temp")
+PID_PATH = os.path.join(PID_DIR, "tray.pid")
+
+
+def _read_pid():
+    try:
+        with open(PID_PATH, "r", encoding="utf-8") as fh:
+            raw = fh.read().strip()
+        return int(raw) if raw else None
+    except Exception:
+        return None
+
+
+def _clear_pid():
+    try:
+        if os.path.exists(PID_PATH):
+            os.remove(PID_PATH)
+    except Exception:
+        pass
+
+
+def _pid_alive(pid):
+    if not isinstance(pid, int) or pid <= 0:
+        return False
+    if os.name == "nt":
+        try:
+            proc = subprocess.run(
+                ["tasklist", "/FI", f"PID eq {pid}", "/FO", "CSV", "/NH"],
+                stdout=subprocess.PIPE,
+                stderr=subprocess.PIPE,
+                text=True,
+                check=False,
+            )
+            out = (proc.stdout or "").strip().lower()
+            return bool(out) and (not out.startswith("info: no tasks")) and (str(pid) in out)
+        except Exception:
+            return False
+    try:
+        os.kill(pid, 0)
+        return True
+    except OSError:
+        return False
+
+
+def _pythonw_executable():
+    current = sys.executable or "python"
+    folder = os.path.dirname(current)
+    candidate = os.path.join(folder, "pythonw.exe")
+    if os.name == "nt" and os.path.exists(candidate):
+        return candidate
+    return current
+
+
+def _start_tray():
+    if not os.path.exists(TRAY_SCRIPT):
+        print("Tray app not found.")
+        return
+    pid = _read_pid()
+    if pid and _pid_alive(pid):
+        print(f"Tray already running (pid {pid}).")
+        return
+    py = _pythonw_executable()
+    kwargs = {
+        "cwd": ROOT_DIR,
+        "stdout": subprocess.DEVNULL,
+        "stderr": subprocess.DEVNULL,
+    }
+    if os.name == "nt":
+        flags = 0
+        flags |= getattr(subprocess, "DETACHED_PROCESS", 0)
+        flags |= getattr(subprocess, "CREATE_NEW_PROCESS_GROUP", 0)
+        if flags:
+            kwargs["creationflags"] = flags
+    else:
+        kwargs["start_new_session"] = True
+    proc = subprocess.Popen([py, TRAY_SCRIPT], **kwargs)
+    print(f"Tray start requested (pid {proc.pid}).")
+
+
+def _stop_tray():
+    pid = _read_pid()
+    if not pid:
+        print("Tray not running.")
+        return
+    if not _pid_alive(pid):
+        _clear_pid()
+        print("Tray not running.")
+        return
+    try:
+        if os.name == "nt":
+            subprocess.run(
+                ["taskkill", "/PID", str(pid), "/T", "/F"],
+                stdout=subprocess.DEVNULL,
+                stderr=subprocess.DEVNULL,
+                check=False,
+            )
+        else:
+            os.kill(pid, 15)
+    except Exception as e:
+        print(f"Failed to stop tray: {e}")
+        return
+    _clear_pid()
+    print("Tray stopped.")
+
+
+def _status_tray():
+    pid = _read_pid()
+    if pid and _pid_alive(pid):
+        print(f"Tray running (pid {pid}).")
+        return
+    if pid and not _pid_alive(pid):
+        _clear_pid()
+    print("Tray not running.")
+
+
+def run(args, properties):
+    sub = str(args[0]).strip().lower() if args else "status"
+    if sub in {"help", "-h", "--help"}:
+        print(get_help_message())
+        return
+    if sub == "start":
+        _start_tray()
+        return
+    if sub == "stop":
+        _stop_tray()
+        return
+    if sub == "restart":
+        _stop_tray()
+        _start_tray()
+        return
+    if sub == "status":
+        _status_tray()
+        return
+    print(get_help_message())
+
+
+def get_help_message():
+    return """
+Usage:
+  tray start
+  tray stop
+  tray restart
+  tray status
+"""

commands/tray.py

@@ -1075,12 +1075,17 @@ def _is_break_or_buffer_block(block):
         return False
     if bool(block.get("is_buffer")) or bool(block.get("is_break")):
         return True
+    # Dynamic/template buffer rows often carry buffer_type without explicit flags.
+    if str(block.get("buffer_type") or "").strip():
+        return True
     subtype = str(block.get("subtype") or "").strip().lower()
     if subtype in {"buffer", "break"}:
         return True
     schedule_type = str(block.get("type") or block.get("schedule_type") or "").strip().lower()
     if schedule_type in {"buffer", "break"}:
         return True
+    if "buffer" in schedule_type:
+        return True
     return False
 
 

modules/timer/main.py

@@ -15,3 +15,7 @@ playsound>=1.2.2
 # CLI UX (autocomplete/suggestions)
 prompt_toolkit>=3.0.43
 
+# Desktop tray app + icon rendering
+pystray>=0.19.5
+Pillow>=10.3.0
+

requirements.txt

@@ -0,0 +1,11 @@
+@echo off
+setlocal
+
+cd /d "%~dp0"
+
+set "PYTHONW_EXE=pythonw"
+if exist ".venv\Scripts\pythonw.exe" set "PYTHONW_EXE=.venv\Scripts\pythonw.exe"
+
+start "" /B "%PYTHONW_EXE%" utilities/tray/app.py
+
+exit /b

tray_launcher.bat

@@ -71,6 +71,7 @@ export function mount(el, context) {
       <div class="row" style="gap:8px; align-items:center;">
         <button class="btn btn-primary" id="twStart" data-ui-id="widget.timer.start_button">Start</button>
         <button class="btn" id="twStartDay" data-ui-id="widget.timer.start_day_button">Start Day</button>
+        <button class="btn" id="twTray" data-ui-id="widget.timer.open_tray_button">Open Tray</button>
         <button class="btn" id="twPause" data-ui-id="widget.timer.pause_resume_button">Pause</button>
         <button class="btn btn-secondary" id="twCancel" data-ui-id="widget.timer.cancel_button">Cancel</button>
         <div class="spacer"></div>
@@ -95,6 +96,7 @@ export function mount(el, context) {
   const bindNameEl = el.querySelector('#twBindName');
   const startBtn = el.querySelector('#twStart');
   const startDayBtn = el.querySelector('#twStartDay');
+  const trayBtn = el.querySelector('#twTray');
   const pauseBtn = el.querySelector('#twPause');
   const cancelBtn = el.querySelector('#twCancel');
   const refreshBtn = el.querySelector('#twRefresh');
@@ -398,6 +400,7 @@ export function mount(el, context) {
     else await start();
   });
   startDayBtn?.addEventListener('click', () => startDayRun());
+  trayBtn?.addEventListener('click', () => openTray());
   pauseBtn.addEventListener('click', async () => {
     const s = String(lastTimerStatus || 'idle').toLowerCase();
     if (s === 'paused') {
@@ -453,7 +456,29 @@ export function mount(el, context) {
       startDayBtn.disabled = false;
     }
   }
-
+  async function openTray() {
+    if (!trayBtn || trayBtn.disabled) return;
+    const prev = trayBtn.textContent;
+    trayBtn.disabled = true;
+    trayBtn.textContent = 'Opening...';
+    try {
+      const resp = await fetch(apiBase() + '/api/cli', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ command: 'tray', args: ['start'], properties: {} })
+      });
+      const data = await resp.json().catch(() => ({}));
+      if (!resp.ok || data.ok === false) {
+        throw new Error(data.error || data.stderr || `HTTP ${resp.status}`);
+      }
+    } catch (err) {
+      console.error('[Chronos][Timer] Open tray failed', err);
+      alert(`Failed to open tray: ${err?.message || err}`);
+    } finally {
+      trayBtn.textContent = prev;
+      trayBtn.disabled = false;
+    }
+  }
   function resetDisplayForSelected() {
     const p = profiles[profSel.value] || {};
     const sec = (p.focus_minutes ? Number(p.focus_minutes) : 25) * 60;
@@ -504,3 +529,5 @@ export function mount(el, context) {
   if (rse) rse.addEventListener('pointerdown', (ev) => { const r = el.getBoundingClientRect(); edgeDrag(r, (e, sr) => { el.style.width = Math.max(MIN_TIMER_WIDTH, e.clientX - sr.left) + 'px'; el.style.height = Math.max(MIN_TIMER_HEIGHT, e.clientY - sr.top) + 'px'; })(ev); });
 }
 
+
+