From 3683e75a1702357ab361386413ecbd9ada415e25 Mon Sep 17 00:00:00 2001
From: Stone_Red <56473591+Stone-Red-Code@users.noreply.github.com>
Date: Tue, 21 Apr 2026 01:49:47 +0200
Subject: [PATCH] Add update dialog showing latest release info after app
 update

---
 src/DesktopMagic/App.xaml                     |  7 +-
 src/DesktopMagic/DesktopMagic.csproj          |  3 +-
 .../Dialogs/ReleaseInfoDialog.xaml            | 48 +++++++++++
 .../Dialogs/ReleaseInfoDialog.xaml.cs         | 40 +++++++++
 .../Helpers/GitHubReleaseService.cs           | 51 ++++++++++++
 src/DesktopMagic/MainWindow.xaml.cs           | 82 ++++++++++++++++++-
 .../Resources/Strings/StringResources.de.xaml |  7 +-
 .../Resources/Strings/StringResources.en.xaml |  7 +-
 .../Settings/DesktopMagicSettings.cs          |  4 +-
 9 files changed, 241 insertions(+), 8 deletions(-)
 create mode 100644 src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml
 create mode 100644 src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml.cs
 create mode 100644 src/DesktopMagic/Helpers/GitHubReleaseService.cs

diff --git a/src/DesktopMagic/App.xaml b/src/DesktopMagic/App.xaml
index 83dca8a..85b7129 100644
--- a/src/DesktopMagic/App.xaml
+++ b/src/DesktopMagic/App.xaml
@@ -1,5 +1,6 @@
-<Application x:Class="DesktopMagic.App"
+<Application x:Class="DesktopMagic.App"
              xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+             xmlns:md="http://schemas.lepo.co/wpfui/2022/xaml/markdown"
              xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
              xmlns:helpers="clr-namespace:DesktopMagic.Helpers"
              xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
@@ -10,6 +11,8 @@
                 <ResourceDictionary Source="Resources\Strings\StringResources.en.xaml" />
                 <ui:ThemesDictionary Theme="Light" />
                 <ui:ControlsDictionary />
+                <md:ThemesDictionary Theme="Light" />
+                <md:ControlsDictionary />
                 <ResourceDictionary Source="pack://application:,,,/BusyIndicator;component/Theme/Default.xaml" />
                 <ResourceDictionary Source="Resources\Images\ImageResources.xaml" />
                 <ResourceDictionary Source="Resources\Styles\ToggleSwitchContentLeftStyle.xaml" />
@@ -22,4 +25,4 @@
             <Thickness x:Key="DefaultMargin" Top="5" Left="5" Right="5" Bottom ="5" />
         </ResourceDictionary>
     </Application.Resources>
-</Application>
\ No newline at end of file
+</Application>
diff --git a/src/DesktopMagic/DesktopMagic.csproj b/src/DesktopMagic/DesktopMagic.csproj
index 60c67c3..bc1d2c3 100644
--- a/src/DesktopMagic/DesktopMagic.csproj
+++ b/src/DesktopMagic/DesktopMagic.csproj
@@ -52,6 +52,7 @@
         <PackageReference Include="NAudio" Version="2.2.1" />
         <PackageReference Include="System.Management" Version="8.0.0" />
         <PackageReference Include="WPF-UI" Version="4.2.0" />
+        <PackageReference Include="WPF-UI.Markdown" Version="4.0.2" />
         <PackageReference Include="WPF-UI.Tray" Version="4.2.0" />
     </ItemGroup>
 
@@ -75,4 +76,4 @@
         <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
       </None>
     </ItemGroup>
