Logging Infrastructure / Normalize Paths

- Added base logging infrastructure
- Create scan log during library/game scan in %ProgramData%\CreamInstaller\scan.log
- Normalize Steam library paths (libraryfolders.vdf) using Path.GetFullPath + ResolvePath to handle slashes, casing, and drive changes
- Diagnostics.ResolvePath: wrap GetFileSystemInfos in try/catch and guard against empty results to prevent IndexOutOfRangeException (May assist with issues on slow or intermittently accessible external drives)

.github/ISSUE_TEMPLATE/a-bug-report.md

@@ -1,10 +1,40 @@
 ---
 name: Bug Report
-about: Report a program exception or general bug, not including those explained within the FAQ and/or template issues.
-title: ''
+about: Report a program exception or general bug (not covered in FAQ or existing issues)
+title: '[Bug] - '
 labels: Bug
-assignees: pointfeev
+assignees: FroggMaster
 
 ---
 
-###### Describe the bug and/or provide an image of the exception dialog box:
+## Bug Description
+<!-- Provide a clear and concise description of what the bug is -->
+
+
+## Steps to Reproduce
+<!-- How can the issue be reproduced? -->
+1. 
+2. 
+3. 
+
+
+## Exception Details
+<!-- If you received an error dialog, provide a screenshot or paste the full error message below -->
+<details>
+<summary>Click to expand error message/screenshot</summary>
+
+```
+Paste error text here, or drag and drop screenshot below
+```
+
+</details>
+
+
+## Generated Config
+<!-- If a configuration was generated, please provide the configuration file -->
+
+
+
+## Affected Version
+<!-- Please specify the version of the application you experience the issue with -->
+- **CreamInstaller Version:** [e.g. v5.0.1.7, CI build #21]

.github/workflows/create-release.yml

@@ -62,6 +62,7 @@ jobs:
           tag_name: v${{ inputs.version }}
           name: ${{ inputs.title || format('Release v{0}', inputs.version) }}
           body: ${{ inputs.notes }}
+          generate_release_notes: true
           files: |
             ./publish/CreamInstaller.exe
             ./publish/CreamInstaller.zip

.github/workflows/dev-ci-builds.yml

@@ -0,0 +1,49 @@
+name: Dev CI Builds
+
+on:
+  push:
+    branches:
+      - dev
+  workflow_dispatch:
+
+jobs:
+  build:
+    runs-on: windows-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Setup .NET
+        uses: actions/setup-dotnet@v4
+        with:
+          dotnet-version: '8.0.x'
+
+      - name: Restore dependencies
+        run: dotnet restore CreamInstaller.sln
+
+      - name: Build Release
+        run: dotnet build CreamInstaller.sln --configuration Release --no-restore
+
+      - name: Publish single-file
+        run: dotnet publish CreamInstaller.sln -c Release -r win-x64 -p:PublishSingleFile=true --self-contained true --output ./publish
+
+      - name: Set short commit SHA and branch name
+        id: vars
+        run: |
+          $shortSha = $env:GITHUB_SHA.Substring(0,7)
+          $branch = $env:GITHUB_REF_NAME
+          Write-Output "shortSha=$shortSha" >> $env:GITHUB_ENV
+          Write-Output "branch=$branch" >> $env:GITHUB_ENV
+        shell: pwsh
+
+      - name: Rename EXE with branch and short commit SHA
+        run: |
+          Rename-Item -Path ./publish/CreamInstaller.exe -NewName "CreamInstaller-CI-$env:branch-$env:shortSha.exe"
+        shell: pwsh
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: CreamInstaller-CI-${{ env.branch }}-${{ env.shortSha }}
+          path: ./publish/CreamInstaller-CI-${{ env.branch }}-${{ env.shortSha }}.exe

CreamInstaller/Components/ContextMenuItem.cs

@@ -44,95 +44,85 @@ internal sealed class ContextMenuItem : ToolStripMenuItem
     }
 
     private static async Task TryImageIdentifier(ContextMenuItem item, string imageIdentifier)
-        => await Task.Run(async () =>
+    {
+        if (Images.TryGetValue(imageIdentifier, out Image image) && image is not null)
         {
-            if (Images.TryGetValue(imageIdentifier, out Image image) && image is not null)
-                item.Image = image;
-            else
+            item.Image = image;
+            return;
+        }
+
+        image = await Task.Run(async () =>
+        {
+            switch (imageIdentifier)
             {
-                switch (imageIdentifier)
-                {
-                    case "Paradox Launcher":
-                        if (ParadoxLauncher.InstallPath.DirectoryExists())
-                            foreach (string file in ParadoxLauncher.InstallPath.EnumerateDirectory("*.exe"))
-                            {
-                                image = file.GetFileIconImage();
-                                break;
-                            }
-
-                        break;
-                    case "Notepad":
-                        image = IconGrabber.GetNotepadImage();
-                        break;
-                    case "Command Prompt":
-                        image = IconGrabber.GetCommandPromptImage();
-                        break;
-                    case "File Explorer":
-                        image = IconGrabber.GetFileExplorerImage();
-                        break;
-                    case "SteamDB":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("steamdb.info"));
-                        break;
-                    case "Steam Store":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("store.steampowered.com"));
-                        break;
-                    case "Steam Community":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("steamcommunity.com"));
-                        break;
-                    case "ScreamDB":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("scream-db.web.app"));
-                        break;
-                    case "Epic Games":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("epicgames.com"));
-                        break;
-                    case "Ubisoft Store":
-                        image = await HttpClientManager.GetImageFromUrl(
-                            IconGrabber.GetDomainFaviconUrl("store.ubi.com"));
-                        break;
-                    default:
-                        return;
-                }
-
-                if (image is not null)
-                {
-                    Images[imageIdentifier] = image;
-                    item.Image = image;
-                }
+                case "Paradox Launcher":
+                    if (ParadoxLauncher.InstallPath.DirectoryExists())
+                        foreach (string file in ParadoxLauncher.InstallPath.EnumerateDirectory("*.exe"))
+                            return file.GetFileIconImage();
+                    break;
+                case "Notepad":
+                    return IconGrabber.GetNotepadImage();
+                case "Command Prompt":
+                    return IconGrabber.GetCommandPromptImage();
+                case "File Explorer":
+                    return IconGrabber.GetFileExplorerImage();
+                case "SteamDB":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("steamdb.info"));
+                case "Steam Store":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("store.steampowered.com"));
+                case "Steam Community":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("steamcommunity.com"));
+                case "ScreamDB":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("scream-db.web.app"));
+                case "Epic Games":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("epicgames.com"));
+                case "Ubisoft Store":
+                    return await HttpClientManager.GetImageFromUrl(
+                        IconGrabber.GetDomainFaviconUrl("store.ubi.com"));
             }
+            return null;
         });
 
+        if (image is not null)
+        {
+            Images[imageIdentifier] = image;
+            item.Image = image;
+        }
+    }
+
     private static async Task TryImageIdentifierInfo(ContextMenuItem item,
         (string id, string iconUrl) imageIdentifierInfo, Action onFail = null)
