Skip to content

Commit ebfb585

Browse files
committed
Update README
1 parent 1d3f355 commit ebfb585

1 file changed

Lines changed: 11 additions & 73 deletions

File tree

README.md

Lines changed: 11 additions & 73 deletions
Original file line numberDiff line numberDiff line change
@@ -14,85 +14,49 @@ SecureUxTheme is a piece of software that removes signature verification of styl
1414
* Probably quite future-proof
1515
* Fixes LogonUI resetting some colors on locking
1616

17-
## Limitations
17+
## Operating System Support
1818

19-
Styles must still have a format-wise valid signature appended, it is just not verified. For this reason themes need to be applied with the tool, rather than in Personalization / Themes.
20-
21-
## Operating System Support\*
22-
23-
* Windows 8.1
24-
* Windows 10
25-
* Windows 11 (tested: 21H2, 22H2)
26-
* Future versions\*\*
27-
28-
\* Windows 7 or older will never be supported due to the way themes are implemented.
29-
30-
\*\* The current code doesn't depend on any code, binary or memory layout of uxtheme and related dlls, therefore should work unless major changes are made to how themes in general work.
19+
* Windows 8.1 x86/x64
20+
* Windows 10 x86/x64/ARM64
21+
* Windows 11 (RTM -> 24H2) x86/x64/ARM64
22+
* Future versions (untested) x86/x64/ARM64
3123

3224
## Download
3325