-</Project>
\ No newline at end of file
+</Project>
diff --git a/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml b/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml
new file mode 100644
index 0000000..0ac8655
--- /dev/null
+++ b/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml
@@ -0,0 +1,48 @@
+<ui:FluentWindow x:Class="DesktopMagic.Dialogs.ReleaseInfoDialog"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:md="http://schemas.lepo.co/wpfui/2022/xaml/markdown"
+        xmlns:ui="http://schemas.lepo.co/wpfui/2022/xaml"
+        xmlns:d="http://schemas.microsoft.com/expression/blend/2008"
+        xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"
+        mc:Ignorable="d"
+        ui:Design.Background="{DynamicResource ApplicationBackgroundBrush}"
+        ui:Design.Foreground="{DynamicResource TextFillColorPrimaryBrush}"
+        Foreground="{DynamicResource TextFillColorPrimaryBrush}"
+        WindowCornerPreference="Round"
+        WindowBackdropType="Tabbed"
+        Height="700"
+        Width="900"
+        MinHeight="500"
+        MinWidth="700"
+        WindowStartupLocation="CenterOwner"
+        ExtendsContentIntoTitleBar="True">
+    <Grid>
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="*" />
+            <RowDefinition Height="Auto" />
+        </Grid.RowDefinitions>
+
+        <ui:TitleBar x:Name="titleBar" ShowMinimize="False" ShowMaximize="False">
+            <ui:TitleBar.Icon>
+                <ui:ImageIcon Source="{StaticResource Icon}" />
+            </ui:TitleBar.Icon>
+        </ui:TitleBar>
+
+        <StackPanel Grid.Row="1" Margin="14,10,14,0">
+            <TextBlock x:Name="releaseNameTextBlock" FontSize="20" FontWeight="SemiBold" />
+            <TextBlock x:Name="publishedAtTextBlock" Foreground="{DynamicResource TextFillColorSecondaryBrush}" Margin="0,4,0,0" />
+        </StackPanel>
+
+        <Border Grid.Row="2" Margin="14,12,14,12" BorderBrush="{DynamicResource ControlStrokeColorDefaultBrush}" BorderThickness="1" CornerRadius="8">
+            <md:MarkdownViewer x:Name="releaseMarkdownViewer" Margin="8" />
+        </Border>
+
+        <StackPanel Grid.Row="3" Orientation="Horizontal" HorizontalAlignment="Right" Margin="14,0,14,12">
+            <Button x:Name="openButton" Width="150" Margin="0,0,8,0" Click="OpenButton_Click" />
+            <Button x:Name="okButton" Width="100" Click="OkButton_Click" />
+        </StackPanel>
+    </Grid>
+</ui:FluentWindow>
diff --git a/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml.cs b/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml.cs
new file mode 100644
index 0000000..7eb7bfa
--- /dev/null
+++ b/src/DesktopMagic/Dialogs/ReleaseInfoDialog.xaml.cs
@@ -0,0 +1,40 @@
+using System.Windows;
+
+namespace DesktopMagic.Dialogs;
+
+public partial class ReleaseInfoDialog : Wpf.Ui.Controls.FluentWindow
+{
+    public bool OpenReleaseRequested { get; private set; }
+
+    public ReleaseInfoDialog(
+        string title,
+        string releaseName,
+        string publishedAt,
+        string markdown,
+        string openButtonText,
+        string okButtonText)
+    {
+        InitializeComponent();
+
+        Resources.MergedDictionaries.Add(App.LanguageDictionary);
+
+        titleBar.Title = title;
+        Title = title;
+        releaseNameTextBlock.Text = releaseName;
+        publishedAtTextBlock.Text = publishedAt;
+        releaseMarkdownViewer.Markdown = string.IsNullOrWhiteSpace(markdown) ? "-" : markdown;
+        openButton.Content = openButtonText;
+        okButton.Content = okButtonText;
+    }
+
+    private void OpenButton_Click(object sender, RoutedEventArgs e)
+    {
+        OpenReleaseRequested = true;
+        DialogResult = true;
+    }
+
+    private void OkButton_Click(object sender, RoutedEventArgs e)
+    {
+        DialogResult = false;
+    }
+}
diff --git a/src/DesktopMagic/Helpers/GitHubReleaseService.cs b/src/DesktopMagic/Helpers/GitHubReleaseService.cs
new file mode 100644
index 0000000..6e74863
--- /dev/null
+++ b/src/DesktopMagic/Helpers/GitHubReleaseService.cs
@@ -0,0 +1,51 @@
+using System;
+using System.Net.Http;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+using System.Threading.Tasks;
+
+namespace DesktopMagic.Helpers;
+
+public sealed class GitHubLatestRelease
+{
+    [JsonPropertyName("tag_name")]
+    public string TagName { get; init; } = "Unknown";
+
+    [JsonPropertyName("name")]
+    public string Name { get; init; } = "Unknown";
+
+    [JsonPropertyName("body")]
+    public string Body { get; init; } = string.Empty;
+
+    [JsonPropertyName("published_at")]
+    public DateTimeOffset? PublishedAt { get; init; }
+
+    [JsonPropertyName("html_url")]
+    public string HtmlUrl { get; init; } = "https://github.com/Stone-Red-Code/DesktopMagic/releases/latest";
+}
+
+public static class GitHubReleaseService
+{
+    private const string LatestReleaseApiUrl = "https://api.github.com/repos/Stone-Red-Code/DesktopMagic/releases/latest";
+    private static readonly HttpClient _httpClient = CreateReleaseHttpClient();
+
+    private static HttpClient CreateReleaseHttpClient()
+    {
+        HttpClient client = new()
+        {
+            Timeout = TimeSpan.FromSeconds(10)
+        };
+
+        client.DefaultRequestHeaders.Accept.ParseAdd("application/vnd.github+json");
+        client.DefaultRequestHeaders.UserAgent.ParseAdd("DesktopMagic");
+        return client;
+    }
+
+    public static async Task<GitHubLatestRelease?> GetLatestReleaseInfoAsync()
+    {
+        using HttpResponseMessage response = await _httpClient.GetAsync(LatestReleaseApiUrl);
+        response.EnsureSuccessStatusCode();
+        await using var responseStream = await response.Content.ReadAsStreamAsync();
+        return await JsonSerializer.DeserializeAsync<GitHubLatestRelease>(responseStream);
+    }
+}
diff --git a/src/DesktopMagic/MainWindow.xaml.cs b/src/DesktopMagic/MainWindow.xaml.cs
index ea07060..4672d65 100644
--- a/src/DesktopMagic/MainWindow.xaml.cs
+++ b/src/DesktopMagic/MainWindow.xaml.cs
@@ -1,7 +1,13 @@
-using DesktopMagic.DataContexts;
+using DesktopMagic.DataContexts;
+using DesktopMagic.Dialogs;
+using DesktopMagic.Helpers;
 
 using System;
 using System.Diagnostics;
