Add Luminosity Theme #397

mendesimage · 2025-10-28T16:54:50Z

Luminosity - Theme Pack

Luminosity is based on native Acrylic, using the maximum TintLuminosityOpacity value as its backdrop.

It’s meant to be used with Mica or MicaAlt backdrops, with or without Translucent Windows.

I’d like to know if this is a worthwhile contribution. I’ve tried to fix several visual issues, but I’m not sure if I missed any beyond the known ones. If there are complex issues, I might need help fixing them since I’m still new to programming. XP

Overview

Windowglass provided AMAZING help on this theme pack. Thank you, Nathaniel!

I’ve made three Taskbar variants:

Compact
Dock
Classic

Compact

This one is based on personal preference, I like having a smaller Taskbar while working.

I’ve reduced its height “as much as possible.” (I guess)

Since the icons are smaller, it’s meant to be used with Taskbar Labels for Windows 11, using the Centered Running Indicator style. Otherwise, the indicator will clip into the icons.

Also since the Taskbar is smaller, I recommend using Taskbar Clock Customization.

Dock

Docks are also pretty cool!

This version should have the same height as the normal Taskbar.

Unfortunately, the corner radius slightly limits the icon hitbox on the top and bottom, which makes it impossible to minimize windows by clicking in those areas.

Classic

The Dock version can be “easily” reverted to a standard Taskbar layout by deleting the targets after stylesConstants, keeping the theme pack’s visual effects.

It’s designed to cause minimal disruption for users who prefer the classic Taskbar placement.

General Information

The theme changes the following elements:

Taskbar
Taskbar icons (compact version)
Search icon with label
System Tray
- Icon sizes (compact version)
- Chevron box
- Software icon boxes
- Microphone box
- Spacing between element groups
- Tray Overflow Flyout
Alt+Tab window
Win+Tab background and Virtual Desktops bar
Snap Bar and Picker
Volume bar
Window preview flyout
Context menus

Known Issues

The known limitation with AcrylicBrush.

I didn’t know how to fix these. I couldn’t find the correct target names, or I’m not sure if they can even be changed.

The Taskbar icon overflow flyout (when the taskbar is full) doesn’t have a matching border brush and may not have Acrylic.
The window preview doesn’t have a matching border brush, drop shadow corner radius, or “overlay layer.” In the Start Menu, this layer is called AcrylicOverlay, which should be removed.
Some context menus doesn’t have matching drop shadow corner radius.
The search box has incorrect sizing in the Dock and Classic versions.
The search box has incorrect everything in Compact mode.
The Widget/Weather button icon and text have incorrect size and placement in Compact mode.

Notes and Questions

I left some targets without styles, or with funny things and notes, because they were incorrect or needs to reorder several others to be removed. I might find the correct targets later. I also added spacing between targets for readability, does any of that cause any problems?
I was thinking about making both Compact and Dock versions, separated like SideBySide Start Menus, but I don’t know if you agree with it. If yes I can make an update for that.
Built and tested on Windows 11 24H2 Desktop version (I haven’t received the 25H2 update yet, and I don’t have a laptop).
I’ll make a pull requests for the Start Menu and Notification Center after I get feedback on this one.
I’ve censored my account profile picture and device name for privacy, not part of the theme.

I really love the Windhawk project, thank you!

SandTechStuff

Looks good overall, I just have a few tweaks for you to look through.

On the docked variant, the MultiWindowElement appears separated from the main taskbar button. This element is notoriously annoying to work with, so an alternative implementation (eg. using a border on the main taskbar buttons) may be needed for it to look proper. Maybe you can figure it out though, through setting height or rendertransforms.

SandTechStuff · 2025-10-30T03:14:23Z

Themes/Luminosity/README.md

+
+## Known Issues
+
+- There's [a known limitation](https://github.com/ramensoftware/windhawk-mods/issues/742) with ```AcrylicBrush``` which only works if there's a single taskbar. Taskbar in other monitors may appear transparent.


Suggested change

- There's [a known limitation](https://github.com/ramensoftware/windhawk-mods/issues/742) with ```AcrylicBrush``` which only works if there's a single taskbar. Taskbar in other monitors may appear transparent.

IMO this doesn't need to be here, since its stated in the main README

SandTechStuff · 2025-10-30T03:16:17Z

Themes/Luminosity/README.md

+  "controlStyles[17].styles[1]": "CornerRadius=$bcr",
+  "controlStyles[17].styles[2]": "Margin=0,2,0,2",
+
+  "controlStyles[18].target": "Windows.UI.Xaml.Controls.Panel",


