Skip to content

Releases: CXWorld/CapFrameX

CapFrameX v1.8.4

19 Feb 16:08

Choose a tag to compare

Release Notes

Enhancements & New Features

  • Ryzen SMU support Zen 5
  • Overlay profile compatibility mode
  • New internal management stable sensor IDs
  • Drag&Drop folders on Comparison and Report tab
  • Auto enable PMD measurement
  • Detailed process info Capture tab
  • RAM Game Used sensor
  • Minor UI improvements

Bugfixes

  • Capture files cannot be saved to network drives
  • Invalid aggregation sensor data
  • Invalid D3D sensors
  • Sensor profiles not saved correctly
  • PresentMon opens in window mode

Platform & Infrastructure

  • Fixed device path for latest PawnIO driver 2.1.0

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX PMC Reader Plugin

The PMC Reader Plugin extends CapFrameX with low-level CPU performance monitoring counters (PMC) by reading Model Specific Registers (MSRs) directly. It exposes CPU cache and memory metrics β€” such as L3 cache hit rates, DRAM bandwidth, and DRAM latency β€” that are not accessible through standard OS APIs.

Supported CPUs

Vendor Architecture
AMD Zen 4, Zen 5
Intel Alder Lake, Raptor Lake (Refresh), Arrow Lake

Sensors

Base Sensors (all supported CPUs)

Sensor Unit Description
CPU L3 Hit Rate % Overall L3 cache hit rate
CPU DRAM Bandwidth GiB/s Total DRAM read + write bandwidth
CPU DRAM Latency ns DRAM access latency

Per-CCX Sensors (AMD multi-CCX CPUs)

Sensor Unit Description
CPU L3 Hit Rate CCX {i} % L3 cache hit rate per CCX
CPU DRAM Latency CCX {i} ns DRAM access latency per CCX

Gaming Sensors β€” P-Cores (Intel hybrid CPUs)

Sensor Unit Description
CPU P-Core IPC ratio Instructions per clock
CPU P-Core L3 Hitrate % L3 cache hit rate
CPU P-Core L3 Bound % Cycles stalled on L3
CPU P-Core Mem Bound % Cycles stalled on memory
CPU P-Core L3 Miss BW GiB/s L3 miss bandwidth

Gaming Sensors β€” E-Cores (Intel hybrid CPUs)

Sensor Unit Description
CPU E-Core IPC ratio Instructions per clock
CPU E-Core L3 Hitrate % L3 cache hit rate
CPU E-Core L3 Bound % Cycles stalled on L3
CPU E-Core Mem Bound % Cycles stalled on memory
CPU E-Core L3 Miss BW GiB/s L3 miss bandwidth

Installation

  1. Download CapFrameX.PmcReader.Plugin.dll from the release assets
  2. Copy the DLL into your CapFrameX installation folder
    Default path: C:\Program Files (x86)\CapFrameX
  3. Restart CapFrameX β€” the plugin sensors will appear automatically

⚠️ Important

This plugin uses the WinRing0 kernel driver to access CPU MSRs. WinRing0 is blacklisted by Microsoft Windows Defender and may be flagged or blocked.

In the worst case, you may need to disable Windows Defender real-time protection for the kernel driver to work properly.

Use this plugin at your own risk.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.8.4 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.8.4 release.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

CapFrameX v1.8.4 beta

25 Jan 10:04

Choose a tag to compare

CapFrameX v1.8.4 beta Pre-release
Pre-release

Release Notes

Bugfixes

  • Capture files cannot be saved to network drives.

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.8.3 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.8.3 release.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

CapFrameX v1.8.3

24 Jan 11:50

Choose a tag to compare

Release Notes

Enhancements & New Features

  • Increased buffer capacity for extremely high fps scenarios

Bugfixes

  • Fixed driver version overlay info for AMD GPUs

Platform & Infrastructure

  • Readded signed PawnIO.sys driver to address Windows SmartScreen issues

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.8.3 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.8.3 release.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

CapFrameX v1.8.2

