Skip to content

Releases: MrMybal/CyGPUInspector

CyGPUInspector 0.4.0

Choose a tag to compare

@MrMybal MrMybal released this 02 Nov 23:10

CyGPUInspector 0.4.0 migrates the standalone interface to CyUI 1.2.0's modular architecture.

  • Shared CodeEditor with HLSL syntax, compiler diagnostics, find/replace, wrapping and Undo/Redo; removes the separate editor copy.
  • Common timelines and plots for frame/pass/command inspection and continuous GPU history, retaining zoom, pan, selection and timing metadata.
  • Image views with fit, zoom and pan; filterable captured pipeline properties; searchable MCP activity and cached assistant transcripts.
  • Preserves application settings, layouts, keyboard shortcuts, French localization, five themes, density and DPI controls.
  • Builds only the required CyUI modules with one Dear ImGui instance. Fixes native header dependency tracking on localized Windows toolchains.
  • Includes complete CyUI and syntax-engine license notices, an upstream CyUI MIT license link in About, and updated integration documentation. CyUI's upstream repository is currently private; its full MIT license is included in the package.

The Windows x64 portable archive includes the standalone app, ReShade add-ons, MCP server, five native test suites, Microsoft DXC and rebuilt Unreal Engine 5.3 and 5.8 plugins, all product components versioned 0.4.0.

Validation: 4,611 native checks, 23 interface render cases across themes/densities/scales, MCP live demo session, archive and license checks. Unreal plugins compiled for Editor, Development and Shipping. No real-game runtime validation was performed.

Known limits: Markdown uses CyUI's native subset. Documents larger than 32 MiB remain editable with common lexical syntax preparation disabled.

Download CyGPUInspector-0.4.0-win64.zip; the adjacent .sha256 file contains its checksum. Extract to a new folder and follow START-HERE.txt or COMMENCER-ICI.txt.

CyGPUInspector 0.3.0

Choose a tag to compare

@MrMybal MrMybal released this 17 Oct 15:32

CyGPUInspector 0.3.0

The standalone interface now uses CyUI 1.0.0, with grouped navigation and capture actions, clearer session information, and more readable shader, resource and event panels.

  • Choose from five themes, compact or comfortable spacing, and adjustable interface size in View > Appearance.
  • Keep the active session, tracking state and GPU timing visible in a persistent status bar.
  • Use contextual empty states, wider search fields and organized settings for captures, previews and the AI assistant.
  • Improve contrast in timelines, frame graphs, disassembly and the HLSL editor, including light themes.
  • Preserve existing dock layouts, captures, game profiles and provider settings. Appearance preferences are saved alongside the existing settings.
  • Include complete component notices with the standalone and each separately copyable Unreal plugin. CyGPUInspector remains licensed under GNU AGPL v3 or later.

The Windows x64 archive includes the standalone, MCP server, ReShade add-ons, Unreal Engine 5.3 and 5.8 plugin builds, the official DXC runtime, documentation, and the no-game demo/test tools.

Extract into a new folder and retain your existing settings, profiles, databases and captures. See START-HERE.txt or COMMENCER-ICI.txt for setup. The .sha256 file accompanies the archive.

CyGPUInspector 0.2.0

CyGPUInspector 0.2.0 Pre-release
Pre-release

Choose a tag to compare

@MrMybal MrMybal released this 27 Sep 14:20

CyGPUInspector 0.2.0 adds an AI assistant that works on the frame with the inspector's own tools, a full HLSL editor, per-game profiles that remember your changes, shader search, frame comparison and GPU timing of a single shader, draw or resource.

Résumé en français plus bas.

Download

CyGPUInspector-0.2.0-win64.zip: portable, nothing to install, nothing in the registry. Start with START-HERE.txt (French: COMMENCER-ICI.txt).

SHA-256: 79e045967af8191976faf1425683b9c8f4071a75fc87ae652d632ce7d547c395 (also in the attached .sha256 file).

Replace the add-on too: the 0.2.0 standalone connects to a 0.1.0 add-on, but the new timing focus needs the 0.2.0 CyGPUInspectorRS.addon64 (and the Unreal plugin of this zip, which carries it).

What is new

AI assistant (panel AI assistant, and the AI Analysis tab of a shader)

  • Providers: the Codex CLI or the Claude Code CLI with the login they already have, or an OpenAI-compatible API, local (Ollama, LM Studio…) or remote. No key is stored in the settings.
  • The assistant reads the frame, the shaders and the resources through the same tools as the MCP server. Three permission modes: automatic (at most one change per message), ask each time (every change, and every piece of shader code before it is sent to the provider), full access.
  • On a shader: clean-up of the reconstructed HLSL, classification, explanation. What comes back is a hypothesis, labelled as such, never the original source.

