Process Rules - LordBlacksun/x3d-ccd-optimizer GitHub Wiki

Process Rules

The Process Rules tab is where you configure which processes go where. It has two columns representing your two CCDs.

Layout

Left Column: V-Cache CCD (Games)

This is your game list. Processes listed here will be pinned to CCD0 (the V-Cache CCD) when in Optimize mode. Games benefit most from V-Cache because of their large working sets and cache-sensitive rendering loops.

The app automatically scans your installed Steam, Epic Games, and GOG Galaxy libraries -- on a typical gaming PC, this covers hundreds of titles. You can add games from the scanned library using the search/autocomplete field, or manually type in any exe name.

Right Column: Frequency CCD (Background)

This is your background app list. Processes listed here will be explicitly pinned to CCD1 (the Frequency CCD) when in Optimize mode. This keeps them off the V-Cache CCD so your game doesn't compete for cache resources.

Common picks: Discord, Chrome, Spotify, Steam, OBS, Wallpaper Engine.

Adding Games (Left Column)

From the database: Type in the text field below the game list. After 2 characters, autocomplete suggestions appear from the known game database and scanned library results. It matches against both display names and exe names. Click a suggestion to add it.

Manual entry: Type the exact exe name (e.g. mygame.exe) and click "Add." Games added manually show a [manual] tag.

Adding Background Apps (Right Column)

Live Process Picker (recommended): Click the "Pick Running Processes..." button. A window appears showing all user applications currently running on your system.

The picker:

  • Shows friendly app names (e.g. "Logitech G Hub" not "lghub.exe")
  • Filters out Windows system processes automatically
  • Filters out anything already assigned to either column
  • Sorts by CPU usage so the busiest apps appear first
  • Lets you tick multiple apps and add them all at once

This is the easiest way to build your background rules -- just launch all the apps you normally run alongside games, open the picker, tick them, done.

Autocomplete fallback: For apps not currently running, type in the text field. Autocomplete suggests common apps (browsers, Discord, Steam, OBS, etc.).

Manual entry: Type the exact exe name and click "Add."

How Rules Work in Optimize Mode

When you toggle to Optimize and a game is detected:

Process What happens Activity log shows
Matches game list Pinned to CCD0 (V-Cache) -> V-Cache CCD
Matches background list Pinned to CCD1 (Frequency) -> Frequency CCD (rule)
Unknown process Migrated to CCD1 automatically -> Frequency CCD (auto)
System process Skipped entirely Not logged

The distinction between (rule) and (auto) in the log helps you see which migrations happened because of your explicit choices vs. the app's automatic cleanup.

Continuous Scanning

Rules aren't just applied once. The app uses adaptive polling -- 4 seconds when idle, switching to 2 seconds when a game is detected:

  • Just opened Discord? Caught and pinned to CCD1 within seconds.
  • Launched a second game? Detected and pinned to CCD0.
  • A background app exited? Removed from tracking.
  • Re-migration of newly launched processes occurs within 5 seconds.

The activity log shows every catch in real time with timestamps.

Game Detection Sources

The app uses a three-tier detection pipeline, evaluated in priority order:

  1. Manual rules (this tab) -- highest priority
  2. Library scan -- Steam (ACF manifests), Epic Games Store (JSON manifests), GOG Galaxy (SQLite + registry). Results stored in LiteDB (user_games.db).
  3. GPU heuristic -- auto-detects unknown games by monitoring GPU 3D engine usage

Detection source is shown in the activity log: [manual], [library], [auto-detected, GPU: XX%].

Tips

  • You don't need to add every background app manually. Optimize mode automatically migrates unmatched processes to CCD1 anyway. Explicit rules just give you visibility and ensure specific apps are always handled.
  • Game launchers (Steam, Epic, GOG Galaxy) are good candidates for the background column -- you don't want Steam's web browser competing with your game for V-Cache.
  • If an app appears in the wrong column, select it and click "Remove," then add it to the correct side.
  • Use the Game Library tab (third tab in the dashboard) to browse all games detected from your installed libraries.