23 Jan 17:22

Choose a tag to compare

Release Notes

Enhancements & New Features

  • Effective clock support for Intel CPUs
  • ADLX support AMD GPUs
  • AMD NPU telemetry
  • Improved overlay management
  • Improved overlay templates
  • Improved display detection for MRR metric
  • Disk space validation when saving capture files

Bugfixes

  • Fixed order Report tab table
  • Fixed Revert button overlay template
  • All sensors initially selected

Platform & Infrastructure

  • New plugin interface

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.8.2 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.8.2 release.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

CapFrameX v1.8.1

16 Jan 18:50

Choose a tag to compare

Release Notes

Enhancements & New Features

  • Auto generate overlay profiles
  • vkcube overlay preview window
  • PresentMon 2.4.1 with many fixes and updates
  • Overlay list search and filter
  • Check for FrameViewService ETW session

Bugfixes

  • Option menu combo boxes
  • PMD data capture interval length

Platform & Infrastructure

  • Smarter PawnIO driver management
  • App-level BENCHLAB service management (no need to install the service separately)
  • Smarter check for .NET 9 (SDK, Desktop Runtime, Standard Runtime)

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.8.1 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.8.1 release.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

CapFrameX v1.8.0 beta

12 Jan 19:02

Choose a tag to compare

CapFrameX v1.8.0 beta Pre-release
Pre-release

Release Notes

Enhancements & New Features

  • Support Intel Panther Lake voltage sensors
  • Added model IDs for Intel Arrow Lake-S Refresh (reserved)
  • Added model IDs for Intel Core Ultra 300 Series (reserved)
  • Full working portable mode
  • Check for .NET 9 and Visual C++ Redistributables on app start

Bugfixes

  • Overlay group control

Platform & Infrastructure

  • Updated several Nuget packages

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

CapFrameX Portable Mode

CapFrameX now supports a portable mode that allows the application to run entirely from a single folder without writing to system directories. This is useful for running from USB drives, network shares, or keeping multiple isolated installations.

How It Works

Portable mode is activated by placing a portable.json file in the same directory as the CapFrameX executable. When the application starts, it checks for this file and redirects all data storage to paths relative to the application directory.

Key Features

  • Self-contained: All configuration, captures, screenshots, and logs are stored relative to the application folder
  • No registry modifications: The application doesn't write to the Windows registry in portable mode
  • No system folder usage: Bypasses %AppData% and Documents folders entirely
  • Configurable paths: All storage paths can be customized via portable.json

portable.json Configuration

Create a portable.json file in the CapFrameX application directory with the following structure:

{
  "portable": true,
  "paths": {
    "config": "./Portable/Config",
    "captures": "./Portable/Captures",
    "screenshots": "./Portable/Screenshots",
    "logs": "./Portable/Logs",
    "cloud": "./Portable/Captures/Cloud"
  }
}

Configuration Options

Property Description Default
portable Enables portable mode when true true
paths.config Configuration files (AppSettings.json, overlay configs, sensor config, UI state) ./Portable/Config
paths.captures Capture recordings ./Portable/Captures
paths.screenshots Screenshot storage ./Portable/Screenshots
paths.logs Log files ./Portable/Logs
paths.cloud Cloud download directory ./Portable/Captures/Cloud

All paths are relative to the application directory. You can use ./ or .\ prefix, or just the folder name.

Requirements

When running in portable mode, the following dependencies must be installed on the system:

  • .NET 9.0 Desktop Runtime (x64) - Download
  • Visual C++ 2015-2022 Redistributable (x64) - Download

The application will check for these dependencies on startup and display a message if any are missing.

Creating a Portable Distribution

  1. Copy the CapFrameX application files to a folder
  2. Create a portable.json file with the configuration above
  3. (Optional) Pre-create the Portable subdirectory with: Config, Captures, Screenshots, Logs
  4. The application is now portable and can be moved to any location

Behavior Differences