How come there is a target and no styles? This appears in other places too.

SandTechStuff · 2025-10-30T03:17:30Z

Themes/Luminosity/README.md

+  "controlStyles[26].target": "Windows.UI.Xaml.Controls.Grid#HoverFlyoutGrid > Windows.UI.Xaml.Controls.Border#HoverFlyoutBackground",
+  "controlStyles[26].styles[0]": "Background:=$mbg",
+  "controlStyles[26].styles[1]": "CornerRadius=$mcr",
+  "controlStyles[26].styles[2]": "Margin=0,0,0,0 future idea",


Suggested change

"controlStyles[26].styles[2]": "Margin=0,0,0,0 future idea",

"controlStyles[26].styles[2]": "//Margin=0,0,0,0 future idea",

Comment this out or remove since it's not a valid style.

SandTechStuff · 2025-10-30T03:18:00Z

Themes/Luminosity/README.md

+
+
+  "controlStyles[30].target": "Windows.UI.Xaml.Controls.Border#BackgroundDimmingLayer",
+  "controlStyles[30].styles[0]": "Background=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",


Suggested change

"controlStyles[30].styles[0]": "Background=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",

"controlStyles[30].styles[0]": "Background:=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",

XAML syntax needs a := instead of =

SandTechStuff · 2025-10-30T03:18:43Z

Themes/Luminosity/README.md

+  "controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",
+  "controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",


Suggested change

"controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",

"controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",

Comment this out or remove since it's not a valid style.

SandTechStuff · 2025-10-30T03:19:47Z

Themes/Luminosity/README.md

+  "controlStyles[26].target": "Windows.UI.Xaml.Controls.Grid#HoverFlyoutGrid > Windows.UI.Xaml.Controls.Border#HoverFlyoutBackground",
+  "controlStyles[26].styles[0]": "Background:=$mbg",
+  "controlStyles[26].styles[1]": "CornerRadius=$mcr",
+  "controlStyles[26].styles[2]": "Margin=0,0,0,0 future idea",


Suggested change

"controlStyles[26].styles[2]": "Margin=0,0,0,0 future idea",

"controlStyles[26].styles[2]": "//Margin=0,0,0,0 future idea",

Comment this out or remove since it's not a valid style.

SandTechStuff · 2025-10-30T03:20:36Z

Themes/Luminosity/README.md

+
+
+  "controlStyles[30].target": "Windows.UI.Xaml.Controls.Border#BackgroundDimmingLayer",
+  "controlStyles[30].styles[0]": "Background=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",


Suggested change

"controlStyles[30].styles[0]": "Background=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",

"controlStyles[30].styles[0]": "Background:=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",

XAML syntax needs a := instead of =

SandTechStuff · 2025-10-30T03:21:46Z

Themes/Luminosity/README.md

+  "controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",
+  "controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",


Suggested change

"controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",

"controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",

Comment this out or remove since it's not a valid style.

SandTechStuff · 2025-10-30T03:22:09Z

Themes/Luminosity/README.md

+  "controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",
+  "controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",


Suggested change

"controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",

"controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",

Comment this out or remove since it's not a valid style. I feel your pain ;)

SandTechStuff · 2025-10-30T03:30:10Z

I didn't know how to fix these. I couldn't find the correct target names, or I'm not sure if they can even be changed.

The Taskbar icon overflow flyout (when the taskbar is full) doesn't have a matching border brush and may not have Acrylic.

The window preview doesn’t have a matching border brush, drop shadow corner radius, or "overlay layer." In the Start Menu, this layer is called AcrylicOverlay, which would be removed if I could.

Some context menus doesn't have matching drop shadow corner radius.

The search box has incorrect sizing in the Dock and Classic versions.

The search box has incorrect everything in Compact mode.

The Widget/Weather button icon and text have incorrect size and placement in Compact mode.

Also LMK if you want help to try and fix some of these.

mendesimage · 2025-10-30T04:22:30Z

I'll make a cleaner JSON with the changes you suggested. Answering some questions, the unstyled targets were there for me to come back to later, but I'll remove them. I also didn't know about the comments feature, and was just being goofy lol

@SandTechStuff
If you can, I would need help with the targets for:

The window preview "overlay layer" and border
Modifying the Widget's icon size to fit the compact taskbar
Moving the Widget's text to also fit the compact taskbar, placing them side-by-side like the date and time. I just had some ideas of where the text targets would be at, but I can only try it tomorrow. I'll let you know if I find them.
Context menus drop shadow

