From 2b77fe9ea0f2d015e7aac5b86fe0866b497826c8 Mon Sep 17 00:00:00 2001 From: Michal Ferber Date: Thu, 10 Sep 2026 22:06:33 -0400 Subject: [PATCH] =?UTF-8?q?site:=20list=20macOS,=20Windows,=20and=20Linux?= =?UTF-8?q?=20=E2=80=94=20v2.0.0=20ships=20all=20three?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Closes #12 v2.0.0's tag-triggered release published Windows and Linux binaries alongside macOS, but the site (moved here in #9) was still entirely macOS-shaped: 3 occurrences of "macOS", 0 of "Windows" or "Linux" across the built pages, while the Releases page it links to has all three assets. A Windows visitor was told this is a Mac app and then found a .exe. Per platform, not a blind append — each OS gets its own install and first-launch section, since they're genuinely different (macOS Gatekeeper right-click-Open, Windows SmartScreen More info/Run anyway, Linux no signing step at all): - index.astro: hero now states all three platforms explicitly, adds a three-card Platforms section, generalizes "No Dock icon" and "leaves your Mac" wording that doesn't hold on Windows/Linux, and marks Focus/DND as "(macOS only)" in the feature list. - docs.astro: Quick Start's Install section is now three per-OS subsections (previously a single macOS-only walkthrough). Focus/DND section now states plainly it's a no-op on Windows/Linux — verified against internal/focus/focus.go's `runtime.GOOS != "darwin"` guard, not just left unmentioned. Global hotkey's Accessibility-permission prompt is now scoped to macOS. Data-location table now lists all three OS paths (Windows path confirmed empirically below; Linux from internal/settings/settings.go). - consts.ts, Head.astro, contact.astro, privacy.astro: dropped remaining "your Mac" / "macOS version" / operatingSystem: 'macOS' (JSON-LD) framing. - public/llms.txt: same trap as last time (a static file under public/, outside src/, so astro-page edits don't reach it) — updated to all three platforms and their download formats. ## What was actually verified tonight, and what wasn't macOS: already verified prior to this PR (Tomatick.app 2.0.0 running, bundle metadata and adhoc codesign checked). Windows: downloaded Tomatick-2.0.0-windows-amd64.exe on pve-win11, SHA256 matched the release asset's digest exactly (1eafde1c...4c50f), launched it, stayed responsive 5s, and it created %AppData%\Tomatick\history.db. Did NOT visually confirm the tray icon appears or that a timer/alarm actually completes — no GUI/RDP session was used, only PowerShell over SSH. Linux: downloaded Tomatick-2.0.0-linux-amd64.tar.xz on r2d2 (x86_64, correct arch), SHA256 matched the release digest (7772d134...3102be), confirmed a valid ELF x86-64 executable. Running it produced a clean, specific panic: no X11 display available — not a crash bug, an environment gap. Every x86_64 box in this estate I could reach is headless with no desktop environment installed, so there is nowhere to actually launch the GUI right now. Did not install Xvfb/X11 packages on r2d2 to force it, since that's Michal's daily workstation, not a disposable test box, and installing packages there wasn't asked for. So Linux support is claimed on a checksum-verified, correctly-built artifact and a specific expected failure mode (missing display), not an observed running instance. Green CI on this PR is not additional evidence beyond the above — it builds and lints the site, it doesn't launch any of the three binaries. Verified locally before pushing: npm run build (6 pages), npm run test:harness (9/9 Playwright checks — CSP, footer, SEO, 404, theme toggle, header download link), and an anchored grep across dist/ with a positive control (macOS/Windows/Linux counts: 3->26, 0->18, 0->18). Does not touch .github/workflows/site.yml or deploy.yml. Co-Authored-By: Claude Sonnet 5 Claude-Session: https://claude.ai/code/session_01EQYeUULNUFx2m5nm6fCLwj --- site/public/llms.txt | 4 ++- site/src/components/Head.astro | 2 +- site/src/consts.ts | 4 +-- site/src/pages/contact.astro | 6 ++-- site/src/pages/docs.astro | 63 ++++++++++++++++++++++++++-------- site/src/pages/index.astro | 35 +++++++++++++++---- site/src/pages/privacy.astro | 11 +++--- 7 files changed, 91 insertions(+), 34 deletions(-) diff --git a/site/public/llms.txt b/site/public/llms.txt index bb5f037..6f1b130 100644 --- a/site/public/llms.txt +++ b/site/public/llms.txt @@ -9,9 +9,11 @@ ## Docs - [Quick Start](https://tomatick.us/docs/): install and use every feature — timer, stopwatch, pomodoro, alarms, presets, hotkey, Focus/DND, settings sync. +Available for macOS (Apple Silicon), Windows (x86_64), and Linux (x86_64). All builds are unsigned. + ## Source & downloads - [GitHub repository](https://github.com/MichalAFerber/tomatick2): source code (Go), issues, releases. -- [Releases](https://github.com/MichalAFerber/tomatick2/releases): download the latest `.zip` (macOS, Apple Silicon). +- [Releases](https://github.com/MichalAFerber/tomatick2/releases): download the latest `.zip` (macOS), `.exe` (Windows), or `.tar.xz` (Linux). ## Policies - [Privacy Policy](https://tomatick.us/privacy/): local-only data; cookieless, self-hosted Plausible analytics on the site. diff --git a/site/src/components/Head.astro b/site/src/components/Head.astro index a8f5e93..5dffd42 100644 --- a/site/src/components/Head.astro +++ b/site/src/components/Head.astro @@ -33,7 +33,7 @@ const jsonLd = name: SITE.name, url: SITE.url, applicationCategory: 'UtilitiesApplication', - operatingSystem: 'macOS', + operatingSystem: ['macOS', 'Windows', 'Linux'], offers: { '@type': 'Offer', price: '0', priceCurrency: 'USD' }, description: SITE.description, author: { '@type': 'Person', name: SITE.author, url: SITE.authorUrl }, diff --git a/site/src/consts.ts b/site/src/consts.ts index c561226..5967b4b 100644 --- a/site/src/consts.ts +++ b/site/src/consts.ts @@ -7,8 +7,8 @@ export const SITE = { description: 'A menu bar timer, stopwatch, alarm and pomodoro in one icon, with a timestamped ' + 'history of every run. Rewritten in Go as a single binary. Open source, MIT, no tracking.', - // The Go rewrite (tomatick2) is the current product and where releases ship from. - // This repo (tomatick) still hosts the site and the original macOS-only Python app. + // This site and its releases both live here now (tomatick2, the Go rewrite). + // legacyRepo below is the original macOS-only Python app and its own site history. repo: 'https://github.com/MichalAFerber/tomatick2', releases: 'https://github.com/MichalAFerber/tomatick2/releases', legacyRepo: 'https://github.com/MichalAFerber/tomatick', diff --git a/site/src/pages/contact.astro b/site/src/pages/contact.astro index dbefe6a..2a821f4 100644 --- a/site/src/pages/contact.astro +++ b/site/src/pages/contact.astro @@ -22,9 +22,9 @@ import { SITE, SUPPORT_EMAIL, MAILER_PRODUCT } from '../consts'; 24–48 hours.

