The Overlay - LordBlacksun/x3d-ccd-optimizer GitHub Wiki
The Overlay
The overlay is a small, always-on-top display that shows what the app is doing without switching away from your game.
Enabling the Overlay
Press Ctrl+Shift+O to toggle the overlay on/off, or enable it in Settings --> Overlay --> Enable overlay.
What It Shows
The overlay appears as a compact pill in the corner of your screen showing the current status:
- Game detected and which CCD it's pinned to
- Mode (Monitor or Optimize)
- Recent actions (game engaged, processes migrated, etc.)
CCD Load Bars (Optional)
In Settings --> Overlay, you can enable "Show CCD load bars." When enabled, the overlay expands to show two small horizontal bars below the status text:
- Green bar (CCD0): V-Cache CCD average load
- Blue bar (CCD1): Frequency CCD average load
This gives you an at-a-glance view of whether your game is properly isolated on the V-Cache CCD. If you see both bars active, background processes may be spilling onto CCD0.
OLED Safety Features
The overlay includes features to protect OLED displays:
- Auto-hide: The overlay fades out after a configurable period of inactivity (default: 10 seconds) and reappears when a new event occurs
- Pixel shift: The overlay shifts position by a few pixels at a configurable interval (default: every 3 minutes) to prevent burn-in
- Low opacity: Default 80% transparency reduces the brightness of static elements
Configure these individually in Settings --> Overlay.
Overlay Settings
| Setting | Default | What it does |
|---|---|---|
| Enable overlay | Off | Show the overlay window. Can also be toggled with Ctrl+Shift+O. |
| Show CCD load bars | On | Adds CCD usage bars below the status text. |
| Opacity | 80% | Transparency level. Lower values make it more see-through. Range: 30%-100%. |
| Auto-hide after | 10s | Seconds of inactivity before the overlay fades out. Range: 5s-30s. |
| Pixel shift every | 3 min | Interval for OLED burn-in protection position shifts. Range: 1-10 minutes. |
| Default position | Top Right | Which corner of the screen the overlay appears in. |
Hotkey
Ctrl+Shift+O -- Toggle overlay visibility from anywhere, including while in-game.
Important: Fullscreen Compatibility
The overlay requires your game to run in borderless windowed or windowed mode. Exclusive fullscreen takes over the display adapter, and no standard Windows overlay can render on top. This is a Windows limitation, not a bug. If you don't see the overlay during gameplay, check your game's display settings.