I think these are the most important.

Thanks!

mendesimage · 2025-10-30T04:24:57Z

I misclicked the re-request review button, I'm sorry.

May have errors, I'll review it again when I can. - MultiWindowElement fix-ish It's not looking very good, but I also I didn't had the same issue, not sure if it's because of the Windows version. I don't know how the fix is going to behave in other versions. I should be getting 25h2 soon; I had the option to update last week, but it was failing to install. - I think all unstyled targets have been removed - Removed Acrylic limitation from Known Issues

mendesimage · 2025-10-30T15:07:01Z

For the Compact version, I've found a target related to the Widget text, but both lines have the same name (Windows.UI.Xaml.Controls.TextBlock), moving one also move the other and it don't look right. The upper line kinda is in the correct place by default, so I think just shrinking the icon would look fine.

SandTechStuff · 2025-10-31T06:02:42Z

I misclicked the re-request review button, I'm sorry.

No problem.

I think these are the most important.

Alright, I'll look into these when I have time.

SandTechStuff · 2025-11-01T04:17:03Z

The window preview "overlay layer" and border

The overlay layer's target is Taskbar.TaskItemThumbnailView > Grid@CommonStates > Border#BackgroundBorder

Modifying the Widget's icon size to fit the compact taskbar

There's probably a better way to do this, but this seems a bit better than what we have now.

Context menus drop shadow

Not sure what you mean, like the win+x menu or taskbar right click?

mendesimage · 2025-11-02T17:21:10Z

Thank you very much! I may take some time to apply the updates and work on the project, my house got damages due to bad weather.

Not sure what you mean, like the win+x menu or taskbar right click?

Yes, that's what I meant, sorry.

- Widget icon now fits Compact mode - Window preview border now matches the theme - Rounded close buttons added to window preview and virtual desktops

- Known Issues again - Removed hover highlight on window preview so Acrylic be more visible

mendesimage · 2025-11-05T20:56:35Z

I think I'll leave the Widget bottom text line as it is. In my opinion, it's still readable when hovering the cursor over the widget button.

It seems like the Win + X drop shadow hasn't been changed on other styles as well. It would be nice if it could match the corner radius of the menu, so I'm searching from time to time what the target name might be, but maybe I'll leave it as is too.

After I decide what to do with the Win + X, I'll redo the screenshots and presentation.

mendesimage · 2025-11-06T12:56:55Z

I've found the Win + X target responsible for its drop shadow. :3
I'll update the README soon.

I've forgotten to add the changelog on the previous update. "A lot" have changed. - Code remade from scratch, better organized - Removed drop shadows from most or all things - Rounded Window Preview Flyout buttons - Consistent border for Window Preview Flyout - May look strange when there are multiple windows, I don't know what to do with it at the moment - Rounded Right-Click menu items when hovering over them - Removed Search pill styles from Dock and Classic versions - To reduce issues when using the Search box - Small changes to improve consistency, may not be worth mentioning

- Removed redundancies and generic targets - Added styles to ```SystemTray.Stack#MainStack``` (```SystemTray.IconView#SystemTrayIcon```) - Consistent spacing between tray elements (I hope) - Classic version tweaks

NOW it's done

SandTechStuff

Looks good overall.

SandTechStuff · 2025-11-09T00:29:45Z

Themes/Luminosity/README.md

+  "controlStyles[15].target": "Taskbar.TaskItemThumbnailView > Grid@CommonStates > Border#BackgroundBorder",
+  "controlStyles[15].styles[0]": "Background=$t",


Maybe add some thumbnail preview background color changes for the different hover states, so that it is more clear where your mouse is hovering. Right now it uses one background color no matter if you are not hovering, hovering, or pressing the thumbnail preview.

Or you could remove this style, as I think the stock background color changes look fine. The modified acrylic is applied on target 14.

I removed the hover background because I felt it was compromising the acrylic look; the hovering layer made the material look more "flat."
You can still tell which window you’re hovering by the close button, so I removed it on purpose.

If that's okay I would like to keep it this way, but If you really think it feels incomplete visually, I thought of this:

"controlStyles[15].target": "Taskbar.TaskItemThumbnailView > Grid@CommonStates > Border#BackgroundBorder", "controlStyles[15].styles[0]": "Background:=$t", "controlStyles[15].styles[1]": "BorderThickness=$bt", "controlStyles[15].styles[2]": "CornerRadius=$mcr", "controlStyles[15].styles[3]": "BorderBrush@Normal=$t", "controlStyles[15].styles[4]": "BorderBrush@PointerOver=#23FFFFFF",