- {SITE.name} runs entirely on your Mac, so a bug report is far easier to act on with the - details: your macOS version, the {SITE.name} version from the menu bar, and what you were - doing when it happened. + {SITE.name} runs entirely on your device, so a bug report is far easier to act on with the + details: your OS and version (macOS, Windows, or Linux), the {SITE.name} version from the + menu bar, and what you were doing when it happened.

diff --git a/site/src/pages/docs.astro b/site/src/pages/docs.astro index eb619a3..9f5e64a 100644 --- a/site/src/pages/docs.astro +++ b/site/src/pages/docs.astro @@ -4,7 +4,7 @@ import { SITE } from '../consts'; --- @@ -13,16 +13,19 @@ import { SITE } from '../consts';

Quick Start

A menu bar timer, stopwatch, alarm and pomodoro — all in one - icon, with a timestamped history of everything you run. Rewritten from the + icon, with a timestamped history of everything you run. Runs on + macOS, Windows, and Linux. Rewritten from the original Python app - as a single Go binary. + (macOS-only) as a single Go binary.

- Requirements: Apple Silicon Mac (M1/M2/M3/M4), a recent macOS. The - build is unsigned (no Apple Developer Program needed). + All three builds are unsigned — no Apple Developer Program, no code-signing + certificate. Each OS has its own one-time first-launch step; see below.

1. Install

+ +

macOS (Apple Silicon, M1–M4)

  1. Download the latest Tomatick-x.y.z-macos-arm64.zip from the Releases page.
  2. Unzip it and drag Tomatick.app onto the Applications folder.
    3. @@ -33,9 +36,33 @@ import { SITE } from '../consts'; 
    xattr -dr com.apple.quarantine /Applications/Tomatick.app