HLSL editor

  • The HLSL tab colours each decompiler's reconstruction as HLSL and lets you edit it.
  • Open in a window gives a full editor in its own window: find and replace, undo, line numbers, open and save .hlsl files, compilation for any profile (FXC for Shader Model 5, DXC for Shader Model 6) with the errors marked on their lines, and Compile & Inject into the running game.

Safer replacements

  • A replacement is checked against the original before it is sent: inputs, outputs, registers, stage and format. Differences the graphics API would reject are explained instead of ending in a refused pipeline; differences it tolerates are shown as warnings.

Game profiles (panel Game profile)

  • One profile per game, in JSON under Games/: sessions, every shader seen with whether it is new or already known, and the game's captures.
  • The shaders you disabled or replaced are saved and, if you choose, applied again when the game comes back, matched by their semantic hash.

Shader search

  • A query language in the Shaders panel: stage:ps writes:rgba16f ms>0.2, reads:depth, calls>1000, sm:6, tag:bloom, used, disabled, replaced, new…

Frame comparison

  • Two captures, in the Captures panel: the shaders that ran only in one of them or ran differently (calls, GPU time), and the resources present in only one. Through MCP and the assistant, a capture can also be compared with the live frame.

Frame graph

  • Passes are followed from one rebuild to the next: names stop flickering, a pass that keeps its name gains confidence, and a name you give follows the pass wherever it moves in the frame.

GPU timing of one shader, one draw or one resource

  • Time this shader precisely, Time this draw precisely and Time the draws into this resource in the Details panel: on top of Pass Timing, the add-on times only those commands, so they get a GPU time of their own without the cost of Full Draw Timing. The Shader tab shows calls, total, average and maximum.

MCP

  • New tools: find_shaders, get_game_profile, list_captures, compare_captures. replace_shader goes through the same check as the interface.

Requirements

  • Windows 10 or 11, 64-bit.
  • For a game: ReShade with full add-on support (reshade.me), D3D11 or D3D12. CyGPUInspector injects nothing itself: ReShade loads the add-on. A game that refuses ReShade is not supported, and nothing here tries to work around anti-cheat systems or protections.
  • For the AI assistant: one of the providers above, with your own account or server.

Known limitations

  • The frame is observed through ReShade's add-on API, not replayed.
  • Pass names are derived: no graphics API exposes an application's debug markers to a ReShade add-on.
  • The HLSL shown is a reconstruction, never the original source, and is labelled with the backend that produced it. The AI's results are hypotheses.

Details: Docs/Limitations.md.

Licences

CyGPUInspector is published under the GNU Affero General Public License v3 or later. Third-party components keep their own licences (see THIRD-PARTY.md and Licenses/): the 3Dmigoto decompiler (GPL-3.0, combined through section 13 of both licences), ReShade (BSD-3-Clause), Dear ImGui, ImGuiColorTextEdit, dxil-spirv, dxbc-spirv and SPIRV-Headers (MIT), SPIRV-Cross (Apache-2.0), dxcompiler.dll (NCSA and MIT). dxil.dll is under the Microsoft Software License Terms of the DirectX Shader Compiler and is not covered by the AGPL.


En français

CyGPUInspector 0.2.0 ajoute :

  • un assistant IA qui travaille sur la frame avec les outils de l'inspecteur : Codex CLI ou Claude Code CLI avec leur connexion existante, ou une API compatible OpenAI, locale ou distante. Trois modes de permission, et sur un shader : nettoyage du HLSL reconstruit, classification, explication. Ce qu'il rend est une hypothèse ;
  • un éditeur HLSL complet : coloration syntaxique, fenêtre séparée, recherche, fichiers .hlsl, compilation de test FXC ou DXC avec les erreurs sur leurs lignes, et Compile & Inject dans le jeu ;
  • une vérification des remplacements avant l'envoi : ce que l'API graphique refuserait est expliqué au lieu d'échouer ;
  • des profils de jeu en JSON : sessions, shaders nouveaux ou déjà connus, et les shaders désactivés ou remplacés, réappliqués au retour du jeu si vous le voulez ;
  • la recherche de shaders par ce qu'ils font (stage:ps writes:rgba16f ms>0.2…) ;
  • la comparaison de deux frames : shaders présents d'un seul côté ou exécutés différemment, ressources ;
  • des passes stables d'une reconstruction du frame graph à l'autre ;
  • la mesure GPU d'un shader, d'un draw ou d'une ressource seuls, sans le coût de Full Draw Timing.

