Add pause button

Author: Sammeeeeeeee

.github/workflows/build.yml

@@ -17,6 +17,22 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      # ── On a tag push, drop a placeholder release immediately so the Releases
+      # page shows "🚧 Building…" while CI is still running. We update it with
+      # the real assets at the end. If anything fails, the draft remains visible
+      # for the maintainer to delete or retry.
+      - name: Create placeholder release
+        if: startsWith(github.ref, 'refs/tags/v')
+        uses: softprops/action-gh-release@v2
+        with:
+          tag_name: ${{ github.ref_name }}
+          name: "🚧 ${{ github.ref_name }} — Building…"
+          body: |
+            Build is in progress. The portable `.exe` and `Setup.exe` will appear here once CI completes (usually a few minutes).
+            See the [Actions tab](../../actions) for live progress.
+          draft: true
+          prerelease: false
+
       - name: Set up .NET 8
         uses: actions/setup-dotnet@v4
         with:
@@ -51,13 +67,20 @@ jobs:
           path: installer/Output/Twenti-Setup.exe
           if-no-files-found: error
 
-      - name: Create GitHub Release on tag
+      # ── Final step on tag push: replace the "Building…" placeholder with the
+      # real release containing both the portable .exe and the Setup .exe as
+      # raw downloadable files (NOT zipped — the workflow-artifact zips above
+      # are just for non-tag CI runs).
+      - name: Publish release
         if: startsWith(github.ref, 'refs/tags/v')
         uses: softprops/action-gh-release@v2
         with:
+          tag_name: ${{ github.ref_name }}
+          name: ${{ github.ref_name }}
           files: |
             publish/Twenti.exe
             installer/Output/Twenti-Setup.exe
+          draft: false
           generate_release_notes: true
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

App.xaml.cs

@@ -1,4 +1,6 @@
 using System;
+using System.Diagnostics;
+using System.Threading.Tasks;
 using H.NotifyIcon;
 using Microsoft.UI.Dispatching;
 using Microsoft.UI.Xaml;
@@ -15,6 +17,7 @@ public partial class App : Application
     public BreakStateMachine StateMachine { get; private set; } = null!;
     public SoundEngine Sound { get; private set; } = null!;
     public ThemeListener Theme { get; private set; } = null!;
+    public AppSettings Settings { get; private set; } = null!;
     public DispatcherQueue UIQueue { get; private set; } = null!;
 
     private TaskbarIcon? _trayIcon;
@@ -34,7 +37,8 @@ protected override void OnLaunched(LaunchActivatedEventArgs args)
 
         _ownerWindow = new MainWindow();
 
-        Sound = new SoundEngine();
+        Settings = AppSettings.Load();
+        Sound = new SoundEngine { Muted = Settings.Muted };
         Theme = new ThemeListener();
         StateMachine = new BreakStateMachine(UIQueue);
 
@@ -56,6 +60,48 @@ protected override void OnLaunched(LaunchActivatedEventArgs args)
 
         StateMachine.Start();
         RefreshTray();
+
+        if (Settings.CheckForUpdates)
+        {
+            _ = Task.Delay(TimeSpan.FromSeconds(5)).ContinueWith(_ => CheckForUpdatesAsync(silentIfNone: true));
+        }
+    }
+
+    private async Task CheckForUpdatesAsync(bool silentIfNone)
+    {
+        var info = await new UpdateChecker().CheckAsync().ConfigureAwait(false);
+        UIQueue.TryEnqueue(() =>
+        {
+            if (info is null)
+            {
+                if (!silentIfNone) ShowToast("You're on the latest version.");
+                return;
+            }
+
+            if (_trayIcon is null) return;
+            _trayIcon.ShowNotification(
+                title: $"Twenti {info.LatestVersion} is available",
+                message: "Click to open the release page.",
+                timeout: TimeSpan.FromSeconds(10));
+
+            // The first left-click after the toast also takes them there.
+            _trayIcon.LeftClickCommand = new RelayCommand(() =>
+            {
+                _trayIcon.LeftClickCommand = new RelayCommand(OnTrayLeftClick);
+                OpenUrl(info.ReleaseUrl);
+            });
+        });
+    }
+
+    private void ShowToast(string message)
+    {
+        _trayIcon?.ShowNotification("Twenti", message, timeout: TimeSpan.FromSeconds(4));
+    }
+
+    private static void OpenUrl(string url)
+    {
+        try { Process.Start(new ProcessStartInfo(url) { UseShellExecute = true }); }
+        catch { /* ignore */ }
     }
 
     private MenuFlyout BuildContextMenu()