Feature Installed Mode Portable Mode
Config storage %AppData%\CapFrameX\Configuration ./Portable/Config
Captures storage Documents\CapFrameX\Captures ./Portable/Captures
Screenshots Documents\CapFrameX\Screenshots ./Portable/Screenshots
Logs %AppData%\CapFrameX\Logs ./Portable/Logs
UI state (window size, column widths) %LocalAppData%\Jot ./Portable/Config
Window title "CapFrameX" "CapFrameX Portable"
Config migration Migrates old settings Skipped
Start with Windows Available Disabled

Notes

  • Settings configured in portable mode are stored in the portable config folder and won't affect or be affected by an installed version
  • The portable.json file must be valid JSON; if parsing fails, the application falls back to installed mode
  • Directories are automatically created if they don't exist

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.7.9 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.7.9 release or v1.8.0 beta.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

BENCHLAB Service

When using BENCHLAB service, unzip the folder in a suitable installation folder like C:\Benchlab Service or D:\Tools, then run the .bat script as admin. Don't install the service from the Download folder. Install latest .NET 9 runtime. Download here.

CapFrameX v1.7.9

09 Jan 20:28

Choose a tag to compare

Release Notes

Enhancements & New Features

  • Animation Error smoothness metric. More info here.

Bugfixes

  • AMD Ryzen 9000 clock speed calculation when bus speed is not 100MHz

Platform & Infrastructure

  • Reworked Microsoft Visual C++ Redistributable installer detection

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.7.9 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.7.9.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.

Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

BENCHLAB Service

When using BENCHLAB service, unzip the folder in a suitable installation folder like C:\Benchlab Service or D:\Tools, then run the .bat script as admin. Don't install the service from the Download folder. Install latest .NET 9 runtime. Download here.

CapFrameX v1.7.8

02 Jan 19:34

Choose a tag to compare

Release Notes

Overview

CapFrameX v1.7.8 continues the development trajectory of the 1.7.x beta cycle, consolidating stability improvements, expanded hardware support, refined metrics, and usability enhancements introduced in versions 1.7.5 through 1.7.7.
This release focuses on fixing WinRing0 security issues, improving capture fidelity, monitoring reliability, and compatibility with modern CPU and GPU platforms.


Enhancements & New Features

Unified Metric Improvements

  • Extended MsBetweenDisplayChange and MsBetweenPresents metrics across Analysis, Comparison, and Report views.
  • Improved visualization of frame pacing through refined frame time and distribution charts.
  • Added additional filtering capabilities to isolate swapchain and present events for deeper analysis.

Overlay & UI Improvements

  • Enhanced overlay entry handling with improved default ordering and persistent sorting.
  • Added Sort Overlay Entries button for easier overlay configuration.
  • Introduced a Debug Monitor view to provide real-time diagnostic insights into capture, sensors, and statistics providers.

Hardware Support

Graphics & Sensor Enhancements

  • Support Intel Panther Lake + Xe3 Graphics
  • Expanded GPU and sensor support for modern architectures:
    • AMD Strix Point
    • NVIDIA RTX 50 series
  • Improved accuracy and stability of PC Latency metrics on NVIDIA GPUs (beta).
  • Added GPU voltage monitoring and automatic monitor refresh rate detection.
  • Introduced D3D dedicated GPU memory performance counters.

Adapter Management

  • Added the ability to explicitly select the Primary Graphics Adapter.
  • Automatic filtering of integrated GPUs when a discrete GPU is available.

Power Measurement Support

BENCHLAB Support

  • Continued integration of BENCHLAB using a dedicated Windows service and client architecture.
  • Improved communication reliability between CapFrameX and BENCHLAB services.
  • Enables more robust automated benchmarking workflows, including synchronized capture start/stop and metadata handling.

Powenetics v2 PMD Support

  • Added and refined support for Powenetics v2 Power Measurement Device.
  • Improved power data acquisition stability and synchronization with frame time captures.
  • Support for custom device naming and clearer data presentation within the PMD tab.
  • Enables accurate correlation of performance, power consumption, and efficiency metrics during benchmarks.