Remplacez aussi l'add-on : la mesure ciblée demande le CyGPUInspectorRS.addon64 de la 0.2.0. Commencez par COMMENCER-ICI.txt. Licence : GNU AGPL v3 ou ultérieure ; les composants tiers gardent la leur (THIRD-PARTY.md, Licenses/).

CyGPUInspector 0.1.0

CyGPUInspector 0.1.0 Pre-release
Pre-release

Choose a tag to compare

@MrMybal MrMybal released this 21 Sep 23:38

First version of CyGPUInspector: a real-time and offline GPU inspector (frame debugger, shader and resource browser, profiler, decompiler, AI-assisted analysis) that uses ReShade's official add-on API as its capture agent inside the game process.

Résumé en français plus bas.

Download

CyGPUInspector-0.1.0-win64.zip: portable, nothing to install, nothing in the registry. Start with START-HERE.txt (French: COMMENCER-ICI.txt).

SHA-256: ed4d0e95d53b5829d106fa854208207b13253758e22931321a7f85ec6961bb42 (also in the attached .sha256 file).

What is inside

Folder Content
App/ CyGPUInspectorApp, the analysis application: frame timeline, frame graph, resources, shaders with multi-backend decompilation, deep capture that saves the final image and the frame's buffers (PNG and DDS), shader disabling and replacement, mod export. CyGPUInspectorMCP, a local MCP server, read only by default. Microsoft's DirectX Shader Compiler 1.9.2607, for Shader Model 6.
Addons/ CyGPUInspectorRS.addon64, the ReShade add-on that tracks and captures the frame. CyGPUInjector.addon64, which applies an exported mod without the rest of the tool.
Unreal/UE5.8/, Unreal/UE5.3/ The Unreal Engine plugin (UE5.8 build, and UE5.3 build for 5.3 to 5.7): captures the 3D render of the main viewport from the editor and from Development / DebugGame builds. ReShade 6.8.0 (full add-on build) is included in the plugin. Not loaded in Shipping builds.
TestWithoutAGame/ A fake session to try the application with no game at all (Demo.cmd), and the test suites.
Docs/ The documentation (French in Docs/fr/).
Licenses/ The licences of the third-party components shipped in the zip.

Requirements

  • Windows 10 or 11, 64-bit.
  • For a game: ReShade with full add-on support (reshade.me), D3D11 or D3D12. CyGPUInspector injects nothing itself: ReShade loads the add-on. A game that refuses ReShade is not supported, and nothing here tries to work around anti-cheat systems or protections.

Known limitations

  • The frame is observed through ReShade's add-on API, not replayed.
  • Pass names are derived: no graphics API exposes an application's debug markers to a ReShade add-on. Resource names are read when the application provides them (Unreal does, in the editor and in Development builds).
  • The HLSL shown is a reconstruction, never the original source, and is labelled with the backend that produced it.

Details: Docs/Limitations.md.

Licences

CyGPUInspector is published under the GNU Affero General Public License v3 or later. Third-party components keep their own licences (see THIRD-PARTY.md and Licenses/): the 3Dmigoto decompiler (GPL-3.0, combined through section 13 of both licences), ReShade (BSD-3-Clause), Dear ImGui, dxil-spirv, dxbc-spirv and SPIRV-Headers (MIT), SPIRV-Cross (Apache-2.0), dxcompiler.dll (NCSA and MIT). dxil.dll is under the Microsoft Software License Terms of the DirectX Shader Compiler and is not covered by the AGPL.


En français

Première version de CyGPUInspector, un inspecteur GPU temps réel et hors ligne qui s'appuie sur l'API officielle des add-ons ReShade.

  • CyGPUInspector-0.1.0-win64.zip : portable, rien à installer. Commencez par COMMENCER-ICI.txt.
  • Contenu : l'application d'analyse et le serveur MCP (App/), les add-ons ReShade (Addons/), le plugin Unreal Engine pour 5.3 à 5.8, ReShade inclus (Unreal/), une démo sans jeu (TestWithoutAGame/), et la documentation, en français dans Docs/fr/.
  • Pour un jeu : ReShade avec support complet des add-ons, en D3D11 ou D3D12. Un jeu qui refuse ReShade n'est pas supporté.
  • Licence : GNU AGPL v3 ou ultérieure. Les composants tiers gardent leur licence (THIRD-PARTY.md, Licenses/).