+using System.Net.Http;
+using System.Reflection;
+using System.Text.Json;
+using System.Threading.Tasks;
 using System.Windows;
 
 using Wpf.Ui.Appearance;
@@ -43,6 +49,7 @@ public partial class MainWindow : FluentWindow
 
             _manager.IsLoaded = true;
             _mainWindowDataContext.IsLoading = false;
+            await ShowLatestReleaseInfoAfterUpdateAsync();
 
             App.Logger.LogInfo("Application loaded", source: "MainWindow");
         }
@@ -190,4 +197,75 @@ public partial class MainWindow : FluentWindow
     {
         Quit();
     }
-}
\ No newline at end of file
+
+    private async Task ShowLatestReleaseInfoAfterUpdateAsync()
+    {
+        string currentVersion = Assembly.GetExecutingAssembly().GetName().Version?.ToString() ?? "0.0.0.0";
+        string? lastShownVersion = _manager.Settings.ReleaseInfoLastAppVersion;
+
+        if (string.Equals(lastShownVersion, currentVersion, StringComparison.Ordinal))
+        {
+            return;
+        }
+
+        GitHubLatestRelease? latestRelease = await GetLatestReleaseInfoAsync();
+        if (latestRelease is null)
+        {
+            return;
+        }
+
+        string releaseName = !string.IsNullOrWhiteSpace(latestRelease.Name) ? latestRelease.Name : latestRelease.TagName;
+        string publishedAt = latestRelease.PublishedAt?.ToLocalTime().ToString("g") ?? (string)FindResource("unknown");
+        string publishedAtText = string.Format((string)FindResource("releaseInfoPublishedFormat"), publishedAt);
+        string releaseNotesMarkdown = string.IsNullOrWhiteSpace(latestRelease.Body) ? "-" : latestRelease.Body.Trim();
+
+        ReleaseInfoDialog releaseInfoDialog = new(
+            (string)FindResource("releaseInfoTitle"),
+            releaseName,
+            publishedAtText,
+            releaseNotesMarkdown,
+            (string)FindResource("openReleasePage"),
+            (string)FindResource("ok"))
+        {
+            Owner = this,
+            Topmost = true
+        };
+
+        _ = releaseInfoDialog.ShowDialog();
+
+        if (releaseInfoDialog.OpenReleaseRequested)
+        {
+            ProcessStartInfo processStartInfo = new()
+            {
+                UseShellExecute = true,
+                FileName = latestRelease.HtmlUrl
+            };
+            _ = Process.Start(processStartInfo);
+        }
+
+        _manager.Settings.ReleaseInfoLastAppVersion = currentVersion;
+        _manager.SaveSettings();
+    }
+
+    private static async Task<GitHubLatestRelease?> GetLatestReleaseInfoAsync()
+    {
+        try
+        {
+            return await GitHubReleaseService.GetLatestReleaseInfoAsync();
+        }
+        catch (HttpRequestException ex)
+        {
+            App.Logger.LogError($"Failed to retrieve latest release information: {ex.Message}", source: "MainWindow");
+        }
+        catch (TaskCanceledException ex)
+        {
+            App.Logger.LogWarn($"Timed out while retrieving latest release information: {ex.Message}", source: "MainWindow");
+        }
+        catch (JsonException ex)
+        {
+            App.Logger.LogError($"Failed to parse latest release information: {ex.Message}", source: "MainWindow");
+        }
+
+        return null;
+    }
+}
diff --git a/src/DesktopMagic/Resources/Strings/StringResources.de.xaml b/src/DesktopMagic/Resources/Strings/StringResources.de.xaml
index 06be6cd..1fa8a43 100644
--- a/src/DesktopMagic/Resources/Strings/StringResources.de.xaml
+++ b/src/DesktopMagic/Resources/Strings/StringResources.de.xaml
@@ -60,9 +60,14 @@
     <system:String x:Key="addedFormat">Erstellt: {0}</system:String>
     <system:String x:Key="updatedFormat">Aktualisiert: {0}</system:String>
     <system:String x:Key="versionFormat">Version: {0}</system:String>