-        => await Task.Run(async () =>
+    {
+        try
         {
-            try
+            (string id, string iconUrl) = imageIdentifierInfo;
+            string imageIdentifier = "Icon_" + id;
+            
+            if (Images.TryGetValue(imageIdentifier, out Image image) && image is not null)
             {
-                (string id, string iconUrl) = imageIdentifierInfo;
-                string imageIdentifier = "Icon_" + id;
-                if (Images.TryGetValue(imageIdentifier, out Image image) && image is not null)
-                    item.Image = image;
-                else
-                {
-                    image = await HttpClientManager.GetImageFromUrl(iconUrl);
-                    if (image is not null)
-                    {
-                        Images[imageIdentifier] = image;
-                        item.Image = image;
-                    }
-                    else
-                        onFail?.Invoke();
-                }
+                item.Image = image;
+                return;
             }
-            catch
+
+            image = await HttpClientManager.GetImageFromUrl(iconUrl);
+            if (image is not null)
             {
-                // ignored
+                Images[imageIdentifier] = image;
+                item.Image = image;
             }
-        });
+            else
+                onFail?.Invoke();
+        }
+        catch
+        {
+            // ignored
+        }
+    }
 
     protected override void OnClick(EventArgs e)
     {

CreamInstaller/Components/CustomTreeView.cs

@@ -15,20 +15,17 @@ internal sealed class CustomTreeView : TreeView
 {
     private const string ProxyToggleString = "Proxy";
 
-    private static readonly Color C1 = ColorTranslator.FromHtml("#FFFF99");
-    private static readonly Color C2 = ColorTranslator.FromHtml("#696900");
-    private static readonly Color C3 = ColorTranslator.FromHtml("#AAAA69");
-    private static readonly Color C4 = ColorTranslator.FromHtml("#99FFFF");
-    private static readonly Color C5 = ColorTranslator.FromHtml("#006969");
-    private static readonly Color C6 = ColorTranslator.FromHtml("#69AAAA");
-    private static readonly Color C7 = ColorTranslator.FromHtml("#006900");
-    private static readonly Color C8 = ColorTranslator.FromHtml("#69AA69");
-
     private readonly Dictionary<Selection, Rectangle> checkBoxBounds = [];
     private readonly Dictionary<Selection, Rectangle> comboBoxBounds = [];
 
     private readonly Dictionary<TreeNode, Rectangle> selectionBounds = [];
     private SolidBrush backBrush;
+    private Color lastBackColor; // Tracks the last background color
+
+    // Selection background brush (used instead of SystemBrushes.Highlight to support dark mode)
+    private SolidBrush selectionBrush;
+    private Color lastSelectionBackColor;
+
     private ToolStripDropDown comboBoxDropDown;
     private Font comboBoxFont;
     private Form form;
@@ -54,6 +51,8 @@ internal sealed class CustomTreeView : TreeView
     {
         backBrush?.Dispose();
         backBrush = null;
+        selectionBrush?.Dispose();
+        selectionBrush = null;
         comboBoxFont?.Dispose();
         comboBoxFont = null;
         comboBoxDropDown?.Dispose();
@@ -65,6 +64,13 @@ internal sealed class CustomTreeView : TreeView
         checkBoxBounds.Clear();
         comboBoxBounds.Clear();
         selectionBounds.Clear();
+        backBrush?.Dispose();
+        backBrush = null;
+        lastBackColor = Color.Empty;
+
+        selectionBrush?.Dispose();
+        selectionBrush = null;
+        lastSelectionBackColor = Color.Empty;
     }
 
     private void DrawTreeNode(object sender, DrawTreeNodeEventArgs e)
@@ -76,9 +82,29 @@ internal sealed class CustomTreeView : TreeView
 
         bool highlighted = (e.State & TreeNodeStates.Selected) == TreeNodeStates.Selected && Focused;
         Graphics graphics = e.Graphics;
-        backBrush ??= new(BackColor);
+
+        // Recreate back brush if background color changed
+        if (backBrush == null || lastBackColor != BackColor)
+        {
+            backBrush?.Dispose();
+            backBrush = new(BackColor);
+            lastBackColor = BackColor;
+        }
+
+        // If highlighted, prepare a selection brush that respects the theme
+        if (highlighted)
+        {
+            Color selColor = ThemeManager.CustomTreeViewSelectionBackColor;
+            if (selectionBrush == null || lastSelectionBackColor != selColor)
+            {
+                selectionBrush?.Dispose();
+                selectionBrush = new(selColor);
+                lastSelectionBackColor = selColor;
+            }
+        }
+
         Font font = node.NodeFont ?? Font;
-        Brush brush = highlighted ? SystemBrushes.Highlight : backBrush;
+        Brush brush = highlighted ? (Brush)selectionBrush : backBrush;
         Rectangle bounds = node.Bounds;
         Rectangle selectionBounds = bounds;
 
@@ -93,10 +119,10 @@ internal sealed class CustomTreeView : TreeView
             return;
 
         Color color = highlighted
-            ? C1
+            ? ThemeManager.CustomTreeViewHighlightPlatformColor
             : Enabled
-                ? C2
-                : C3;
+                ? ThemeManager.CustomTreeViewPlatformColor
+                : ThemeManager.CustomTreeViewDisabledPlatformColor;
         string text;
         if (dlcType is not DLCType.None)
         {
@@ -115,10 +141,10 @@ internal sealed class CustomTreeView : TreeView
         if (platform is not Platform.Paradox)
         {
             color = highlighted
-                ? C4
+                ? ThemeManager.CustomTreeViewHighlightIdColor
                 : Enabled
-                    ? C5
-                    : C6;
+                    ? ThemeManager.CustomTreeViewIdColor
+                    : ThemeManager.CustomTreeViewDisabledIdColor;
             text = id;
             size = TextRenderer.MeasureText(graphics, text, font);
             const int left = -4;
@@ -163,7 +189,9 @@ internal sealed class CustomTreeView : TreeView
                 checkBoxBounds = new(checkBoxBounds.Location, checkBoxBounds.Size + bounds.Size with { Height = 0 });
                 graphics.FillRectangle(backBrush, bounds);
                 point = new(bounds.Location.X - 1 + left, bounds.Location.Y + 1);
-                TextRenderer.DrawText(graphics, text, font, point, Enabled ? C7 : C8, TextFormatFlags.Default);
+                TextRenderer.DrawText(graphics, text, font, point,
+                    Enabled ? ThemeManager.CustomTreeViewProxyColor : ThemeManager.CustomTreeViewDisabledProxyColor,
+                    TextFormatFlags.Default);
 
                 this.checkBoxBounds[selection] = RectangleToClient(checkBoxBounds);
 
@@ -171,8 +199,11 @@ internal sealed class CustomTreeView : TreeView
                 {
                     comboBoxFont ??= new(font.FontFamily, 6, font.Style, font.Unit, font.GdiCharSet,
                         font.GdiVerticalFont);
-                    ComboBoxState comboBoxState = Enabled ? ComboBoxState.Normal : ComboBoxState.Disabled;
-                    ButtonState buttonState = Enabled ? ButtonState.Normal : ButtonState.Inactive;
+
+                    bool darkMode = Program.DarkModeEnabled;
+                    Color comboBackColor = ThemeManager.CustomTreeViewComboBackColor;
+                    Color comboBorderColor = ThemeManager.CustomTreeViewComboBorderColor;
+                    Color comboTextColor = ThemeManager.CustomTreeViewComboTextColor;
 
                     text = (selection.Proxy ?? Selection.DefaultProxy) + ".dll";
                     size = TextRenderer.MeasureText(graphics, text, comboBoxFont) + new Size(6, 0);
@@ -181,18 +212,9 @@ internal sealed class CustomTreeView : TreeView
                     selectionBounds = new(selectionBounds.Location,
                         selectionBounds.Size + bounds.Size with { Height = 0 });
                     Rectangle comboBoxBounds = bounds;
-                    graphics.FillRectangle(backBrush, bounds);
-                    if (ComboBoxRenderer.IsSupported)
-                        ComboBoxRenderer.DrawTextBox(graphics, bounds, text, comboBoxFont, comboBoxState);
-                    else
-                    {
-                        graphics.FillRectangle(SystemBrushes.ControlText, bounds);
-                        ControlPaint.DrawButton(graphics, bounds, buttonState);
-                        point = new(bounds.Location.X + 3 + bounds.Width / 2 - size.Width / 2,
-                            bounds.Location.Y + bounds.Height / 2 - size.Height / 2);
-                        TextRenderer.DrawText(graphics, text, comboBoxFont, point,
-                            Enabled ? SystemColors.ControlText : SystemColors.GrayText, TextFormatFlags.Default);
-                    }
+
+                    // Themed combobox background + text (centralized in ThemeManager)
+                    ThemeManager.DrawCustomComboBox(graphics, bounds, comboBoxFont, text);
 
                     size = new(14, 0);
                     left = -1;
@@ -201,10 +223,9 @@ internal sealed class CustomTreeView : TreeView
                         selectionBounds.Size + new Size(bounds.Size.Width + left, 0));
                     comboBoxBounds = new(comboBoxBounds.Location,
                         comboBoxBounds.Size + new Size(bounds.Size.Width + left, 0));
-                    if (ComboBoxRenderer.IsSupported)
-                        ComboBoxRenderer.DrawDropDownButton(graphics, bounds, comboBoxState);
-                    else
-                        ControlPaint.DrawComboButton(graphics, bounds, buttonState);
+
+                    // Themed combobox dropdown button (centralized in ThemeManager)
+                    ThemeManager.DrawCustomComboBoxButton(graphics, bounds);
 
                     this.comboBoxBounds[selection] = RectangleToClient(comboBoxBounds);
                 }
@@ -246,6 +267,7 @@ internal sealed class CustomTreeView : TreeView
                     comboBoxDropDown ??= new();
                     comboBoxDropDown.ShowItemToolTips = false;
                     comboBoxDropDown.Items.Clear();
+
                     foreach (string proxy in proxies)
                     {
                         bool canUse = true;
@@ -261,13 +283,22 @@ internal sealed class CustomTreeView : TreeView
                         }
 
                         if (canUse)
-                            _ = comboBoxDropDown.Items.Add(new ToolStripButton(proxy + ".dll", null, (_, _) =>
+                        {
+                            ToolStripMenuItem menuItem = new(proxy + ".dll", null, (_, _) =>
                             {
                                 pair.Key.Proxy = proxy == Selection.DefaultProxy ? null : proxy;
                                 selectForm.OnProxyChanged();
-                            }) { Font = comboBoxFont });
+                            })
+                            {
+                                Font = comboBoxFont
+                            };
+                            _ = comboBoxDropDown.Items.Add(menuItem);
+                        }
                     }
 
+                    // Apply theme using ThemeManager
+                    ThemeManager.ApplyToolStripDropDown(comboBoxDropDown);
+
                     comboBoxDropDown.Show(this, PointToScreen(new(pair.Value.Left, pair.Value.Bottom - 1)));
                     break;
                 }

