Skip to content

CLAUDE.md

Latest commit

 

History

History
65 lines (44 loc) · 3.18 KB

CLAUDE.md

File metadata and controls

65 lines (44 loc) · 3.18 KB

OpenGlass

Aero Glass effect utility for Windows 10+ (minimum 1809). Reverse-engineers dwmcore.dll and uDWM.dll internals. Three components: OpenGlass.dll (core/payload), OpenGlassHost.exe (service wrapper), OpenGlassGUI.exe (wxWidgets frontend).

Architecture

  • Service-DLL: OpenGlassHost.exe loads OpenGlass.dll and calls ServiceMain (in ServiceHandler.cpp).
  • Injection: The service logic (GlassService.cpp) injects OpenGlass.dll into dwm.exe. IPC via named pipe \\.\pipe\Global\OpenGlassHostPipe.
  • DWM hooks: Uses knsoft-slimdetours for hooking, build-specific offsets (dwmcoreProjection.Offsets.hpp, uDwmProjection.Offsets.hpp), and symbol loading (SymbolParser.hpp).
  • Configuration: Registry HKCU\SOFTWARE\Microsoft\Windows\DWM (user) and HKLM\SOFTWARE\Microsoft\Windows\DWM (system). UI access in OpenGlassGUI/RegistryConfig.cpp.

Code conventions

  • Indentation: Tabs. Braces: Allman style.
  • Naming: PascalCase classes/namespaces/functions; m_ member prefix; g_ global prefix.
  • Error handling: WIL macros (THROW_IF_FAILED, RETURN_IF_FAILED, LOG_IF_FAILED).
  • Memory: Injected DLL uses HeapAlloc from OpenGlass::Util::g_processHeap (overloaded new/delete in dllmain.cpp).
  • Logging: WIL macros → DbgView.

Graphics

  • Shaders: HLSL (.hlsl) compiled via D3D11 in BlurEffect.cpp and AeroColorizationEffect.cpp.
  • Assets: Supports custom atlas (CustomThemeAtlas) and reflection textures.

GUI

  • Split across MainFrame.Core.cpp, MainFrame.State.cpp, MainFrame.Tabs.cpp.
  • MainFrame::NotifySettingsChange sends WM_DWMCOLORIZATIONCOLORCHANGED / WM_THEMECHANGED.
  • Path validation: ensureFilePath in RegistryConfig.cpp.

Build & Debug

  • MSBuild + vcpkg (deps: wxwidgets, wil, knsoft-slimdetours).
  • Emergency exit: Ctrl+Win+Shift+Q kills dwm.exe (registered in OpenGlass.cpp).

Offset files

Each offset struct has an inline comment documenting the verification function, pseudocode pattern, and cross-references. When re-extracting offsets, read the comment above each struct first.

Skills

  • extract-dwmcore-offsets: Extract all dwmcore.dll offsets from an IDA Pro instance. 7-phase audit.
  • extract-udwm-offsets: Extract all uDWM.dll offsets from an IDA Pro instance. 7-phase audit.

IDA Pro

Multiple dwmcore.dll and uDWM.dll instances (1809 through 25H2) available via ida-pro-mcp. Use list_instances to see active instances and select_instance to switch.

Codebase stability

Offsets only change at recompile boundaries, not every Windows update.

DLL codebase Windows releases
17763 Windows 10 1809 (minimum supported)
18362 Windows 10 1903, 1909
19041 Windows 10 2004, 20H2, 21H1, 21H2, 22H2
20348 Windows Server 2022
22000 Windows 11 21H2 RTM (Build 22000)
22621 Windows 11 22H2, 23H2
26100 Windows 11 24H2, 25H2
28100 Windows 11 26H1+ (NOT supported; MIL infrastructure removed)