mendesimage added 8 commits October 28, 2025 12:08

Create Luminosity

e0cc4ec

Delete Themes/Luminosity

5b477f6

Add files via upload

5ecf517

Update README.md

25e6d5e

Better JSON for recommended mods - README.md

edbcdb8

Typo fixes - README.md

ced133e

Improved clarity there

f9023b0

AcrylicBrush limitation added to Known Issues

f750145

SandTechStuff suggested changes Oct 30, 2025

View reviewed changes

mendesimage requested a review from SandTechStuff October 30, 2025 04:24

mendesimage added 2 commits October 30, 2025 11:51

Missing XAML syntax from Dock/Classic

960a3da

SandTechStuff removed their request for review October 31, 2025 06:02

mendesimage added 3 commits November 5, 2025 16:02

Updates - May have issues

768b514

- Widget icon now fits Compact mode - Window preview border now matches the theme - Rounded close buttons added to window preview and virtual desktops

Updated Known Issues

68675e0

Tweaks

4153aee

- Known Issues again - Removed hover highlight on window preview so Acrylic be more visible

mendesimage added 2 commits November 7, 2025 18:14

Add files via upload

87bec36

Delete Themes/Luminosity/volumebar.png

09f7436

mendesimage requested a review from SandTechStuff November 7, 2025 21:21

mendesimage added 2 commits November 7, 2025 19:42

SystemTray rewrite

edf0f20

- Removed redundancies and generic targets - Added styles to ```SystemTray.Stack#MainStack``` (```SystemTray.IconView#SystemTrayIcon```) - Consistent spacing between tray elements (I hope) - Classic version tweaks

mendesimage added 3 commits November 8, 2025 12:30

MultiWindowElement and Window Preview fixes

8312098

Dock version SystemTray margin fix

ea241ed

NOW it's done

Search pill margin fix for Dock and Classic versions

b872a26

SandTechStuff suggested changes Nov 9, 2025

View reviewed changes


		## Known Issues

		- There's [a known limitation](https://github.com/ramensoftware/windhawk-mods/issues/742) with ```AcrylicBrush``` which only works if there's a single taskbar. Taskbar in other monitors may appear transparent.

	"controlStyles[26].styles[2]": "Margin=0,0,0,0 future idea",
	"controlStyles[26].styles[2]": "//Margin=0,0,0,0 future idea",



		"controlStyles[30].target": "Windows.UI.Xaml.Controls.Border#BackgroundDimmingLayer",
		"controlStyles[30].styles[0]": "Background=<WindhawkBlur BlurAmount=\"30\" TintColor=\"#00000000\" />",

		"controlStyles[25].target": "Windows.UI.Xaml.Controls.MenuFlyoutPresenter > Windows.UI.Xaml.Controls.Border",
		"controlStyles[25].styles[0]": "CornerRadius=WHYYYY DOESNT IT GET ROUNDED ITS THE WRONG TARGEEEEEEET",

		"controlStyles[15].target": "Taskbar.TaskItemThumbnailView > Grid@CommonStates > Border#BackgroundBorder",
		"controlStyles[15].styles[0]": "Background=$t",

Add Luminosity Theme #397

Are you sure you want to change the base?

Add Luminosity Theme #397

Uh oh!

Conversation

mendesimage commented Oct 28, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Luminosity - Theme Pack

Overview

Compact

Dock

Classic

General Information

Known Issues

Notes and Questions

Uh oh!

SandTechStuff left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SandTechStuff Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

SandTechStuff commented Oct 30, 2025

Uh oh!

mendesimage commented Oct 30, 2025

Uh oh!

mendesimage commented Oct 30, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mendesimage commented Oct 30, 2025

Uh oh!

SandTechStuff commented Oct 31, 2025

Uh oh!

SandTechStuff commented Nov 1, 2025

Uh oh!

mendesimage commented Nov 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

mendesimage commented Nov 5, 2025

Uh oh!

mendesimage commented Nov 6, 2025

Uh oh!

SandTechStuff left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

mendesimage commented Oct 28, 2025 •

edited

Loading

SandTechStuff Oct 30, 2025 •

edited

Loading

mendesimage commented Oct 30, 2025 •

edited

Loading

mendesimage commented Nov 2, 2025 •

edited

Loading