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.