How sribalan98/ghostframe-win works
GhostFrame is a Windows screen-capture cloaker. In the primary workflow, a user manages visible application windows in the GUI; window discovery supplies window/process details, and affinity control applies or restores capture exclusion through a helper and injected payload. Focus Mode cloaks other eligible windows while leaving the selected process visible. Persistent auto-hide rules and a separate OBS dock are documented capabilities. Source excerpts establish the main GUI, discovery, affinity, and helper relationships; the README supplies the DWM behavior, while some unsampled implementation details are omitted.
Main entry points: gui-main.cpp Desktop GUI · affinity-controller.cpp Affinity controller · hider-dock.cpp Window hider dock · window-manager.cpp Window discovery
Components 12
User interfaces
- Desktop GUI
src/gui/gui-main.cpp - GUI theme
src/gui/gui-theme.hpp - OBS dock plugin
src/plugin-main.cpp - Window hider dock
src/ui/hider-dock.cpp
Window control
- Window discovery
src/core/window-manager.cpp - Window records
src/core/window-info.hpp - Affinity controller
src/core/affinity-controller.cpp - Auto-hide rules
src/core/config-manager.cpp
Affinity injection
- Process helper
src/helper/helper-main.cpp - Remote payload
src/helper/payload.cpp
Other components
- User
- Windows capture compositor
Connections 14
- User → Desktop GUI: manages windows
README.md - Desktop GUI → GUI theme: renders with
src/gui/gui-main.cpp - Desktop GUI → Window discovery: enumerates windows
src/gui/gui-main.cpp - Desktop GUI → Affinity controller: toggles exclusion
src/gui/gui-main.cpp - Desktop GUI → Auto-hide rules: edits rules
src/gui/gui-main.cpp - Window discovery → Window records: returns records
- Affinity controller → Window discovery: checks processes
src/core/affinity-controller.cpp - Affinity controller → Process helper: launches helper
src/core/affinity-controller.cpp - Process helper → Remote payload: loads payload
src/helper/helper-main.cpp - Affinity controller → Windows capture compositor: sets capture affinity
README.md - OBS dock plugin → Window hider dock: creates dock
src/plugin-main.cpp - Window hider dock → Window discovery: manages windows
- Window hider dock → Affinity controller: toggles exclusion
- Window hider dock → Auto-hide rules: edits rules