Deskband11Lib.Core 1.3.8

Deskband11Lib

🌐 English | 한국어

Deskband11Lib is a library for building rich, always-visible taskbar companions on Windows 11. It lets your app place real UI content directly inside the taskbar, making compact dashboards, quick controls, status indicators, media widgets, launchers, and productivity tools feel like a native part of the desktop.

Packages

Deskband11Lib comes in multiple NuGet packages, one for each supported UI framework. A shared Deskband11Lib.Core package holds the taskbar hosting engine. Future frameworks such as Avalonia can be added as additional facade packages.

Highlights

• Build taskbar-resident widgets using your framework's native controls and styling.
• Show live information where users can see it at a glance without opening a full window.
• Add compact controls for actions such as timers, media playback, account switching, build status, device monitoring, or quick launch workflows.
• Automatically fit content into the available taskbar space without overlapping pinned apps or the notification area.
• Run multiple instances side by side in the same taskbar area with automatic slot coordination — each instance gets its fair share of the available space.
• Built-in easing functions (Linear, Sine, Quadratic, Cubic, Quartic, Quintic, Exponential, Circle) for smooth layout animations.
• Optional high refresh rate mode that matches the layout animation timer to the target monitor's current refresh rate for smoother motion on high refresh rate displays.
• Recover cleanly when Explorer restarts by letting the application rebuild its hosted window.
• WinUI facade supports Windows App SDK apps and NativeAOT publishing.

Install

Choose the package that matches your UI framework:

# WinUI 3
dotnet add package Deskband11Lib.WinUI

# WPF
dotnet add package Deskband11Lib.Wpf

The Deskband11Lib.Core package is pulled in automatically as a transitive dependency.

Basic Usage

WinUI 3

Create a WinUI window, create a TaskbarContentHost, attach it after the initial taskbar layout is ready, then activate the window.

using Deskband11Lib.Core;
using Deskband11Lib.WinUI;

var window = new MainWindow();
var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 360,
    PreferredHeight = 48
});

await host.AttachWhenLayoutReadyAsync();
window.Activate();

WPF

The WPF API is identical. The only difference is the UI framework namespace used for Window and FrameworkElement.

using Deskband11Lib.Core;
using Deskband11Lib.Wpf;

var window = new MainWindow();
var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 360,
    PreferredHeight = 48
});

await host.AttachWhenLayoutReadyAsync();
window.Show();

Explorer Restart

When Explorer restarts, the taskbar destroys the hosted child window. Handle TaskbarWindowRecreated to replace the window:

host.TaskbarWindowRecreated += async (_, _) =>
{
    await RecreateMainWindowAsync();
};

Secondary Monitor Reconnection

When you set PreferredMonitorIdentity to a secondary monitor's taskbar and that monitor is later disconnected, Deskband11Lib automatically falls back to the primary taskbar. When the secondary monitor is reconnected, the hosted window moves back to the secondary monitor's taskbar automatically — no application code is required.

Multi-Instance Slot Coordination

Deskband11Lib supports running multiple instances in the same taskbar area simultaneously. When several instances target the same placement area on the same monitor, they automatically coordinate via a shared memory slot registry and divide the available space without overlapping each other.

Slot Allocation

Each registered instance is called a slot. Slots are ordered by (ManualSlotPriority, SlotIndex) — lower ManualSlotPriority values place the instance earlier (further from the notification area in left-aligned mode). Among slots with the same ManualSlotPriority, arrival order (SlotIndex) breaks the tie.

Width allocation follows a Fixed-then-Stretch model:

• Fixed slots — instances with a finite PreferredWidth get their requested width, in priority order, until available space runs out. Lower-priority Fixed slots that do not fit receive whatever remains (which may be zero).
• Stretch slots — instances with PreferredWidth = double.MaxValue split the remaining space equally after all Fixed slots are served.

When AllowFixedSlotResize is true (the default) and the available space is too small to serve every resizable Fixed slot at its requested width, those slots shrink proportionally to their PreferredWidth instead of being starved to zero. Non-resizable Fixed slots (AllowFixedSlotResize = false) keep priority-ordered first-served behavior and are served before resizable Fixed slots. Stretch slots always split whatever remains after all Fixed slots are served.

Empty slots leave gaps — the remaining instances do not reflow to fill them.

Manual Slot Priority