+    <system:String x:Key="releaseInfoTitle">DesktopMagic wurde aktualisiert!</system:String>
+    <system:String x:Key="releaseInfoHeaderFormat">Neueste Version: {0}</system:String>
+    <system:String x:Key="releaseInfoPublishedFormat">Veröffentlicht: {0}</system:String>
+    <system:String x:Key="releaseInfoBodyLabel">Release Notes:</system:String>
+    <system:String x:Key="openReleasePage">Release-Seite öffnen</system:String>
     <col:ArrayList x:Key="musicVisualizerOptionsComboboxItems">
         <system:String>Unten</system:String>
         <system:String>Mitte</system:String>
         <system:String>Oben</system:String>
     </col:ArrayList>
-</ResourceDictionary>
\ No newline at end of file
+</ResourceDictionary>
diff --git a/src/DesktopMagic/Resources/Strings/StringResources.en.xaml b/src/DesktopMagic/Resources/Strings/StringResources.en.xaml
index f1e0508..d003a1c 100644
--- a/src/DesktopMagic/Resources/Strings/StringResources.en.xaml
+++ b/src/DesktopMagic/Resources/Strings/StringResources.en.xaml
@@ -62,9 +62,14 @@
     <system:String x:Key="addedFormat">Added: {0}</system:String>
     <system:String x:Key="updatedFormat">Updated: {0}</system:String>
     <system:String x:Key="versionFormat">Version: {0}</system:String>
+    <system:String x:Key="releaseInfoTitle">DesktopMagic has been updated!</system:String>
+    <system:String x:Key="releaseInfoHeaderFormat">Latest release: {0}</system:String>
+    <system:String x:Key="releaseInfoPublishedFormat">Published: {0}</system:String>
+    <system:String x:Key="releaseInfoBodyLabel">Release notes:</system:String>
+    <system:String x:Key="openReleasePage">Open release page</system:String>
     <col:ArrayList x:Key="musicVisualizerOptionsComboboxItems">
         <system:String>Bottom</system:String>
         <system:String>Middle</system:String>
         <system:String>Top</system:String>
     </col:ArrayList>
-</ResourceDictionary>
\ No newline at end of file
+</ResourceDictionary>
diff --git a/src/DesktopMagic/Settings/DesktopMagicSettings.cs b/src/DesktopMagic/Settings/DesktopMagicSettings.cs
index 9cbb10d..1cb61f6 100644
--- a/src/DesktopMagic/Settings/DesktopMagicSettings.cs
+++ b/src/DesktopMagic/Settings/DesktopMagicSettings.cs
@@ -64,6 +64,8 @@ public class DesktopMagicSettings : INotifyPropertyChanged
 
     public string? ModIoAccessToken { get; set; }
 
+    public string? ReleaseInfoLastAppVersion { get; set; }
+
     public DesktopMagicSettings()
     {
         themes.CollectionChanged += (s, e) => CurrentLayout.UpdateTheme();
@@ -76,4 +78,4 @@ public class DesktopMagicSettings : INotifyPropertyChanged
     {
         PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(name));
     }
-}
\ No newline at end of file
+}