CreamInstaller/CreamInstaller.csproj

@@ -4,7 +4,7 @@
         <TargetFramework>net8.0-windows10.0.22621.0</TargetFramework>
         <UseWindowsForms>True</UseWindowsForms>
         <ApplicationIcon>Resources\program.ico</ApplicationIcon>
-        <Version>5.0.1.7</Version>
+        <Version>5.0.2.0</Version>
         <Copyright>2025, FroggMaster (https://github.com/FroggMaster)</Copyright>
         <Company>CreamInstaller</Company>
         <Product>Automatic DLC Unlocker Installer &amp; Configuration Generator</Product>

CreamInstaller/Forms/SelectForm.cs

@@ -569,6 +569,8 @@ internal sealed partial class SelectForm : CustomForm
         progressLabel.Text = "Waiting for user to select which programs/games to scan . . .";
         ShowProgressBar();
         await ProgramData.Setup(this);
+        ProgramData.ClearLog();
+        ProgramData.Log($"[Scan] CreamInstaller {Program.Version} — scan started at {DateTime.UtcNow:yyyy-MM-dd HH:mm:ss} UTC");
         bool scan = forceScan;
         if (!scan && (programsToScan is null || programsToScan.Count < 1 || forceProvideChoices))
         {
@@ -791,6 +793,7 @@ internal sealed partial class SelectForm : CustomForm
         => Invoke(() =>
         {
             ContextMenuStrip contextMenuStrip = new();
+            ThemeManager.ApplyContextMenu(contextMenuStrip);
             ToolStripItemCollection items = contextMenuStrip.Items;
             string id = node.Name;
             Platform platform = (Platform)node.Tag;
@@ -1242,14 +1245,8 @@ internal sealed partial class SelectForm : CustomForm
 
     private void OnDarkModeCheckBoxChanged(object sender, EventArgs e)
     {
-        bool requestedDark = darkModeCheckBox.Checked;
-        if (Program.DarkModeEnabled != requestedDark)
-        {
-            Program.DarkModeEnabled = requestedDark;
-            ThemeManager.Apply(this);
-        }
-        else
-            ThemeManager.Apply(this);
+        Program.DarkModeEnabled = darkModeCheckBox.Checked;
+        ThemeManager.ApplyToAllOpenForms();
     }
 
     protected override void OnShown(EventArgs e)

CreamInstaller/Platforms/Epic/EpicStore.cs

@@ -58,13 +58,13 @@ internal static class EpicStore
                 cacheFile.DeleteFile();
             }
 
-        if (response is null)
+        if (response is null || response.Data?.Catalog is null)
             return dlcIds;
-        List<Element> searchStore = [..response.Data.Catalog.SearchStore.Elements];
+        List<Element> searchStore = [..response.Data.Catalog.SearchStore?.Elements ?? []];
         foreach (Element element in searchStore)
         {
             string title = element.Title;
-            string product = element.CatalogNs is not null && element.CatalogNs.Mappings.Length > 0
+            string product = element.CatalogNs?.Mappings is { Length: > 0 }
                 ? element.CatalogNs.Mappings.First().PageSlug
                 : null;
             string icon = null;
@@ -81,11 +81,11 @@ internal static class EpicStore
                 dlcIds.Populate(item.Id, title, product, icon, null, element.Items.Length == 1);
         }
 
-        List<Element> catalogOffers = [..response.Data.Catalog.CatalogOffers.Elements];
+        List<Element> catalogOffers = [..response.Data.Catalog.CatalogOffers?.Elements ?? []];
         foreach (Element element in catalogOffers)
         {
             string title = element.Title;
-            string product = element.CatalogNs is not null && element.CatalogNs.Mappings.Length > 0
+            string product = element.CatalogNs?.Mappings is { Length: > 0 }
                 ? element.CatalogNs.Mappings.First().PageSlug
                 : null;
             string icon = null;
@@ -118,6 +118,7 @@ internal static class EpicStore
             (string id, string name, string product, string icon, string developer) app = dlcIds[i];
             if (app.id != id)
                 continue;
+
             found = true;
             dlcIds[i] = canOverwrite
                 ? (app.id, title ?? app.name, product ?? app.product, icon ?? app.icon, developer ?? app.developer)

CreamInstaller/Platforms/Steam/SteamLibrary.cs

@@ -1,4 +1,5 @@
 using System.Collections.Generic;
+using System.IO;
 using System.Linq;
 using System.Threading.Tasks;
 using CreamInstaller.Utility;
@@ -28,16 +29,19 @@ internal static class SteamLibrary
         {
             List<(string appId, string name, string branch, int buildId, string gameDirectory)> games = new();
             HashSet<string> gameLibraryDirectories = await GetLibraryDirectories();
+            ProgramData.Log($"[Steam] Found {gameLibraryDirectories.Count} library folder(s).");
             foreach (string libraryDirectory in gameLibraryDirectories)
             {
                 if (Program.Canceled)
                     return games;
+                ProgramData.Log($"[Steam] Scanning library: {libraryDirectory}");
                 foreach ((string appId, string name, string branch, int buildId, string gameDirectory) game in (await
                              GetGamesFromLibraryDirectory(
                                  libraryDirectory)).Where(game => games.All(_game => _game.appId != game.appId)))
                     games.Add(game);
             }
 
+            ProgramData.Log($"[Steam] Total games detected: {games.Count}");
             return games;
         });
 
@@ -47,13 +51,21 @@ internal static class SteamLibrary
         {
             List<(string appId, string name, string branch, int buildId, string gameDirectory)> games = new();
             if (Program.Canceled || !libraryDirectory.DirectoryExists())
+            {
+                ProgramData.Log($"[Steam] Skipping library (not found or canceled): {libraryDirectory}");
                 return games;
+            }
+
             foreach (string file in libraryDirectory.EnumerateDirectory("*.acf"))
             {
                 if (Program.Canceled)
                     return games;
                 if (!ValveDataFile.TryDeserialize(file.ReadFile(), out VProperty result))
+                {
+                    ProgramData.Log($"[Steam] Failed to deserialize ACF: {file}");
                     continue;
+                }
+
                 string appId = result.Value.GetChild("appid")?.ToString();
                 string installdir = result.Value.GetChild("installdir")?.ToString();
                 string name = result.Value.GetChild("name")?.ToString();
@@ -61,11 +73,23 @@ internal static class SteamLibrary
                 if (string.IsNullOrWhiteSpace(appId) || string.IsNullOrWhiteSpace(installdir) ||
                     string.IsNullOrWhiteSpace(name)
                     || string.IsNullOrWhiteSpace(buildId))
+                {
+                    ProgramData.Log($"[Steam] Skipping ACF with missing fields: {file}");
                     continue;
-                string gameDirectory = (libraryDirectory + @"\common\" + installdir).ResolvePath();
-                if (gameDirectory is null || !int.TryParse(appId, out int _) ||
-                    !int.TryParse(buildId, out int buildIdInt) || games.Any(g => g.appId == appId))
+                }
+
+                string rawGameDirectory = libraryDirectory + @"\common\" + installdir;
+                string gameDirectory = rawGameDirectory.ResolvePath();
+                if (gameDirectory is null)
+                {
+                    ProgramData.Log($"[Steam] Game directory not found (drive may be slow or disconnected): {rawGameDirectory} | App: {name} ({appId})");
                     continue;
+                }
+
+                if (!int.TryParse(appId, out int _) || !int.TryParse(buildId, out int buildIdInt) ||
+                    games.Any(g => g.appId == appId))
+                    continue;
+
                 VToken userConfig = result.Value.GetChild("UserConfig");
                 string branch = userConfig?.GetChild("BetaKey")?.ToString();
                 branch ??= userConfig?.GetChild("betakey")?.ToString();
@@ -78,6 +102,8 @@ internal static class SteamLibrary
 
                 if (string.IsNullOrWhiteSpace(branch))
                     branch = "public";
+
+                ProgramData.Log($"[Steam] Detected game: {name} ({appId}) | Branch: {branch} | Dir: {gameDirectory}");
                 games.Add((appId, name, branch, buildIdInt, gameDirectory));
             }
 
@@ -92,25 +118,50 @@ internal static class SteamLibrary
                 return libraryDirectories;
             string steamInstallPath = InstallPath;
             if (steamInstallPath == null || !steamInstallPath.DirectoryExists())
+            {
+                ProgramData.Log($"[Steam] Steam install path not found or inaccessible: {steamInstallPath ?? "(null)"}");
                 return libraryDirectories;
+            }
+
             string libraryFolder = steamInstallPath + @"\steamapps";
             if (!libraryFolder.DirectoryExists())
+            {
+                ProgramData.Log($"[Steam] Default steamapps folder not found: {libraryFolder}");
                 return libraryDirectories;
+            }
+
             _ = libraryDirectories.Add(libraryFolder);
+            ProgramData.Log($"[Steam] Default library folder: {libraryFolder}");
+
             string libraryFolders = libraryFolder + @"\libraryfolders.vdf";
             if (!libraryFolders.FileExists() ||
                 !ValveDataFile.TryDeserialize(libraryFolders.ReadFile(), out VProperty result))
+            {
+                ProgramData.Log($"[Steam] libraryfolders.vdf not found or failed to parse: {libraryFolders}");
                 return libraryDirectories;
+            }
+
             foreach (VToken vToken in result.Value.Where(p =>
                          p is VProperty property && int.TryParse(property.Key, out int _)))
             {
                 VProperty property = (VProperty)vToken;
-                string path = property.Value.GetChild("path")?.ToString();
-                if (string.IsNullOrWhiteSpace(path))
+                string rawPath = property.Value.GetChild("path")?.ToString();
+                if (string.IsNullOrWhiteSpace(rawPath))
                     continue;
-                path += @"\steamapps";
-                if (path.DirectoryExists())
-                    _ = libraryDirectories.Add(path);
+
+                // Normalize the path from VDF (may use forward slashes or wrong casing)
+                string normalizedPath = Path.GetFullPath(rawPath);
+                string steamappsPath = normalizedPath + @"\steamapps";
+                string resolvedPath = steamappsPath.ResolvePath();
+
+                if (resolvedPath is null)
+                {
+                    ProgramData.Log($"[Steam] External library not accessible (drive may be disconnected or letter changed): {steamappsPath}");
+                    continue;
+                }
+
+                if (libraryDirectories.Add(resolvedPath))
+                    ProgramData.Log($"[Steam] Additional library folder found: {resolvedPath}");
             }
 
             return libraryDirectories;

CreamInstaller/Resources/SmokeAPI.cs

@@ -167,7 +167,7 @@ internal static class SmokeAPI
                 }
             }
 
-            writer.WriteLine("  },");
+            writer.WriteLine("  }");
         }
         else
             writer.WriteLine("  \"extra_dlcs\": {}");

CreamInstaller/Utility/Diagnostics.cs

@@ -54,7 +54,16 @@ internal static class Diagnostics
         if (info.Parent is null)
             return info.Name.ToUpperInvariant();
         string parent = ResolvePath(info.Parent.FullName);
-        string name = info.Parent.GetFileSystemInfos(info.Name)[0].Name;
-        return parent is null ? name : Path.Combine(parent, name);
+        try
+        {
+            FileSystemInfo[] infos = info.Parent.GetFileSystemInfos(info.Name);
+            string name = infos.Length > 0 ? infos[0].Name : info.Name;
+            return parent is null ? name : Path.Combine(parent, name);
+        }
+        catch
+        {
+            // Fall back to the raw name if the filesystem call fails (e.g. on a slow external drive)
+            return parent is null ? info.Name : Path.Combine(parent, info.Name);
+        }
     }
 }