@@ -71,9 +117,30 @@ private MenuFlyout BuildContextMenu()
         menu.Items.Add(new MenuFlyoutSeparator());
 
         var muteItem = new ToggleMenuFlyoutItem { Text = "Mute sounds", IsChecked = Sound.Muted };
-        muteItem.Click += (_, _) => Sound.Muted = muteItem.IsChecked;
+        muteItem.Click += (_, _) =>
+        {
+            Sound.Muted = muteItem.IsChecked;
+            Settings.Muted = muteItem.IsChecked;
+            Settings.Save();
+        };
         menu.Items.Add(muteItem);
 
+        var updateToggle = new ToggleMenuFlyoutItem
+        {
+            Text = "Check for updates",
+            IsChecked = Settings.CheckForUpdates,
+        };
+        updateToggle.Click += (_, _) =>
+        {
+            Settings.CheckForUpdates = updateToggle.IsChecked;
+            Settings.Save();
+        };
+        menu.Items.Add(updateToggle);
+
+        var checkNow = new MenuFlyoutItem { Text = "Check for updates now" };
+        checkNow.Click += async (_, _) => await CheckForUpdatesAsync(silentIfNone: false);
+        menu.Items.Add(checkNow);
+
         menu.Items.Add(new MenuFlyoutSeparator());
 
         var quit = new MenuFlyoutItem

README.md

@@ -1,36 +1,40 @@
 # Twenti — 20/20 Eye Break Reminder
 