3426
[Latest release](https://github.com/namazso/SecureUxTheme/releases/latest/)
3527

36-
[Development builds](https://github.com/namazso/SecureUxTheme/actions)
37-
3828
[Scoop:](https://scoop.sh/)
3929
```shell
4030
scoop bucket add extras
4131
scoop install secureuxtheme
4232
```
4333

44-
## LogonUI fix
45-
46-
Locking Windows makes LogonUI reset certain colors and ignore the currently set style. This tool can fix this problem. A picture comparison showing the Task Manager opened after locking Windows without and with the fix can be seen here:
47-
48-
![LogonUI problem](https://github.com/user-attachments/assets/dddd3b87-a507-4d8d-bea7-5ac1bb4b8023)
49-
50-
Do note this feature might mess up some high contrast theme features when locking.
51-
5234
## Screenshot
5335

54-
Program:
55-
56-
![ThemeTool Screenshot](https://github.com/user-attachments/assets/44d007ad-fe4e-4e34-b4bc-c8726670a15b)
57-
58-
This is only a tool for enabling custom themes, no actual visual changes will be made.
59-
Regardless, here's a cool theme for illustration:
36+
This is only a tool for enabling custom themes; no actual visual changes will be made. Regardless, here is a cool theme for illustration:
6037

6138
![Screenshot](https://github.com/user-attachments/assets/2c0301f2-8392-426d-9b19-bb29500a0eea)
6239

6340
[Theme used](https://www.deviantart.com/niivu/art/10-Pro-Edition-802720222)
6441

6542
## Where to get themes
6643

67-
I recommend [DeviantArt](https://www.deviantart.com/tag/windows10themes) for finding themes, although it is a bit noisy. Alternatives are [7themes.su](https://7themes.su/) which is much more organized (but be wary of fake adware download buttons! use the one that says Яндекс.Диск). Also, you can just search for themes with your favorite search engine. Make sure that the theme you're about to apply is compatible with your windows version.
68-
69-
## Donations
70-
71-
This software is provided completely free of charge to you, however I spent time and effort developing it. If you like this software, please consider making a donation:
72-
73-
* Bitcoin: 1N6UzYgzn3sLV33hB2iS3FvYLzD1G4CuS2
74-
* Monero: 83sJ6GoeKf1U47vD9Tk6y2MEKJKxPJkECG3Ms7yzVGeiBYg2uYhBAUAZKNDH8VnAPGhwhZeqBnofDPgw9PiVtTgk95k53Rd
44+
I recommend [DeviantArt](https://www.deviantart.com/tag/windows11themes) for finding themes. Make sure that the theme you're about to apply is compatible with your Windows version.
7545

7646
## Frequently Asked Questions
7747

78-
### **Q: Help, SecureUxTheme broke my install and it's login looping now**
48+
### **Q: Help, SecureUxTheme broke my installation, and it's login looping now**
7949

8050
A: [Help: Login loop after installing SecureUxTheme](https://github.com/namazso/SecureUxTheme/wiki/Help:-Login-loop-after-installing-SecureUxTheme)
8151

8252
---
8353

84-
### **Q: Help, a theme broke my install and it's login looping now**
54+
### **Q: Help, a theme broke my installation, and it's login looping now**
8555

8656
A: [Help: Login loop after setting a theme](https://github.com/namazso/SecureUxTheme/wiki/Help:-Login-loop-after-setting-a-theme)
8757

8858
---
8959

90-
### **Q: I just want a themed Windows, what do I do with all this?**
91-
92-
A: [Help: Step by step installing SecureUxTheme and a custom theme](https://github.com/namazso/SecureUxTheme/wiki/Help:-Step-by-step-installing-SecureUxTheme-and-a-custom-theme)
93-
94-
---
95-
9660
### **Q: I have 1909 or later, and the Address bar / Search bar is weird when clicked**
9761

9862
A: Consider using OldNewExplorer which fixes this. Alternatively, see [Issue #6](https://github.com/namazso/SecureUxTheme/issues/6).
@@ -101,39 +65,13 @@ A: Consider using OldNewExplorer which fixes this. Alternatively, see [Issue #6]
10165

10266
### **Q: Can you make themes per-program?**
10367

104-
A: Unfortunately, this is [close to impossible](https://github.com/namazso/SecureUxTheme/issues/9#issuecomment-611897882). However for Office programs, there is a [plugin](https://github.com/matafokka/ExcelDarkThemeFix) for fixing this.
68+
A: Unfortunately, this is [close to impossible](https://github.com/namazso/SecureUxTheme/issues/9#issuecomment-611897882). However, for Office programs, there is a [plugin](https://github.com/matafokka/ExcelDarkThemeFix) for fixing this.
10569

10670
---
10771

108-
### **Q:** `SelectTheme: pTheme->GetVisualStyle failed with 80070002`
109-
110-
A: You probably installed a theme by opening / double clicking. Custom themes cannot be installed like that, they must be moved to `%WINDIR%\Resources\Themes` with all their accompanying files.
111-
112-
## Is it SecureUxTheme or ThemeTool? And what does it stand for anyways?
113-
114-
Naming has been pretty messy in this project, I admit that. Originally this project was for myself, and consisted of only the hooking dll, and required hex-editing the invalid signature to the themes. The project was named SecureUxTheme. In hindsight, this was a pretty bad naming. While it contains "secure" in the name, it is rather "safe" instead of "secure". The UxTheme part comes from the dll name (`uxtheme.dll`) which needed to be patched on XP when visual styles were introduced. This dll is no longer containing the signature verification code since Windows Vista, however the name stuck, and all software similar to this are called uxtheme-patchers. Anyways, after deciding to release, I added a new component named "ThemeInvalidSigner" for adding the invalid signature to themes, and also an NSIS installer so that you don't have to run .reg files. This was the initial release. Later I grew tired of various problems and issue reports with the built-in Personalization I was using for letting users set themes, and this is when ThemeTool was born. It originally was a proof-of-concept app for setting themes via the IThemeManager2 COM interface I reverse-engineered, however it soon got the capability of patching themes, and eventually replaced the installer too. This also improved on the virus detections, for unknown reasons.
115-
116-
**TL;DR**: SecureUxTheme is the project and the hook dll, ThemeTool is the installer / UI component.
117-
11872
## Building
11973

120-
### Requirements
121-
122-
* Visual Studio 2022 (or above) with x86, x64, ARM64 toolchains
123-
124-
### Compiling
125-
126-
Note that the order of the builds is important, building ThemeTool will fail if some architecture is missing SecureUxTheme build.
127-
128-
1. Open SecureUxTheme.sln
129-
2. Build SecureUxTheme as Release/Win32
130-
3. Build SecureUxTheme as Release/ARM64
131-
4. Build SecureUxTheme as Release/x64
132-
5. Build ThemeTool as Release/Win32
133-
134-
### Debugging
135-
136-
[not fun](https://learn.microsoft.com/en-us/windows-hardware/drivers/debugger/debugging-winlogon)
74+
Good luck!
13775

13876
## License
13977

0 commit comments

Comments
 (0)