Common Toggle Button UI v1.3.0

Release Notes — v1.3.0.0

Date: 2025-12-15

Summary

Small feature release focused on Windows 11 visual improvements, more toast customization, improved packaging workflow for auto-updates, and reliability fixes.

Highlights

• Windows 11 theming and backdrop improvements (Mica / system backdrop support).
• New toast customization options: position, optional sound, and custom border settings.
• Packaging and release automation improved — helper script to update .appinstaller URIs for stable auto-update locations.
• Reliability and UX fixes: better fullscreen suppression and focus-safe overlays.

Added

• Toast position control (ToastPosition) allowing selection of BottomRight, BottomLeft, TopRight, and TopLeft.
• Optional play sound setting for toggles (PlaySound) — disabled by default.
• Toast border customization (ToastBorderSettings) — toggle a colored border, use accent color, and set thickness.
• Compact toast style refinements for a less intrusive experience.
• scripts\Update-AppInstaller.ps1 included for updating .appinstaller and package download URIs after release.
• Native interop additions to support Windows 11 backdrop and theming (ThemeInterop).

Improvements

• Improved fullscreen suppression so notifications respect fullscreen apps more reliably.
• Overlay windows no longer steal input focus and better integrate with high-DPI / multiple monitor setups.
• Packaging naming convention standardized to ToggleNotifier.Package_{Version}_{Arch}.msix to match release assets and the update script.
• Clearer packaging and post-release instructions added to repository to simplify publishing.

Fixed

• Occasional toast flicker on multi-monitor setups.
• Race condition when reading/writing settings on first-run.
• Minor memory usage improvements in the notification / hook path.

Packaging & Deployment

• Use the included scripts\Update-AppInstaller.ps1 to update .appinstaller files before uploading release assets. The script sets:
  • The stable update check URL (AppInstaller.Uri) to a stable hosting location (e.g. GitHub Pages under /releases/).
  • The MainPackage.Uri to the versioned download at https://github.com/<owner>/<repo>/releases/download/v{Version}/ToggleNotifier.Package_{Version}_{Arch}.msix.
• Upload generated .msix and .appinstaller files to GitHub Release v1.3.0.0.
• Copy .appinstaller files to your chosen stable host (e.g., gh-pages branch /releases/) so installed clients can find updates.

Upgrade Notes

• No breaking configuration changes. New settings are optional and have sensible defaults; existing appsettings.json will continue to work.
• If you use a custom auto-update hosting arrangement, verify the AppInstaller.Uri points to a stable path that always serves the latest .appinstaller.

Common Toggle Button UI v1.2.0

Release Notes - v1.2.0

Release Date: December 2024

---

New Features

Custom Border Colors for Toast Notifications

Add a personalized touch to your notifications with customizable colored borders!

• Enable/Disable Custom Border - Toggle a colored border around toast notifications
• Color Picker - Choose any color using the Windows color picker dialog
• Windows Accent Color Integration - Defaults to your Windows 11 accent color for a seamless look
• Reset to Accent - One-click button to restore the Windows accent color
• Adjustable Thickness - Configure border thickness from 0.5 to 10 pixels

---

Improvements

Enhanced Settings UI

• Wider Default Window - Settings window now opens at 580px width (up from 520px) for better readability
• Visual Separation - Header and footer sections now have distinct background colors to clearly indicate non-scrollable areas
• Larger Status Indicators - The on/off status indicator circles are now larger and more visible:
  • Standard toast: 16x16px (previously 12x12px)
  • Compact toast: 14x14px (previously 12x12px)

Fixed Auto-Update Mechanism

• Corrected AppInstaller URLs - Fixed the update check mechanism to properly detect new versions
• Stable Update Endpoint - Updates now check against a stable GitHub Pages URL rather than version-specific release URLs
• Improved Documentation - Added detailed comments explaining the correct update workflow

---

Technical Changes

New Settings

Added ToastBorderSettings class with the following properties:

Property	Type	Default	Description
EnableCustomBorder	bool	false	Enable/disable custom border
CustomBorderColor	string?	null	Hex color (e.g., "#0078D4")
UseAccentColor	bool	true	Use Windows accent color
BorderThickness	double	2	Border width in pixels

Theme Service Enhancements

• GetWindowsAccentColor() - Retrieves the current Windows accent color from system settings
• ParseHexColor() - Parses hex color strings to WPF Color objects
• ColorToHex() - Converts Color objects to hex strings for storage