-A Windows 11 native eye-break reminder. Lives in the system tray, counts down your work interval, surfaces a calm break prompt, and gets out of the way.
+[![Build](https://github.com/Sammeeeeeeee/Twenti/actions/workflows/build.yml/badge.svg)](https://github.com/Sammeeeeeeee/Twenti/actions/workflows/build.yml)
 
-Built with **WinUI 3** (Windows App SDK) — same stack as PowerToys and the Windows 11 Settings app, so it looks and feels truly native (Mica + Acrylic backdrops, official Fluent tokens, real WinUI menus).
+A Windows 11 native eye-break reminder. 
 
-## Surfaces
+## What is the 20/20/20 rule?
 
-1. **Tray icon** — the only persistent UI. Shows minutes left in green, switches to yellow under 2 min, pulses yellow during the 5-second pre-ping, eye glyph during the break, grey while snoozed.
-2. **Tray flyout** (left-click) — acrylic flyout with the live countdown, "Start break now" button, and quick snooze options. Slides up from the tray on click and auto-opens during the pre-ping.
-3. **Break popup** (when the timer fires) — centered Mica card with two states: prompt (`[Start 20 sec]` / `[Snooze]`) and timer (big 56px countdown with progress bar).
+The [20/20/20 rule]() is a [proven tecnique](https://pubmed.ncbi.nlm.nih.gov/36473088/) to prevent eye strain, dryness and degradation. 
 
-The 3rd break in every cycle is a long 2-minute break instead of the usual 20 seconds.
+## Twenti
 
-## Keyboard (while the popup is focused)
+Built with **WinUI 3** (Windows App SDK), this aims to be native and light, to be as unabtrusive as possbile, but easily acessible. 
+It lives in the trey, with the minutes left as countdown. A flyut on click shows more information. Every 20 minutes, a pop up appearsin the centre of your screen. You can choose to delay, or press enter to start the countdown (optional: accmpanied by white nose). Every 3rd pop up is for 2 minutes. 
+
+### Keyboard (while the popup is focused)
 
 - `Enter` — start the break timer
 - `Esc` — snooze 5 minutes
 - `1`–`9` — snooze N minutes
 
-## Right-click on the tray icon
+### Right-click on the tray icon
 
-Snooze 5 / 15 / 30 minutes · Mute or Unmute sounds · Quit
+Snooze 5 / 15 / 30 minutes · Mute or Unmute sounds 
 
-## Sounds (synthesised, no audio files)
+### Sounds (mutable)
 
 - Soft 1318 Hz pre-ping 5 seconds before
 - Warm 3-note chime when the popup appears
 - Brown-noise water ambient during the break
 - Rising 3-note resolution when the break completes
 - Descending 2-note acknowledgement when snoozed
 
-All produced live by NAudio — no `.wav` files shipped.
+## Pre-built downloads
+
+- **Recommended → [Releases](../../releases)**.`Twenti.exe` (portable) and `Twenti-Setup.exe` (installer).
+- **Latest dev build** — pull from the most recent [Actions run](../../actions). 
 
 ## Build & run from source
 
@@ -42,15 +46,15 @@ dotnet build
 dotnet run
 ```
 
-The app starts straight into the system tray — no main window appears.
+The app starts straight into the system tray.
 
 ## Build a portable single-file exe
 
 ```pwsh
 dotnet publish -c Release -r win-x64 -o publish
 ```
 
-Output: `publish\Twenti.exe`. The Windows App SDK runtime is bundled — the exe runs on a clean Windows 11 box without any prerequisites.
+Output: `publish\Twenti.exe`. The Windows App SDK runtime is bundled.
 
 ## Build the installer
 
@@ -59,37 +63,4 @@ dotnet publish -c Release -r win-x64 -o publish
 & "${env:ProgramFiles(x86)}\Inno Setup 6\ISCC.exe" installer\Twenti.iss
 ```
 
-Output: `installer\Output\Twenti-Setup.exe`. Installs into Program Files, adds a Start Menu entry, optionally runs at login.
-
-## Pre-built downloads
-
-Every push to `main` builds both the portable exe and the installer in CI.
-
-- **Latest** — pull artifacts from the latest [Actions run](../../actions).
-- **Release** — push a `vX.Y.Z` tag, GitHub Actions automatically attaches both files to the new release.
-
-## Project layout
-
-```
-Twenti/
-├── .github/workflows/build.yml    # CI: portable exe + Inno Setup installer
-├── installer/Twenti.iss           # Inno Setup script
-├── Twenti.csproj
-├── app.manifest                   # PerMonitorV2 DPI awareness
-├── Program.cs                     # [STAThread] Main, single-instance mutex
-├── App.xaml(.cs)                  # Tray icon + service wiring
-├── MainWindow.xaml(.cs)           # Hidden owner window, off-screen
-├── Views/
-│   ├── BreakPopup.xaml(.cs)       # 380px Mica card popup
-│   ├── TrayFlyout.xaml(.cs)       # 240px Acrylic flyout
-│   └── ThemedResources.xaml       # Status colour brushes (light/dark)
-└── Services/
-    ├── BreakStateMachine.cs       # Phase + tick + 3-cycle rhythm
-    ├── SoundEngine.cs             # NAudio synthesis (5 cues + ambient)
-    ├── TrayIconRenderer.cs        # Runtime ICO generation per state
-    └── ThemeListener.cs           # UISettings.ColorValuesChanged hook
-```
-
-## License
-
-[MIT](LICENSE)
+Output: `installer\Output\Twenti-Setup.exe`. Installs as user or system wide. Adds a Start Menu entry, optionally runs at login.

Services/AppSettings.cs

@@ -0,0 +1,46 @@
+using System;
+using System.IO;
+using System.Text.Json;
+
+namespace Twenti.Services;
+
+public sealed class AppSettings
+{
+    public bool CheckForUpdates { get; set; } = true;
+    public bool Muted { get; set; } = false;
+
+    private static readonly string SettingsPath = Path.Combine(
+        Environment.GetFolderPath(Environment.SpecialFolder.LocalApplicationData),
+        "Twenti", "settings.json");
+
+    public static AppSettings Load()
+    {
+        try
+        {
+            if (File.Exists(SettingsPath))
+            {
+                var json = File.ReadAllText(SettingsPath);
+                return JsonSerializer.Deserialize<AppSettings>(json) ?? new AppSettings();
+            }
+        }
+        catch
+        {
+            // ignore — fall through to defaults
+        }
+        return new AppSettings();
+    }
+
+    public void Save()
+    {
+        try
+        {
+            Directory.CreateDirectory(Path.GetDirectoryName(SettingsPath)!);
+            var json = JsonSerializer.Serialize(this, new JsonSerializerOptions { WriteIndented = true });
+            File.WriteAllText(SettingsPath, json);
+        }
+        catch
+        {
+            // ignore — non-critical
+        }
+    }
+}

Services/UpdateChecker.cs

@@ -0,0 +1,87 @@
+using System;
+using System.Net.Http;
+using System.Reflection;
+using System.Text.Json;
+using System.Threading.Tasks;
+
+namespace Twenti.Services;
+
+public sealed class UpdateInfo
+{
+    public required string LatestVersion { get; init; }
+    public required string CurrentVersion { get; init; }
+    public required string ReleaseUrl { get; init; }
+    public required string ReleaseNotes { get; init; }
+}
+
+public sealed class UpdateChecker
+{
+    private const string ReleasesApi = "https://api.github.com/repos/Sammeeeeeeee/Twenti/releases/latest";
+
+    private static readonly HttpClient Http;
+
+    static UpdateChecker()
+    {
+        Http = new HttpClient { Timeout = TimeSpan.FromSeconds(10) };
+        Http.DefaultRequestHeaders.UserAgent.ParseAdd("Twenti-UpdateChecker/1.0");
+        Http.DefaultRequestHeaders.Accept.ParseAdd("application/vnd.github+json");
+    }
+
+    public static string CurrentVersion =>
+        Assembly.GetEntryAssembly()?.GetName().Version?.ToString(3) ?? "0.0.0";
+
+    public async Task<UpdateInfo?> CheckAsync()
+    {
+        try
+        {
+            var json = await Http.GetStringAsync(ReleasesApi).ConfigureAwait(false);
+            using var doc = JsonDocument.Parse(json);
+            var root = doc.RootElement;
+
+            string tag = root.GetProperty("tag_name").GetString() ?? "";
+            string url = root.GetProperty("html_url").GetString() ?? "";
+            string body = root.TryGetProperty("body", out var bp) ? (bp.GetString() ?? "") : "";
+
+            string latest = tag.TrimStart('v', 'V').Trim();
+            string current = CurrentVersion;
+
+            if (IsNewer(latest, current))
+            {
+                return new UpdateInfo
+                {
+                    LatestVersion = latest,
+                    CurrentVersion = current,
+                    ReleaseUrl = url,
+                    ReleaseNotes = body,
+                };
+            }
+        }
+        catch
+        {
+            // Network error / repo missing / rate-limited — silent fail.
+        }
+        return null;
+    }
+
+    private static bool IsNewer(string latest, string current)
+    {
+        if (Version.TryParse(Pad(latest), out var l) && Version.TryParse(Pad(current), out var c))
+        {
+            return l > c;
+        }
+        return !string.IsNullOrEmpty(latest) && !string.Equals(latest, current, StringComparison.OrdinalIgnoreCase);
+    }
+
+    // Version.TryParse needs at least Major.Minor — pad single-component strings.
+    private static string Pad(string v)
+    {
+        int dots = 0;
+        foreach (var ch in v) if (ch == '.') dots++;
+        return dots switch
+        {
+            0 => v + ".0.0",
+            1 => v + ".0",
+            _ => v,
+        };
+    }
+}