CreamInstaller/Utility/ProgramData.cs

@@ -1,7 +1,9 @@
 using System;
 using System.Collections.Generic;
 using System.Globalization;
+using System.IO;
 using System.Linq;
+using System.Text;
 using System.Threading.Tasks;
 using System.Windows.Forms;
 using Newtonsoft.Json;
@@ -28,6 +30,38 @@ internal static class ProgramData
     private static readonly string DlcChoicesPath = DirectoryPath + @"\dlc.json";
     private static readonly string KoaloaderProxyChoicesPath = DirectoryPath + @"\proxies.json";
 
+    internal static readonly string LogPath = DirectoryPath + @"\scan.log";
+
+    private static readonly object LogLock = new();
+
+    internal static void Log(string message)
+    {
+        try
+        {
+            string timestamp = DateTime.UtcNow.ToString("yyyy-MM-dd HH:mm:ss.fff", CultureInfo.InvariantCulture);
+            string entry = $"[{timestamp}] {message}{Environment.NewLine}";
+            lock (LogLock)
+                File.AppendAllText(LogPath, entry, Encoding.UTF8);
+        }
+        catch
+        {
+            // ignored — logging must never crash the application
+        }
+    }
+
+    internal static void ClearLog()
+    {
+        try
+        {
+            if (File.Exists(LogPath))
+                File.Delete(LogPath);
+        }
+        catch
+        {
+            // ignored
+        }
+    }
+
     internal static async Task Setup(Form form = null)
         => await Task.Run(() =>
         {

CreamInstaller/Utility/ThemeManager.cs

@@ -7,200 +7,458 @@ namespace CreamInstaller.Utility;
 
 internal static class ThemeManager
 {
- // VS-like dark colors
- private static readonly Color DarkBack = ColorTranslator.FromHtml("#1E1E1E");
- private static readonly Color DarkBackAlt = ColorTranslator.FromHtml("#252525");
- private static readonly Color DarkBorder = ColorTranslator.FromHtml("#3F3F46");
- private static readonly Color DarkFore = ColorTranslator.FromHtml("#D4D4D4");
- private static readonly Color DarkForeDim = ColorTranslator.FromHtml("#9CA3AF");
- private static readonly Color Accent = ColorTranslator.FromHtml("#0E639C");
- private static readonly Color DarkLink = ColorTranslator.FromHtml("#64B5F6");
- private static readonly Color LightBack = SystemColors.Control;
- private static readonly Color LightBackAlt = SystemColors.ControlLightLight;
- private static readonly Color LightFore = SystemColors.ControlText;
- private static readonly Color LightBorder = SystemColors.ControlDark;
+    // -----------------------------------------------------------------
+    // Color definitions (do not change values)
+    // -----------------------------------------------------------------
 
- internal static void ToggleDarkMode(Form anyForm)
- {
- Program.DarkModeEnabled = !Program.DarkModeEnabled;
- ApplyToAllOpenForms();
- }
+    // ----------------------------
+    // Dark mode colors
+    // ----------------------------
+    private static readonly Color DarkBack = ColorTranslator.FromHtml("#1E1E1E");
+    private static readonly Color DarkBackAlt = ColorTranslator.FromHtml("#252525");
+    private static readonly Color DarkBorder = ColorTranslator.FromHtml("#3F3F46");
+    private static readonly Color DarkFore = ColorTranslator.FromHtml("#D4D4D4");
+    private static readonly Color DarkForeDim = ColorTranslator.FromHtml("#9CA3AF");
+    private static readonly Color Accent = ColorTranslator.FromHtml("#0E639C");
+    private static readonly Color DarkLink = ColorTranslator.FromHtml("#64B5F6");
 
- internal static void Apply(Form form)
- {
- if (form is null) return;
- if (!Program.DarkModeEnabled)
- {
- Reset(form);
- return;
- }
- form.SuspendLayout();
- form.BackColor = DarkBack;
- form.ForeColor = DarkFore;
- ApplyTitleBar(form);
- foreach (Control c in form.Controls)
- ApplyControlTheme(c, true);
- form.ResumeLayout(true);
- }
+    // CustomTreeView dark-mode specific colors
+    private static readonly Color DarkPlatform = ColorTranslator.FromHtml("#FFFF99");
+    private static readonly Color DarkId = ColorTranslator.FromHtml("#99FFFF");
+    private static readonly Color DarkProxy = ColorTranslator.FromHtml("#99FF99");
+    private static readonly Color DarkSelectionBack = ColorTranslator.FromHtml("#2A2D2E");
+    private static readonly Color DarkComboBack = DarkBackAlt; // #252525
+    private static readonly Color DarkComboBorder = DarkBorder; // #3F3F46
+    private static readonly Color DarkComboText = DarkFore; // #D4D4D4
 
- private static void ApplyControlTheme(Control control, bool dark)
- {
- if (control is null) return;
- foreach (Control child in control.Controls)
- ApplyControlTheme(child, dark);
- if (dark)
- {
- switch (control)
- {
- case GroupBox gb:
- gb.ForeColor = DarkFore;
- gb.BackColor = DarkBackAlt;
- break;
- case Button b:
- b.FlatStyle = FlatStyle.Flat;
- b.FlatAppearance.BorderColor = DarkBorder;
- b.BackColor = DarkBackAlt;
- b.ForeColor = DarkFore;
- break;
- case CheckBox cb:
- cb.BackColor = DarkBack;
- cb.ForeColor = DarkFore;
- break;
- case LinkLabel ll:
- ll.BackColor = DarkBack;
- ll.ForeColor = DarkFore; // normal text
- ll.LinkColor = DarkLink;
- ll.ActiveLinkColor = Color.White; // high contrast when pressed
- ll.VisitedLinkColor = DarkLink; // keep consistent
- break;
- case Label lbl:
- lbl.BackColor = DarkBack;
- lbl.ForeColor = DarkFore;
- break;
- case ProgressBar pb:
- pb.ForeColor = Accent;
- pb.BackColor = DarkBackAlt;
- break;
- case TreeView tv:
- tv.BackColor = DarkBackAlt;
- tv.ForeColor = DarkFore;
- tv.LineColor = DarkBorder;
- break;
- case RichTextBox rtb:
- rtb.BackColor = DarkBackAlt;
- rtb.ForeColor = DarkFore;
- break;
- case TableLayoutPanel tlp:
- tlp.BackColor = DarkBack;
- break;
- case FlowLayoutPanel flp:
- flp.BackColor = DarkBack;
- break;
- }
- TryApplyScrollbarTheme(control, true);
- }
- else
- {
- // Light reset per control type
- switch (control)
- {
- case GroupBox gb:
- gb.BackColor = LightBack;
- gb.ForeColor = LightFore;
- break;
- case Button b:
- b.FlatStyle = FlatStyle.Standard;
- b.BackColor = LightBack;
- b.ForeColor = LightFore;
- break;
- case CheckBox cb:
- cb.BackColor = LightBack;
- cb.ForeColor = LightFore;
- break;
- case LinkLabel ll:
- ll.BackColor = LightBack;
- ll.ForeColor = LightFore;
- // allow system defaults for link colors
- ll.LinkColor = SystemColors.HotTrack;
- ll.ActiveLinkColor = SystemColors.Highlight;
- ll.VisitedLinkColor = SystemColors.HotTrack;
- break;
- case Label lbl:
- lbl.BackColor = LightBack;
- lbl.ForeColor = LightFore;
- break;
- case ProgressBar pb:
- pb.BackColor = LightBack;
- pb.ForeColor = LightFore;
- break;
- case TreeView tv:
- tv.BackColor = LightBack;
- tv.ForeColor = LightFore;
- tv.LineColor = LightBorder;
- break;
- case RichTextBox rtb:
- rtb.BackColor = LightBack;
- rtb.ForeColor = LightFore;
- break;
- case TableLayoutPanel tlp:
- tlp.BackColor = LightBack;
- break;
- case FlowLayoutPanel flp:
- flp.BackColor = LightBack;
- break;
- }
- TryApplyScrollbarTheme(control, false);
- }
- }
+    // ----------------------------
+    // Light mode colors (system defaults)
+    // ----------------------------
+    private static readonly Color LightBack = SystemColors.Control;
+    private static readonly Color LightBackAlt = SystemColors.ControlLightLight;
+    private static readonly Color LightFore = SystemColors.ControlText;
+    private static readonly Color LightBorder = SystemColors.ControlDark;
 
- private static void Reset(Form form)
- {
- form.SuspendLayout();
- form.BackColor = LightBack;
- form.ForeColor = LightFore;
- ApplyTitleBar(form);
- foreach (Control c in form.Controls)
- ApplyControlTheme(c, false);
- form.ResumeLayout(true);
- }
+    // CustomTreeView light-mode specific colors
+    private static readonly Color LightPlatform = ColorTranslator.FromHtml("#696900");
+    private static readonly Color LightId = ColorTranslator.FromHtml("#006969");
+    private static readonly Color LightProxy = ColorTranslator.FromHtml("#006900");
+    private static readonly Color LightSelectionBack = SystemColors.Highlight;
+    private static readonly Color LightComboBack = SystemColors.Control;
+    private static readonly Color LightComboBorder = SystemColors.ControlDark;
+    private static readonly Color LightComboText = SystemColors.ControlText;
 
- private static void ApplyToAllOpenForms()
- {
- foreach (Form openForm in Application.OpenForms.Cast<Form>())
- Apply(openForm);
- }
+    // -----------------------------------------------------------------
+    // Theme-aware properties used by other components (CustomTreeView etc.)
+    // -----------------------------------------------------------------
 
- private static void ApplyTitleBar(Form form)
- {
- try
- {
- int useDark = Program.DarkModeEnabled ?1 :0;
- NativeMethods.EnableDarkTitleBar(form.Handle, useDark);
- }
- catch { }
- }
+    internal static bool IsDark => Program.DarkModeEnabled;
 
- private static void TryApplyScrollbarTheme(Control control, bool dark)
- {
- // RichTextBox & TreeView host scrollbars internally; use window theme API
- try
- {
- string theme = dark ? "DarkMode_Explorer" : null; // reset with null
- NativeImports.SetWindowTheme(control.Handle, theme, null);
- }
- catch { }
- }
+    internal static Color CustomTreeViewPlatformColor => IsDark ? DarkPlatform : LightPlatform;
+
+    internal static Color CustomTreeViewIdColor => IsDark ? DarkId : LightId;
+
+    internal static Color CustomTreeViewProxyColor => IsDark ? DarkProxy : LightProxy;
+
+    internal static Color CustomTreeViewHighlightPlatformColor => DarkPlatform; // C1 (uses same color for highlight)
+    internal static Color CustomTreeViewDisabledPlatformColor => ColorTranslator.FromHtml("#AAAA69"); // C3
+    internal static Color CustomTreeViewHighlightIdColor => DarkId; // C4
+    internal static Color CustomTreeViewDisabledIdColor => ColorTranslator.FromHtml("#69AAAA"); // C6
+    internal static Color CustomTreeViewDisabledProxyColor => ColorTranslator.FromHtml("#69AA69"); // C8
+
+    // Background color used when a tree node is selected.
+    // Keeps light-mode behavior using the system highlight, but supplies a custom dark color for dark mode
+    internal static Color CustomTreeViewSelectionBackColor => IsDark ? DarkSelectionBack : LightSelectionBack;
+
+    internal static Color CustomTreeViewComboBackColor => IsDark ? DarkComboBack : LightComboBack;
+
+    internal static Color CustomTreeViewComboBorderColor => IsDark ? DarkComboBorder : LightComboBorder;
+
+    internal static Color CustomTreeViewComboTextColor => IsDark ? DarkComboText : LightComboText;
+
+    // -----------------------------------------------------------------
+    // Public / Internal API
+    // -----------------------------------------------------------------
+
+    /// <summary>
+    /// Toggle dark mode and re-apply theming to all open forms.
+    /// </summary>
+    internal static void ToggleDarkMode(Form anyForm)
+    {
+        Program.DarkModeEnabled = !Program.DarkModeEnabled;
+        ApplyToAllOpenForms();
+    }
+
+    /// <summary>
+    /// Apply current theme to a single form and its child controls.
+    /// </summary>
+    internal static void Apply(Form form)
+    {
+        if (form is null) return;
+        if (!IsDark)
+        {
+            Reset(form);
+            return;
+        }
+
+        form.SuspendLayout();
+        form.BackColor = DarkBack;
+        form.ForeColor = DarkFore;
+        ApplyTitleBar(form);
+
+        foreach (Control c in form.Controls)
+            ApplyControlTheme(c, true);
+
+        form.ResumeLayout(true);
+    }
+
+    /// <summary>
+    /// Apply the theme to all currently open forms.
+    /// </summary>
+    internal static void ApplyToAllOpenForms()
+    {
+        foreach (Form openForm in Application.OpenForms.Cast<Form>())
+            Apply(openForm);
+    }
+
+    // -----------------------------------------------------------------
+    // Control theming helpers
+    // -----------------------------------------------------------------
+
+    /// <summary>
+    /// Apply theming to a control tree. Entry point which recurses children
+    /// then applies either the dark or light styling logic.
+    /// </summary>
+    private static void ApplyControlTheme(Control control, bool dark)
+    {
+        if (control is null) return;
+
+        // Recurse first so parent layering still works correctly
+        foreach (Control child in control.Controls)
+            ApplyControlTheme(child, dark);
+
+        if (dark)
+            ApplyDarkControl(control);
+        else
+            ApplyLightControl(control);
+
+        // Try to apply themed scrollbars where applicable
+        TryApplyScrollbarTheme(control, dark);
+    }
+
+    // Separated dark/light cases to make the intent clearer and reduce duplication
+    private static void ApplyDarkControl(Control control)
+    {
+        switch (control)
+        {
+            // Group box background/foreground
+            case GroupBox gb:
+                gb.ForeColor = DarkFore;
+                gb.BackColor = DarkBackAlt;
+                break;
+
+            // Buttons: flat appearance, border and foreground
+            case Button b:
+                b.FlatStyle = FlatStyle.Flat;
+                b.FlatAppearance.BorderColor = DarkBorder;
+                b.BackColor = DarkBackAlt;
+                b.ForeColor = DarkFore;
+                break;
+
+            // Checkboxes: match form background and foreground
+            case CheckBox cb:
+                cb.BackColor = DarkBack;
+                cb.ForeColor = DarkFore;
+                break;
+
+            // LinkLabel: color and active/visited styling
+            case LinkLabel ll:
+                ll.BackColor = DarkBack;
+                ll.ForeColor = DarkFore;
+                ll.LinkColor = DarkLink;
+                ll.ActiveLinkColor = Color.White;
+                ll.VisitedLinkColor = DarkLink;
+                break;
+
+            // Labels: dark background, light foreground
+            case Label lbl:
+                lbl.BackColor = DarkBack;
+                lbl.ForeColor = DarkFore;
+                break;
+
+            // ProgressBar uses accent color for foreground
+            case ProgressBar pb:
+                pb.ForeColor = Accent;
+                pb.BackColor = DarkBackAlt;
+                break;
+
+            // TreeView: darker alternate background, light text, darker lines
+            case TreeView tv:
+                tv.BackColor = DarkBackAlt;
+                tv.ForeColor = DarkFore;
+                tv.LineColor = DarkBorder;
+                tv.Invalidate(); // Forces a redraw
+                break;
+
+            // RichTextBox follows alternate dark background
+            case RichTextBox rtb:
+                rtb.BackColor = DarkBackAlt;
+                rtb.ForeColor = DarkFore;
+                break;
+
+            // Layout panels set a consistent background
+            case TableLayoutPanel tlp:
+                tlp.BackColor = DarkBack;
+                break;
+            case FlowLayoutPanel flp:
+                flp.BackColor = DarkBack;
+                break;
+        }
+    }
+
+    private static void ApplyLightControl(Control control)
+    {
+        switch (control)
+        {
+            case GroupBox gb:
+                gb.BackColor = LightBack;
+                gb.ForeColor = LightFore;
+                break;
+            case Button b:
+                b.FlatStyle = FlatStyle.Standard;
+                b.BackColor = LightBack;
+                b.ForeColor = LightFore;
+                break;
+            case CheckBox cb:
+                cb.BackColor = LightBack;
+                cb.ForeColor = LightFore;
+                break;
+            case LinkLabel ll:
+                ll.BackColor = LightBack;
+                ll.ForeColor = LightFore;
+                ll.LinkColor = SystemColors.HotTrack;
+                ll.ActiveLinkColor = SystemColors.Highlight;
+                ll.VisitedLinkColor = SystemColors.HotTrack;
+                break;
+            case Label lbl:
+                lbl.BackColor = LightBack;
+                lbl.ForeColor = LightFore;
+                break;
+            case ProgressBar pb:
+                pb.BackColor = LightBack;
+                pb.ForeColor = LightFore;
+                break;
+            case TreeView tv:
+                tv.BackColor = LightBack;
+                tv.ForeColor = LightFore;
+                tv.LineColor = LightBorder;
+                tv.Invalidate(); // Forces a redraw
+                break;
+            case RichTextBox rtb:
+                rtb.BackColor = LightBack;
+                rtb.ForeColor = LightFore;
+                break;
+            case TableLayoutPanel tlp:
+                tlp.BackColor = LightBack;
+                break;
+            case FlowLayoutPanel flp:
+                flp.BackColor = LightBack;
+                break;
+        }
+    }
+
+    private static void Reset(Form form)
+    {
+        form.SuspendLayout();
+        form.BackColor = LightBack;
+        form.ForeColor = LightFore;
+        ApplyTitleBar(form);
+        foreach (Control c in form.Controls)
+            ApplyControlTheme(c, false);
+        form.ResumeLayout(true);
+    }
+
+    // -----------------------------------------------------------------
+    // Titlebar / platform-specific helpers
+    // -----------------------------------------------------------------
+
+    private static void ApplyTitleBar(Form form)
+    {
+        try
+        {
+            int useDark = IsDark ? 1 : 0;
+            NativeMethods.EnableDarkTitleBar(form.Handle, useDark);
+        }
+        catch { }
+    }
+
+    private static void TryApplyScrollbarTheme(Control control, bool dark)
+    {
+        try
+        {
+            string theme = dark ? "DarkMode_Explorer" : null;
+            NativeImports.SetWindowTheme(control.Handle, theme, null);
+        }
+        catch { }
+    }
+
+    // -----------------------------------------------------------------
+    // Context menu / ToolStrip theming
+    // -----------------------------------------------------------------
+
+    /// <summary>
+    /// Apply theme to a context menu (ContextMenuStrip).
+    /// </summary>
+    internal static void ApplyContextMenu(ContextMenuStrip contextMenu)
+    {
+        if (contextMenu is null) return;
+
+        bool dark = IsDark;
+
+        contextMenu.BackColor = dark ? DarkBackAlt : SystemColors.Menu;
+        contextMenu.ForeColor = dark ? DarkFore : SystemColors.MenuText;
+        contextMenu.Renderer = dark ? new DarkContextMenuRenderer() : new ToolStripProfessionalRenderer();
+
+        foreach (ToolStripItem item in contextMenu.Items)
+            ApplyContextMenuItem(item, dark);
+    }
+
+    private static void ApplyContextMenuItem(ToolStripItem item, bool dark)
+    {
+        if (item is null) return;
+
+        item.BackColor = dark ? DarkBackAlt : SystemColors.Menu;
+        item.ForeColor = dark ? DarkFore : SystemColors.MenuText;
+
+        if (item is ToolStripMenuItem menuItem)
+            foreach (ToolStripItem subItem in menuItem.DropDownItems)
+                ApplyContextMenuItem(subItem, dark);
+    }
+
+    internal static void ApplyToolStripDropDown(ToolStripDropDown dropDown)
+    {
+        if (dropDown is null) return;
+
+        bool dark = IsDark;
+
+        dropDown.BackColor = dark ? DarkBackAlt : SystemColors.Menu;
+        dropDown.ForeColor = dark ? DarkFore : SystemColors.MenuText;
+        dropDown.Renderer = dark ? new DarkDropDownRenderer() : new ToolStripProfessionalRenderer();
+
+        foreach (ToolStripItem item in dropDown.Items)
+            ApplyToolStripItem(item, dark);
+    }
+
+    private static void ApplyToolStripItem(ToolStripItem item, bool dark)
+    {
+        if (item is null) return;
+
+        item.BackColor = dark ? DarkBackAlt : SystemColors.Menu;
+        item.ForeColor = dark ? DarkFore : SystemColors.MenuText;
+    }
+
+    // -----------------------------------------------------------------
+    // Themed renderers for menus
+    // -----------------------------------------------------------------
+
+    private class DarkContextMenuRenderer : ToolStripProfessionalRenderer
+    {
+        public DarkContextMenuRenderer() : base(new DarkMenuColorTable()) { }
+
+        protected override void OnRenderItemText(ToolStripItemTextRenderEventArgs e)
+        {
+            if (e.Item.Selected)
+                e.TextColor = DarkFore;
+            base.OnRenderItemText(e);
+        }
+    }
+
+    private class DarkDropDownRenderer : ToolStripProfessionalRenderer
+    {
+        public DarkDropDownRenderer() : base(new DarkMenuColorTable()) { }
+
+        protected override void OnRenderItemText(ToolStripItemTextRenderEventArgs e)
+        {
+            // Force text color to stay light even when selected
+            e.TextColor = DarkFore;
+            base.OnRenderItemText(e);
+        }
+    }
+
+    private class DarkMenuColorTable : ProfessionalColorTable
+    {
+        public override Color MenuItemSelected => ColorTranslator.FromHtml("#2A2D2E");
+        public override Color MenuItemSelectedGradientBegin => ColorTranslator.FromHtml("#2A2D2E");
+        public override Color MenuItemSelectedGradientEnd => ColorTranslator.FromHtml("#2A2D2E");
+        public override Color MenuItemBorder => ColorTranslator.FromHtml("#3F3F46");
+        public override Color MenuBorder => ColorTranslator.FromHtml("#3F3F46");
+        public override Color MenuItemPressedGradientBegin => ColorTranslator.FromHtml("#252525");
+        public override Color MenuItemPressedGradientEnd => ColorTranslator.FromHtml("#252525");
+        public override Color ImageMarginGradientBegin => ColorTranslator.FromHtml("#1E1E1E");
+        public override Color ImageMarginGradientMiddle => ColorTranslator.FromHtml("#1E1E1E");
+        public override Color ImageMarginGradientEnd => ColorTranslator.FromHtml("#1E1E1E");
+        public override Color ToolStripDropDownBackground => ColorTranslator.FromHtml("#252525");
+        public override Color SeparatorDark => ColorTranslator.FromHtml("#3F3F46");
+        public override Color SeparatorLight => ColorTranslator.FromHtml("#3F3F46");
+    }
+
+    // -----------------------------------------------------------------
+    // Theming helpers for CustomTreeView
+    // All rendering logic for the CustomTreeView's proxy combo box and dropdown
+    // button is centralized here so theming resides in ThemeManager.
+    // -----------------------------------------------------------------
+
+    /// <summary>
+    /// Draws the themed combobox area (background, border and text) used in CustomTreeView.
+    /// This centralizes colors and rendering for light/dark modes.
+    /// </summary>
+    internal static void DrawCustomComboBox(Graphics graphics, Rectangle rect, Font font, string text)
+    {
+        if (graphics is null) return;
+        using SolidBrush comboBrush = new(CustomTreeViewComboBackColor);
+        using Pen borderPen = new(CustomTreeViewComboBorderColor);
+        graphics.FillRectangle(comboBrush, rect);
+        graphics.DrawRectangle(borderPen, rect);
+        // Draw text inside the combobox
+        Size textSize = TextRenderer.MeasureText(graphics, text, font);
+        Point textPoint = new(rect.Left +3, rect.Top + rect.Height /2 - textSize.Height /2);
+        TextRenderer.DrawText(graphics, text, font, textPoint, CustomTreeViewComboTextColor, TextFormatFlags.Default);
+    }
+
+    /// <summary>
+    /// Draws the themed dropdown button (right-side arrow) used in CustomTreeView comboboxes.
+    /// </summary>
+    internal static void DrawCustomComboBoxButton(Graphics graphics, Rectangle rect)
+    {
+        if (graphics is null) return;
+        using SolidBrush comboBrush = new(CustomTreeViewComboBackColor);
+        using Pen borderPen = new(CustomTreeViewComboBorderColor);
+        graphics.FillRectangle(comboBrush, rect);
+        graphics.DrawRectangle(borderPen, rect);
+
+        // Draw the arrow glyph centered in the rect
+        int arrowSize =3;
+        Point arrowTop = new(rect.X + rect.Width /2, rect.Y + rect.Height /2 -1);
+        Point[] arrowPoints = new[]
+        {
+            arrowTop,
+            new Point(arrowTop.X - arrowSize, arrowTop.Y - arrowSize),
+            new Point(arrowTop.X + arrowSize, arrowTop.Y - arrowSize)
+        };
+        using SolidBrush arrowBrush = new(CustomTreeViewComboTextColor);
+        graphics.FillPolygon(arrowBrush, arrowPoints);
+    }
 }
 
 internal static class NativeMethods
 {
- private const int DWMWA_USE_IMMERSIVE_DARK_MODE =20;
+    private const int DWMWA_USE_IMMERSIVE_DARK_MODE = 20;
 
- [System.Runtime.InteropServices.DllImport("dwmapi.dll")]
- private static extern int DwmSetWindowAttribute(System.IntPtr hwnd, int attr, ref int attrValue, int attrSize);
+    [System.Runtime.InteropServices.DllImport("dwmapi.dll")]
+    private static extern int DwmSetWindowAttribute(System.IntPtr hwnd, int attr, ref int attrValue, int attrSize);
 
- internal static void EnableDarkTitleBar(System.IntPtr handle, int useDark)
- {
- _ = DwmSetWindowAttribute(handle, DWMWA_USE_IMMERSIVE_DARK_MODE, ref useDark, sizeof(int));
- }
-}
+    internal static void EnableDarkTitleBar(System.IntPtr handle, int useDark)
+    {
+        _ = DwmSetWindowAttribute(handle, DWMWA_USE_IMMERSIVE_DARK_MODE, ref useDark, sizeof(int));
+    }
+}

README.md

@@ -57,16 +57,80 @@ If the program doesn't seem to launch, try downloading and installing [.NET Desk
 ##### **NOTE:** This program does not automatically download nor install actual DLC files for you; as the title of the program states, this program is only a *DLC Unlocker* installer. Should the game you wish to unlock DLC for not already come with the DLCs installed, as is the case with a good majority of games, you must find, download and install those to the game yourself. This process includes manually installing new DLCs and manually updating the previously manually installed DLCs after game updates.
 
 ---
-#### FAQ / Common Issues:
+# FAQ / Common Issues
 
-**Q:** The program is not launching.
-**A:** First and foremost, note that the program currently only supports Windows 10+ 64-bit machines as seen [here](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md). If that does not apply to you, then make sure you've extracted the executable from the ZIP file before you've launched it, resolved your anti-virus, and have tried downloading the .NET Desktop Runtime mentioned under [installation instructions](https://github.com/FroggMaster/CreamInstaller#installation) above and restarting your computer. If none of the above work, then I simply cannot do anything about it, I do not control .NET. Either your system is not supported by the current version of .NET, or something is wrong/corrupted with your system.
+### The program won't launch
 
-**Q:** The game I installed the unlocker(s) to is not working/the DLCs are not unlocked.
-**A:** Make sure you've read the note under [Usage](https://github.com/FroggMaster/CreamInstaller#usage) above! Assuming the program functioned as it was supposed to by properly installing DLC unlockers to your chosen games, this is not an issue I can do anything about and it's entirely up to you to seek the appropriate resources to fix it yourself (hint: https://cs.rin.ru/forum/viewforum.php?f=10).
+Check the following in order:
+
+1. **System requirements**: Windows 10+ 64-bit only ([.NET 8 Supported OS List](https://github.com/dotnet/core/blob/main/release-notes/8.0/supported-os.md))
+2. **Extract before running**: Ensure you've extracted the executable from the ZIP file
+3. **Antivirus**: Add an exception for CreamInstaller (see [False Positives](#false-positive-antivirus-detections) below)
+4. **Runtime**: Install [.NET 8 Desktop Runtime](https://github.com/FroggMaster/CreamInstaller#installation) and restart your computer
+
+If none of these work, your system may not support .NET 8 or may have underlying system issues.
+
+---
+
+### DLCs aren't unlocking in my game
+
+CreamInstaller only installs DLC **unlockers** — it does **not** guarantee they will work for every game.
+
+If the program successfully installs the unlockers but DLCs still aren’t unlocking, this is **not an issue with CreamInstaller itself** and isn’t something I can directly fix. DLC Unlocker compatibility and behavior vary from game to game.
+
+**DLC Files:** _This program does **not** automatically download or install actual DLC files for you. As the name implies, it is only a *DLC unlocker installer*. If the game you wish to unlock DLC for does not already include the DLC files (which is the case for many games), you must manually obtain and install those files yourself. This includes manually installing new DLCs and manually updating or reinstalling previously installed DLCs after game updates._
+
+If you’re having trouble, try the following:
+
+- Review the [Usage section](https://github.com/FroggMaster/CreamInstaller#usage) for proper setup  
+- Visit the [CS.RIN.RU forum](https://cs.rin.ru/forum/viewforum.php?f=10) for game-specific troubleshooting and compatibility info
+
+
+---
+
+### My antivirus detects CreamInstaller as a virus (False Positives)
+
+**These are false positives.** See the detailed explanation below:
+<details>
+<summary>Click to expand for information about false positives</summary>
+
+## Why Antivirus Software Flags CreamInstaller
+
+CreamInstaller is **not a virus**, but it's commonly flagged because of its functionality:
+
+| Reason | Explanation |
+|--------|-------------|
+| **DLL modification** | Replaces game DLLs to unlock content — behavior similar to some malware |
+| **Process hooking** | Embedded DLC unlockers interact with Steam/Epic/Ubisoft/game processes |
+| **Compressed executable** | Single-file executables are often associated with packed malware |
+| **Not code-signed** | No Extended Validation certificate ($300–500/year) means lower AV reputation (**I will not be paying for this**) |
+| **Misc** | Game modding tools frequently trigger heuristic detections regardless of intent |
+
+## Common False Positive Names
+
+| Detection Name | What It Usually Means / Why It’s a False Positive |
+|----------------------------------------|---------------------------------------------------|
+| Mamson.A!ac | Generic heuristic detection; often triggered by packed or obfuscated executables |
+| Phonzy.A!ml | Machine-learning detection; flags unusual behavior patterns |
+| Wacatac.H!ml | Extremely common false positive; triggered by compressed or self-updating programs |
+| Malgent!MSR | Generic Microsoft label for “suspicious behavior,” not confirmed malware |
+| Tiggre!rfn | Heuristic runtime detection often seen with tools that hook processes |
+| UDS:DangerousObject.Multi.Generic | Reputation-based detection for tools that *can* be abused |
+| Trojan.Win64.Agent | Very broad category; common false positive for unsigned binaries |
+| Trojan.Win64.Agent.oa!s1 | Cloud/AI heuristic variant of the above |
+
+**See also:** [Archived issue #40](https://web.archive.org/web/20240604162435/https://github.com/pointfeev/CreamInstaller/issues/40)
+
+## Verify Safety Yourself
+
+CreamInstaller is **100% open source**:
+
+1. **Review the source code** in this repository
+2. **Build it yourself**
+3. **Compare hashes** of your build with the official release
+
+</details>
 
-**Q:** The program and/or files installed by the program are detected as a virus/trojan/malware.
-**A:** The "issue" of the program's outputted Koaloader DLLs being detected as false positives such as Mamson.A!ac, Phonzy.A!ml, Wacatac.H!ml, Malgent!MSR, Tiggre!rfn, and many many others, has already been posted and explained dozens of times now in many different manners... please do not post it again, you will just be ignored; instead, refer to the explanations within issue #40 and its linked issues: [WebArchived Link: https://github.com/pointfeev/CreamInstaller/issues/40](https://web.archive.org/web/20240604162435/https://github.com/pointfeev/CreamInstaller/issues/40).
 
 ---
 ##### Bugs/Crashes/Issues:
@@ -75,6 +139,7 @@ For reliable and quick assistance, all bugs, crashes and other issues should be
 ##### **HOWEVER**: Please read the [FAQ entry](https://github.com/FroggMaster/CreamInstaller#faq--common-issues) above and/or [template issue](https://github.com/FroggMaster/CreamInstaller/issues/new/choose) corresponding to your problem should one exist! Also, note that the [GitHub Issues](https://github.com/FroggMaster/CreamInstaller/issues) page is not your personal assistance hotline, rather it is for genuine bugs/crashes/issues with the program itself. If you post an issue which is off-topic or has already been explained within the FAQ, template issues, and/or within this text in general, I will just close it and you will be ignored.
 
 ---
+
 ##### More Information:
 * SteamCMD installation and appinfo cache can be found at **C:\ProgramData\CreamInstaller**.
 * The program automatically and very quickly updates from [GitHub](https://github.com/FroggMaster/CreamInstaller) by choice of the user through a dialog on startup.