+ +

Windows (x86_64)

+
    +
  1. Download the latest Tomatick-x.y.z-windows-amd64.exe from the Releases page. There is no installer — run the .exe directly, from wherever you saved it.
    2. +
  2. + First launch only: SmartScreen will warn that the publisher is unknown, + because the build is unsigned. Click More info → Run anyway. +
    3. +
+ +

Linux (x86_64)

+
    +
  1. Download the latest Tomatick-x.y.z-linux-amd64.tar.xz from the Releases page.
    2. +
  2. + 
    tar -xJf Tomatick-x.y.z-linux-amd64.tar.xz
+cd tomatick
+sudo make install     # or: make user-install  (installs under ~/.local)
    + Installs the binary, a .desktop entry, and the icon. No signing step. +
    3. +
  3. A tray host that speaks StatusNotifierItem / AppIndicator is required to see the menu bar + icon (GNOME needs an extension; KDE and most other desktops work out of the box).
    4. +
+

- Tomatick is a menu bar app — there's no Dock icon and no window. Look for - the 🍅 (or stopwatch) icon in the top-right menu bar. Click it for everything. + Tomatick is a menu bar / system tray app — there's no taskbar window. Look for + the 🍅 (or stopwatch) icon in the menu bar (macOS), notification area (Windows), or system + tray (Linux). Click it for everything.

2. Start something

@@ -75,10 +102,12 @@ import { SITE } from '../consts'; -

5. Focus / Do-Not-Disturb during work

+

5. Focus / Do-Not-Disturb during work (macOS only)

Tomatick can turn a macOS Focus on during a pomodoro work phase - and off on breaks. macOS has no public API for this, so it runs Shortcuts you create: + and off on breaks. macOS has no public API for this, so it runs Shortcuts you create. + This feature does not exist on Windows or Linux — there's no equivalent OS-level Focus/DND API + to hook into, so the setting is a no-op there.

  1. Open Shortcuts → + for a new shortcut.
    2. @@ -91,25 +120,29 @@ import { SITE } from '../consts';

    6. Global hotkey

    Settings → General → Global hotkey: pick an action (Start Pomodoro, - Start Timer, or Toggle Keep Awake) and a key (e.g. ⌥⌘P). The first use prompts for - Accessibility permission (System Settings → Privacy & Security → Accessibility). + Start Timer, or Toggle Keep Awake) and a key (e.g. ⌥⌘P). On macOS the first use + prompts for Accessibility permission (System Settings → Privacy & Security → + Accessibility).

    7. Keep Awake

    Menu → Keep awake prevents sleep while it's on. Bindable to the hotkey; turns itself off on quit.

    -

    8. Copy your setup to another Mac

    +

    8. Copy your setup to another device

    1. Settings → General → Export Settings… → save the .json.
      2. -
    2. On the other Mac: Import Settings… → pick that file.
      3. +
    3. On the other device: Import Settings… → pick that file.

    This copies presets, pomodoro lengths, sounds, snooze, Focus shortcut names, hotkey, and alarms. (Launch-at-login stays per-machine.)

    Where your data lives

    - 
    ~/Library/Application Support/Tomatick/
+      
    macOS:    ~/Library/Application Support/Tomatick/
+Windows:  %AppData%\Tomatick\
+Linux:    $XDG_DATA_HOME/Tomatick/ (or ~/.local/share/Tomatick/)
+
 ├── config.json     # all settings, presets, alarms
 └── history.db      # SQLite event history
    
-      
    It never leaves your Mac. See the Privacy Policy for the details.
    
+      
    It never leaves your device. See the Privacy Policy for the details.
    
 
       
    Questions or bugs? See the GitHub repository.
    
     