Stability, Accuracy & Performance

Core Fixes

  • Fixed PresentMon ETW memory leak that could cause loss of capture events during long sessions.
  • Improved exception handling in the statistics provider to prevent analysis crashes.
  • General performance optimizations across capture, analysis, and overlay pipelines.

Capture & Analysis Fixes

  • Fixed DIMM temperature sensor readings.
  • Resolved drag-and-drop issues when importing capture files.
  • Corrected handling of MsBetweenPresents data in the Comparison tab.
  • Improved reliability of long-running captures under high ETW load.

Platform & Infrastructure

Runtime Requirements

  • .NET 9 is now required for full feature support and optimal stability. Download here.

Driver & OS Interaction

  • Internal PawnIO.sys management to reduce third-party driver conflicts.
  • Improved CPU thread management for hybrid and high-core-count processors.
  • Reworked IGCL support for Intel GPUs, including multi-adapter handling.

Troubleshooting & Known Issues

The following tips address the most common issues reported by users and can help resolve stability, overlay, and capture-related problems efficiently. We recommend working through them in order if you encounter unexpected behavior.

  1. Ensure you are running the latest version
    If you experience application crashes or unstable behavior, verify that you have installed CapFrameX v1.7.8 Patch 1 or newer. Many known issues have been resolved in this patch. If you were previously using version 1.7.7, we recommend uninstalling CapFrameX before installing the new version.

  2. Reset application settings
    In some cases, corrupted or outdated configuration files may cause problems. Deleting
    %appdata%/CapFrameX/Configuration/AppSettings.json
    will reset CapFrameX to its default settings and often resolves startup or UI-related issues.

  3. Reset overlay configuration files
    If overlay-related problems persist, try deleting the overlay configuration files located at
    %appdata%/CapFrameX/Configuration/OverlayEntryConfiguration_(0/1/2).json.
    These files will be recreated automatically on the next application start.

  4. Restore missing or zero-value overlay entries
    When overlay entries are missing or display constant zero values, open the Overlay tab and use the Reset button to restore all overlay entries to a valid default state.

  5. Fix incorrect overlay entry order
    If the order of overlay entries appears inconsistent or unintentionally rearranged, use the Sort button in the Overlay tab to restore a clean and logical ordering.

  6. Resolve frametime anomalies after updates
    In rare cases, existing background capture processes can interfere with CapFrameX after an update. If you encounter frametime issues, close all running PresentMon processes before installing or launching CapFrameX v1.7.8.

  7. Avoid conflicts with other monitoring tools
    Applications such as HWiNFO or AIDA64 that implement their own FPS or frametime metrics may conflict with CapFrameX’s capture service, as they also rely on PresentMon-based mechanisms. Disabling overlapping FPS or frametime monitoring features in those tools is strongly recommended when using CapFrameX.


Known Limitations

  • PC latency metric may return invalid values (NaN) under specific conditions.

BENCHLAB Service

When using BENCHLAB service, unzip the folder in a suitable installation folder like C:\Benchlab Service or D:\Tools, then run the .bat script as admin. Don't install the service from the Download folder. Install latest .NET 9 runtime. Download here.

CapFrameX v1.7.7 beta

16 Oct 17:58

Choose a tag to compare

CapFrameX v1.7.7 beta Pre-release
Pre-release

Update 2026/01/01

  • Bugfix PresentMon memory leak causing ETW events getting lost
  • Bugfix order Nvidia GPUs overlay entries
  • Performance optimizations
  • Statistic provider exceptions handling
  • Added swapchain filter
  • Added Debug Monitor