By default, all instances have ManualSlotPriority = 65535, which means they are ordered purely by arrival time. Set a lower value to pin an instance ahead of auto-ordered instances:

var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = 200,
    ManualSlotPriority = 100
});

Stretch Mode

Set PreferredWidth to double.MaxValue to make an instance stretch to fill whatever space remains after Fixed slots are allocated:

var host = new TaskbarContentHost(window, rootElement, new TaskbarContentHostOptions
{
    PreferredWidth = double.MaxValue
});

When all instances in an area are Stretch, they share the space equally.

How It Works

Deskband11Lib gives your app a taskbar-sized surface and keeps that surface aligned with the real taskbar layout. Internally, it uses regular Win32 window parenting:

• Finds the primary taskbar window, Shell_TrayWnd, or a secondary monitor's taskbar window, Shell_SecondaryTrayWnd, based on PreferredMonitorIdentity.
• Creates or receives a normal framework Window from the application.
• Changes the window style from popup-style top-level window to child window.
• Calls SetParent to place the window under the taskbar.
• Calculates the available rectangle between the taskbar buttons and the notification area, taking taskbar alignment (left or center) into account.
• Moves and clips the hosted window to that rectangle with SetWindowPos and SetWindowRgn.

On current Windows 11 builds, the taskbar child HWND hierarchy alone does not expose reliable button widths, and the taskbar content may be left-aligned or centered. Deskband11Lib solves this with UI Automation:

• Button detection. UI Automation precisely targets the Start button (AutomationId = StartButton), the optional Widgets button, and the contiguous taskbar app button group.
• Alignment detection. The library reads the TaskbarAl registry value and falls back to inferring alignment from the Start button position.
• Gap selection. When centered, it picks the more spacious of the two free gaps around the Start button group, so content never overlaps the Start button, app buttons, Widgets button, or the notification area.
• Secondary monitors. Where the notification area has no dedicated HWND, UI Automation also locates the clock and notification cluster (AutomationId = SystemTrayIcon / NotifyItemIcon) to compute the right boundary.

Options

All options live in Deskband11Lib.Core.TaskbarContentHostOptions and are shared across all facades.

Taskbar Alignment

Deskband11Lib detects whether the Windows 11 taskbar is left-aligned or centered by reading the TaskbarAl registry value, falling back to inferring the alignment from the Start button position. Call GetTaskbarAlignment() on a TaskbarContentHost to get a TaskbarAlignment (Left, Center, or Unknown). The detected alignment drives Placement = Auto.

Built-in Easing Functions

Deskband11Lib.Core.EasingFunctions provides these easing functions for LayoutAnimationEasing:

• EasingFunctions.Linear
• EasingFunctions.SineIn / SineOut / SineInOut
• EasingFunctions.QuadraticIn / QuadraticOut / QuadraticInOut
• EasingFunctions.CubicIn / CubicOut / CubicInOut
• EasingFunctions.QuarticIn / QuarticOut / QuarticInOut
• EasingFunctions.QuinticIn / QuinticOut / QuinticInOut
• EasingFunctions.ExponentialIn / ExponentialOut / ExponentialInOut
• EasingFunctions.CircleIn / CircleOut / CircleInOut

You can also pass any Func<double, double> delegate for custom easing.

Sample Projects

The snippets above show the core API shape, but a real taskbar companion should follow the sample projects for window lifetime, startup ordering, Explorer restart recovery, and framework-specific hosting details. Start from the sample that matches your UI stack:

• Deskband11Lib.WinUI.Sample for WinUI 3 and Windows App SDK apps.
• Deskband11Lib.Wpf.Sample for WPF apps, including the transparent borderless host window setup.

Requirements

• Windows 11.
• The target framework must be compatible with your chosen UI framework.
• WinUI 3 requires Windows App SDK.
• WPF requires UseWPF=true in the project file.

Project Development

dotnet restore
dotnet build Deskband11Lib.slnx -c Debug
dotnet publish Deskband11Lib.WinUI.Sample\Deskband11Lib.WinUI.Sample.csproj -c Release -r win-x64

Acknowledgements

Special thanks to zadjii and Deskband11. The core idea of bringing application content into the Windows 11 taskbar comes from that project, and Deskband11Lib is grateful for the brilliant inspiration.

License

Deskband11Lib is licensed under the MIT License.

Author

Created by Howon Lee (airtaxi).