diff --git a/site/src/pages/index.astro b/site/src/pages/index.astro
index 17b3b84..50f01b3 100644
--- a/site/src/pages/index.astro
+++ b/site/src/pages/index.astro
@@ -6,13 +6,19 @@ import { SITE } from '../consts';
 const features = [
   { icon: '⏱', title: 'Timer', body: 'Natural durations — 25m, 1h30m, 90s, 2:30. Live M:SS countdown right in the menu bar. It keeps ringing until you dismiss it.' },
   { icon: '⏲', title: 'Stopwatch', body: 'Counts up with laps. Pause, resume, reset — all from the menu.' },
-  { icon: '🍅', title: 'Pomodoro', body: '25 / 5 / 15 by default, auto-advancing work ↔ break, long break every 4th cycle. Optional Focus/DND during work.' },
+  { icon: '🍅', title: 'Pomodoro', body: '25 / 5 / 15 by default, auto-advancing work ↔ break, long break every 4th cycle. Optional Focus/DND during work (macOS only).' },
   { icon: '🔔', title: 'Alarms', body: 'One-shot (a date + time) or recurring (a time on chosen weekdays). Looping sound + notification, with snooze.' },
   { icon: '🧭', title: 'Run several at once', body: 'Multiple sessions together; the menu bar shows your pinned one live, everything else listed with its own count.' },
   { icon: '🗂', title: 'Timestamped history', body: 'Every event logged to SQLite. Browse recent runs, export the full log to CSV or JSON.' },
 ];
 
-const badges = ['Open source', 'MIT licensed', 'No data leaves your Mac', 'Single Go binary'];
+const platforms = [
+  { icon: '🍎', title: 'macOS', body: 'Apple Silicon (M1–M4). Unsigned — right-click → Open on first launch.' },
+  { icon: '🪟', title: 'Windows', body: 'x86_64. Unsigned — SmartScreen: More info → Run anyway on first launch.' },
+  { icon: '🐧', title: 'Linux', body: 'x86_64, .tar.xz. No signing step — install and run.' },
+];
+
+const badges = ['Open source', 'MIT licensed', 'macOS · Windows · Linux', 'Single Go binary'];
 ---
 
       
    
         Tomatick is a menu bar timer, stopwatch, alarm and
-        pomodoro — with a timestamped history of everything you run. Rewritten
-        from the original Python app as a single Go binary.
+        pomodoro — with a timestamped history of everything you run. Runs on
+        macOS, Windows, and Linux — rewritten from the
+        original Python (macOS-only) app as a single Go binary.
       
    
       
    
-        ↓ Download for macOS
+        ↓ Download
         Quick Start
       
    
       
      
         {badges.map((b) => 
    • {b}
      • )}
       
    
-      
    macOS, Apple Silicon (M1–M4) · unsigned build, no Apple Developer Program needed.
    
+      
    All builds are unsigned — see Quick Start for the one-time first-launch step on your OS.
    
+    
+  
+
+  
+  
    
+    
    Available for macOS, Windows, and Linux
    
+    
    
+      {platforms.map((p) => (
+        
    
+          
+          
    {p.title}
    
+          
    {p.body}
    
+        
    
+      ))}
     
    
   
    
 
@@ -62,7 +83,7 @@ const badges = ['Open source', 'MIT licensed', 'No data leaves your Mac', 'Singl
     
    
       
    Everything from the menu bar
    
       
    
-        No Dock icon, no window. Start a session and it shows up in the menu — click it to
+        No taskbar window. Start a session and it shows up in the menu — click it to
         pause, stop, or dismiss. Your settings, presets and alarms sync via a simple export/import.
       
    
       
    
diff --git a/site/src/pages/privacy.astro b/site/src/pages/privacy.astro
index 5d4fb36..e8ab6a9 100644
--- a/site/src/pages/privacy.astro
+++ b/site/src/pages/privacy.astro
@@ -10,17 +10,18 @@ const updated = 'July 2026';
       
    Last updated: {updated}
    
 
       
    
-        Short version: the Tomatick app stores everything locally on your Mac —
+        Short version: the Tomatick app stores everything locally on your device —
         nothing is uploaded, no account, no server-side processing. This website uses privacy-friendly,
         cookieless analytics and collects no personal information.
       
    
 
       
    The Tomatick app
    
       
    
-        Tomatick runs entirely on your Mac. Your settings, presets, alarms and event history are stored
-        in ~/Library/Application Support/Tomatick/ and never leave your
-        device. There are no accounts, no telemetry, and no network calls to us. If you use the
-        Export Settings / Export History features, the resulting files go wherever you choose to save them.
+        Tomatick runs entirely on your device (macOS, Windows, or Linux). Your settings, presets,
+        alarms and event history are stored locally — see Quick Start for the
+        exact folder on your OS — and never leave your device. There are no accounts,
+        no telemetry, and no network calls to us. If you use the Export Settings / Export History
+        features, the resulting files go wherever you choose to save them.
       
    
 
       
    This website (tomatick.us)