Update 2025/12/22

  • The PawnIO.sys driver conflict with third-party tools has been resolved. If you require a PawnIO installation for other applications, you may now install it. CapFrameX manages this component independently. Install latest .NET 9 runtime. Download here.
  • Reworked CPU thread management
  • Performance optimizations
  • Reworked IGCL support (Intel GPUs and iGPUs) with multi adapter handling
  • Fixed DIMM temperature sensors
  • Fixed bug on Comparison tab when using standard MsBetweenPresents metrics
  • Fixed bug when Drag&Drop captures in folder list
  • Added PC Latency for Nvidia graphics cards. Feature is still beta state, reports NaN in some cases.
  • Added voltage sensor for Nvidia GPUs
  • Added monitor refresh rate for Nvidia GPUs
  • Added D3D Dedicated GPU memory performance counter
  • Reworked overlay entry defaults
  • Added sorting overlay entries button
  • Reworked sensor sorting
  • Added selecting primary graphics adapter. Auto (default) filter removes iGPUs when at least one dGPU is detected. Restart CapFrameX after changing the primary adapter!
image

BENCHLAB Service

When using BENCHLAB service, unzip the folder in a suitable installation folder like C:\Benchlab Service or D:\Tools, then run the .bat script as admin. Don't install the service from the Download folder. Install latest .NET 9 runtime. Download here.

Update 2025/12/09

  • Bugfix CPU loads (showing only 0 and 6 mostly)
  • PawnIO.sys driver management via SCM (it's recommended to uninstall PawnIO)
  • "Minimize to tray" option in settings menu
  • Report GPU driver version AMD, Nvidia, and Intel
image

Enhancements

  • LibreHardwareMonitorLib support
    This beta adds support for LibreHardwareMonitorLib, which we customized to our needs.

Install .NET 9 for full library support: https://dotnet.microsoft.com/en-us/download/dotnet/9.0

  • Integrated PawnIO installer
    The PawnIO installer is now built directly into the CapFrameX installer. No separate installation step is needed anymore.

  • WinRing0.sys security issue resolved
    We have removed the dependency on WinRing0.sys, closing the related security risk.

  • PresentMon updated to version 2.4
    The new PresentMon version adds support for Nvidia Multi Frame Generation (x2, x3, x4) when using the MsBetweenDisplayChange option in the settings menu.

What is the difference between MsBetweenDisplayChange and MsBetweenPresents?

  • MsBetweenPresents measures the time between present calls from the application. This reflects how often the game submits frames.

  • MsBetweenDisplayChange measures the time between actual displayed frames. This includes any generated frames (e.g., from Frame Generation). Because Multi Frame Generation produces additional frames that are not directly presented by the game, only MsBetweenDisplayChange can show the effective frame rate with FG x2, x3, or x4 enabled.

image

CapFrameX v1.7.6 beta

26 Jul 19:32

Choose a tag to compare

CapFrameX v1.7.6 beta Pre-release
Pre-release

Update 2025/08/07

  • New PresentMon version with ETW buffer overflow fix

Update 2025/08/04

New features

  • Universal hybrid core detection for AMD (Performance + Dense cores) and Intel (Performance + Efficiency cores)
  • Thread Affinity Controller working with AMD dense cores
  • Support AMD Strix Point
  • Experimental support Intel Nova Lake
image

Enhancements

  • Eliminated lazy loading for capture files to resolve user-reported issues
  • Performance optimization capture files management
  • Performance optimization slider handling on Analysis tab (Real time update option)
image

Bugfixes

  • Thread Affinity Controller fixed for Zen 5

New features

  • Support Nvidia Blackwell
  • Support AMD Strix Point
  • Support PresentMon v2.3.1
  • Frame time distribution chart

Important: This version is not compatible with Nvidia's Multi Frame Generation! We are working on a solution with Nvidia.

Blackwell support
image

Frame time distribution chart
image

Enhancements

  • Lazy load capture files (aggregated file size > 512MB)
  • Removed Windows Media Player dependency (NAudio library)

Bugfixes

  • Fixed Zen 5 VID sensor readings
  • Fixed frame time issues caused by ETW buffer overflow

When using BENCHLAB service, unzip the folder in a suitable installation folder like C:\Benchlab Service or D:\Tools, then run the .bat script as admin. Don't install the service from the Download folder. Install latest .NET 8 runtime. Download here.