---

Installation

New Installation

Download the .appinstaller file for your architecture:

• x64 (Intel/AMD 64-bit): ToggleNotifier.Package_x64.appinstaller
• x86 (32-bit): ToggleNotifier.Package_x86.appinstaller
• ARM64: ToggleNotifier.Package_ARM64.appinstaller

Upgrading from v1.1.x

If you have auto-updates enabled, the application will prompt you to update on next launch. Your settings will be preserved.

---

Bug Fixes

• Fixed update mechanism not detecting new versions due to incorrect URL configuration

---

Full Changelog

New Features:

• Custom colored border for toast notifications
• Color picker with Windows accent color default
• Reset to accent color button

Improvements:

• Wider settings window (580px default)
• Distinct header/footer backgrounds in settings
• Larger on/off status indicators
• Corrected auto-update URL configuration

Technical:

• Added ToastBorderSettings to AppSettings
• Added accent color retrieval to ThemeService
• Updated Update-AppInstaller.ps1 script
• Added HeaderFooterBackgroundBrush theme resource

Common Toggle Button UI v1.1.0

v1.1.0

What's New

Fullscreen Suppression

Notifications now automatically hide when a fullscreen application is running. Perfect for gaming sessions or watching videos—no more toast popups interrupting your experience.

• Enabled by default
• Toggle on/off in Settings → Behavior → Suppress in fullscreen

Compact Toast Style

Choose between two notification styles to match your preference:

Style	Description
Standard	Full toast with key icon, name, state text, and status indicator
Compact	Minimal design showing only the key symbol and a small status dot

The compact style provides a sleek, unobtrusive indicator that takes up less screen space.

Snooze Notifications

Need to temporarily pause notifications? Right-click the tray icon and select Snooze notifications:

• 30 minutes
• 1 hour
• 2 hours

While snoozed:

• Tray tooltip shows remaining time
• Resume notifications option appears to cancel early

---

Settings Summary

New options available in the settings window:

• Toast style (Appearance) – Switch between Standard and Compact
• Suppress in fullscreen (Behavior) – Hide notifications during fullscreen apps

---

Technical Details

• Built on .NET 10
• Uses Win32 APIs for reliable fullscreen detection
• Snooze state persists in memory (resets on app restart)

---

Full Changelog: v1.0.0...v1.1.0

Common Toggle Button UI v1.0.0

Toggle Notifier v1.0.0

Initial Public Release

A lightweight Windows 11 utility that displays elegant toast notifications when you toggle Caps Lock, Num Lock, or Scroll Lock keys.

Features

Toast Notifications

• Instant visual feedback when toggling Caps Lock, Num Lock, or Scroll Lock
• Customizable position - display in any corner of the screen
• Adjustable timing - configure how long notifications stay visible
• Multi-monitor support - notifications appear on the active display

Theme Support

• Automatic dark/light mode - follows your Windows system theme
• Manual theme override - choose Light, Dark, or System
• High contrast mode support for accessibility

Customization

• Per-key notifications - enable/disable notifications for each key individually
• Position offsets - fine-tune notification placement with pixel-perfect control
• Sound alerts - optional audio feedback when keys are toggled

System Integration

• System tray - runs quietly in the background
• Launch at sign-in - optionally start with Windows
• Automatic updates - checks for updates on each launch (sideload version)

Download

Architecture	Download
64-bit (x64)	ToggleNotifier.Package_2.0.0.0_x64.appinstaller
32-bit (x86)	ToggleNotifier.Package_2.0.0.0_x86.appinstaller

Installation

1. Download the .appinstaller file for your system architecture
2. Double-click to install
3. If prompted about an unknown publisher, click Install anyway (the app is self-signed)
4. The app will start automatically and appear in your system tray

System Requirements

• Windows 10 version 2004 (Build 19041) or later
• Windows 11 (recommended)

Screenshots

Toast notification showing Caps Lock status

Settings

Access settings by right-clicking the system tray icon and selecting Settings:

• Theme - System / Light / Dark
• Position - Bottom Right / Bottom Left / Top Right / Top Left
• Offsets - Horizontal and vertical distance from screen edge
• Duration - How long notifications display (in milliseconds)
• Monitored Keys - Toggle notifications for each key
• Sound - Enable/disable audio feedback
• Startup - Launch automatically when signing in to Windows