New mod: OmniButton Customizer v1.0

[sb4ssman]

Adds OmniButton Customizer (v1.0): gives independent layout and appearance control over every native Windows 11 OmniButton item — wifi, volume, battery, and battery percentage — for both standard and multi-row taskbars.

This supersedes the narrower Vertical OmniButton implementation previously proposed in this PR. Vertical layout remains available as one configuration of the full customizer.

Highlights:

• Arrange the four native items in a smart grid, single row/column, or fixed rows/columns/grid, with row- or column-first fill and short-group placement/alignment.
• Reorder items with a comma-separated itemOrder list or omit tokens to hide individual items. Items unavailable on the current system are skipped.
• Keep battery and percentage coupled as Windows renders them, or make them independent grid items that can occupy non-adjacent cells.
• Control each item independently: color, glyph size, font family, opacity, and X/Y optical nudges, plus group padding and visual offsets.
• Preserve the native ControlCenterButton, Quick Settings behavior, and tray ordering. Exact original XAML dependency-property values are restored on settings changes and unload.
• Hardened taskbar lifecycle: taskbar-thread-only XAML cleanup, exception-contained callbacks, bounded startup retry, and Explorer/taskbar restart recovery.

Screenshots (also embedded in the mod readme):

Tested live on Windows 11: default compact 2×2, reordered single-row and tall vertical layouts, independent and coupled battery/percentage, per-item optical nudges, a busy multi-row tray alongside other mods, settings reload, Explorer restart, Quick Settings interaction, and disable/native restoration/re-enable.

Changelog

If this pull request updates an existing mod, describe the changes below:

• Replaced the proposed Vertical OmniButton implementation with the full OmniButton Customizer v1.0.

Mod authorship

If this pull request introduces a new mod, please complete the section below.

This mod was created by:

• • The submitter, without AI assistance
• • The submitter, with AI assistance
• • Claude
• • ChatGPT
• • Gemini
• • Another AI (please specify):
• • Other (please specify):

Please select the options that best apply. Your selection does not affect the acceptance criteria, but it helps reviewers understand the context of the code and provide relevant feedback.

[sb4ssman]

This version should be much more agreeable.

[m417z]

I see that the code is similar to #3932 which I reviewed. Please apply my comments here too, let me know when it's ready for review.

[sb4ssman]

Updated to v1.4 with the review comments applied (same changes as #3932):

• GetSystemTrayModuleHandle() pattern: tries SystemTray.dll first (Win11 26200+), falls back to Taskbar.View.dll (skipped at version ≥2604), then ExplorerExtensions.dll
• GetTaskbarXamlRoot: added #elif defined(_M_ARM64) and #else #error arms
• Added -lversion to compilerOptions; switched to WindhawkUtils::Wh_SetFunctionHookT

Also included since the last review:

• buttonHorizontalPadding setting to control OmniButton width
• Stoppable retry thread (no dangling thread handle on uninit)
• Inline mode: button auto-sizes instead of fixed width, so the hover highlight matches the battery glyph + % text exactly

[m417z]

Please use the same code as can be found here:
https://github.com/m417z/my-windhawk-mods/blob/e1261d85c2f42006b0dc355fbbc3a8d71a078585/mods/taskbar-multirow.wh.cpp#L261-L291

In this mod and your other mod.

[m417z]

The mod already hooks IconView::IconView, so why is this thread needed?

[m417z]

Use %% to escape the % sign.

[m417z]

Suggested change

	into Windows 11 Taskbar Styler → Settings → Advanced.
	into Windows 11 Taskbar Styler → Settings → Textual mode.

[m417z]

Unsubscribe after handling, otherwise the callback might be called again when the mod is unloaded, causing a crash. There's an example below, but if you prefer something simpler, allocate memory for the revoke token, assign it from iconView.Loaded, pass the pointer to the lambda, and unsubscribe when it's called.

windhawk-mods/mods/taskbar-tray-system-icon-tweaks.wh.cpp

Lines 1321 to 1331 in a5fb564

	g_autoRevokerList.emplace_back();
	auto autoRevokerIt = g_autoRevokerList.end();
	--autoRevokerIt;
	*autoRevokerIt = iconView.Loaded(
	winrt::auto_revoke_t{},
	[autoRevokerIt](winrt::Windows::Foundation::IInspectable const& sender,
	RoutedEventArgs const& e) {
	Wh_Log(L">");
	g_autoRevokerList.erase(autoRevokerIt);

[sb4ssman]

@m417z Vertical-omnibutton was the first pass at this; in the interim I built a more comprehensive replacement (omnibutton-customizer) that covers vertical as one configuration of a full grid layout, adds per-element nudging, item reordering, and fill-order control among other details. I'd like to close this PR and submit omnibutton-customizer instead as the single OmniButton mod. Do you have any concerns with that, may I just close it and submit?

[m417z]

No concerns, go ahead. Alternatively, you can update this PR, whatever you prefer.

[sb4ssman]

Closing in favor of #4855, which submits OmniButton Customizer v1.0 on a correctly named branch with a clean thread. Same code, same file (mods/omnibutton-customizer.wh.cpp). Thanks!