CyInsights 0.2.2 Alpha 2

CyInsights 0.2.2 Alpha 2

This is an alpha prerelease for development and testing.

GitHub updates

The Windows application and CyInsightOVR now include a native update panel:
Help > Updates on Windows and Updates on Quest. Optional background checks
run at most once a day. Downloading and installing remain explicit actions.

Only newer stable releases are offered. Alpha, beta, release candidates and other
prereleases are ignored, including tags marked incorrectly as stable. Older
versions are never offered. This alpha must be downloaded manually; it is not
offered by the new updater.

Windows verifies the downloaded ZIP and its file manifest, prepares it in the
background, then uses the bundled native updater to back up replaced files and
restart the application with its open capture paths. Failed file replacements
roll back. Keep all files from the Windows archive together.

Quest keeps the installed standard/Vulkan variant and verifies the APK's size,
SHA-256, package, version code and signing certificate before opening Android's
installer. Android requires confirmation and may first ask permission to install
updates. Settings and captures are preserved. Updating does not restart a game.
The collector still needs authorized ADB bootstrapping after a headset reboot.

See update behavior and publishing requirements.

Downloads

• Windows-x64.zip: native desktop application, capture CLI, updater, MCP/SDK
  companion, offline Python dependencies and documentation.
• Quest-Standard-arm64.apk: standalone Quest metrics and configuration panel.
• Quest-Vulkan-arm64.apk: the panel with the experimental Vulkan layer for
  tile heatmaps and submitted draw/input geometry counters. Install one APK
  variant; both use the same Android package.
• Quest-arm64.zip: both APK variants, developer bridge, ADB bootstrap and guide.
  Run Start-CyInsightOVR.ps1 -Install -Launch for standard, or add
  -Variant vulkan for the experimental variant.
• Unreal-Plugins-Source.zip: integrated CyInsights Unreal plugin sources.
  Copy Plugins/CyInsights into your project's Plugins directory and build
  with your licensed engine. See Unreal compatibility.
• AI-SDK.zip: standalone MCP/SDK companion, analysis method, offline Python
  dependencies and documentation.
• SHA256SUMS.txt and release-manifest.json: package checksums and versions.

Validation and alpha limitations

The updater was tested with real GitHub metadata/downloads, an isolated Windows
replacement/restart with backup and settings preservation, and Android APK
validation on Quest 3. A future stable APK installation has not been tested
end to end because no compatible newer stable Quest package is published yet.

Existing Quest limitations remain: optional scene image recording can return
black images; tile alignment is approximate, with no exact mesh/eye attribution;
the experimental Vulkan heatmap needs a compatible development target. Draw
counters describe submitted work and known input triangles, not visible geometry
or completed GPU work. See the Quest guide and
validation record.

Windows executables are unsigned. APKs use development signing and are
intentionally debuggable for the authorized ADB bridge. Native .utrace readers
are built locally from source using a licensed Unreal installation and C++ tools;
Unreal binaries are not included. See licensing notes.

CyInsights 0.2.2 Alpha 1

CyInsights 0.2.2 Alpha 1

This is an alpha prerelease for development and testing.

Downloads

• Windows-x64.zip: native desktop application, capture CLI, standalone MCP/SDK companion, offline Python dependencies, analysis methods and documentation.
• Unreal-Plugins-Source.zip: the single integrated CyInsights Unreal plugin. Copy Plugins/CyInsights into your project's Plugins directory and build with your licensed engine. Targets UE 4.27 through 5.8; see the compatibility matrix for tested versions and limitations.
• Quest-arm64.zip: both CyInsightOVR APK variants, the ADB bootstrap, developer bridge and documentation. Extract the whole bundle before installation.
• Quest-Standard-arm64.apk: system metrics and the Quest configuration/analysis panel, without the experimental Vulkan layer.
• Quest-Vulkan-arm64.apk: adds the optional development Vulkan layer for live tile heatmaps and draw counters. Both APKs use org.cyinsights.ovr; install one variant, not both.
• AI-SDK.zip: standalone MCP/SDK companion, analysis method, offline Python dependencies and documentation. Requires Python 3.11 x64; run AI/SetupRuntime.ps1 after extraction. It connects to the desktop application's explicitly enabled local bridge.
• SHA256SUMS.txt: checksums for all downloadable packages and APKs.

For the standard Quest installation, run Start-CyInsightOVR.ps1 -Install -Launch from the extracted Quest bundle with authorized Android platform-tools. To use the experimental variant, install CyInsightOVR-0.1.0-dev-vulkan-arm64.apk using adb install -r, then run Start-CyInsightOVR.ps1 -RestartBridge -Launch without -Install. The developer bridge must be bootstrapped again after a headset reboot. Neither workflow restarts your game automatically. See the Quest companion guide.

Quest companion, GPU tiles and draw counters

CyInsightOVR provides a native Quest panel, configurable metric curves and controls for the installed Meta statistics HUD. The experimental Vulkan variant adds a separate placeable tile HUD and an approximate fullscreen heatmap for compatible development targets.

CyInsights can record the companion's measured GPU tile snapshots alongside Unreal timing in a single .cycapture, replay the snapshots on the desktop timeline and inspect hot tiles. Optional image recording and association are included, with the image limitations below.

The Vulkan collector reports submitted draw calls and known input triangle counts, including instances, reused command buffers and secondary execution. Unknown indirect geometry remains explicitly incomplete. Curve sampling is selectable at 1, 5, 10 or 20 Hz, with 10 Hz as the default; firmware-provided Meta system counters retain their own update rate. These observations are not counts of visible triangles or completed GPU work.

Collector fixes improve reader shutdown, stale-source recovery and coexistence with Meta's Adreno profiling layer. Detailed profiling availability is checked before requesting the extra layer. Target restarts remain an explicit user action.

Desktop and integration

• Multiple open traces and detached native trace windows, with corrected graphics backend ownership during window lifecycle changes.
• Quest tile replay and analysis integrated with capture options, the native MCP bridge and the standalone SDK.
• More explicit capture status and errors, bounded background work and configurable metric sampling.

Alpha limitations

• Image recording can currently return black images on the tested Quest. A reliable game-scene image capture is not validated; do not rely on it for mesh identification.
• Tile alignment is observation-based and approximate. Exact eye, mesh and Unreal GPU-frame attribution is unavailable. The tested OpenXR path does not expose vkQueuePresentKHR frame boundaries, so per-frame draw counts remain unavailable rather than being inferred from submissions.
• The custom Vulkan heatmap requires a compatible debuggable or explicitly opted-in Vulkan target. It is not a universal overlay for every Quest game. Meta HUD rendering remains provided by Meta's installed service.
• A measured 20 Hz draw stream was verified on Quest 3. Continuous validation of all four sampling rates and a capture-overhead benchmark remain incomplete. Additional collection has a cost; enable only the data you need.
• Windows binaries are unsigned. Android APKs use development signing and remain intentionally debuggable for the authorized ADB bridge. They are alpha development builds, not production store packages.
• Fast native .utrace readers are prepared locally from source using your licensed Unreal installation and C++ tools. Epic-linked reader binaries and Unreal Engine binaries are not included.

See the Quest validation record and licensing notes for details.

CyInsights 0.2.1

Current alpha and Quest APK downloads: this page is the older 0.2.1 release. Get CyInsights 0.2.2 Alpha 2 for the latest alpha packages, including both standalone Quest APKs.
Quest Vulkan APK (experimental heatmap and draw counters) | Quest standard APK | Quest bundle and bootstrap guide

CyInsights 0.2.1

Integrated Quest GPU capture

CyInsights now collects detailed Meta hardware GPU stages alongside Unreal
traces and saves both in a single .cycapture archive. Completed captures open
automatically in the desktop app. The running game is preserved; restarting it
is an explicit option.

• Detailed GPU tracks: Binning, Render, LoadColor, LoadDepthStencil, StoreColor
  and StoreDepthStencil, when available on the device.
• CPU/GPU clock alignment using Perfetto clock snapshots and Unreal session
  synchronization anchors.
• Explicit reporting of measured detail, coarse events and unavailable data.
• Reboot detection prevents combining timestamps from different headset boots.

The complete capture and analysis workflow was validated on Quest 3. The final
five-second test capture contained 630,034 indexed events and 360 native frames.
See Quest GPU validation and limitations.

Application improvements

• Visible, cancellable waiting for the game's capture service during startup.
• Automatic opening of completed captures, with a manual-opening option.
• Diagnostics showing the GPU stage types actually received.
• Optional .pftrace import for GPU-only diagnostics, without invented CPU
  tracks or Unreal frame IDs.
• A separate Quest test project that can launch without controllers and avoids
  the persisted Vulkan cache loading that caused crashes on the tested driver.

Getting started

Extract the complete Windows ZIP and run CyInsightsApp.exe. To analyze Unreal
traces, register the root folder of your licensed Unreal installation in
Session. Native readers are prepared using your local C++/CMake tools; Unreal
itself is not rebuilt. Unreal plugin sources are available in the separate ZIP.

Detailed Meta GPU capture requires an authorized ADB connection and GPU
profiling enabled before the game starts. Start recording from CyInsights;
a separate recording in Meta Quest Developer Hub is not required. Texture and
buffer readbacks remain disabled by default.

Limitations

Hardware stages do not provide an exact mapping to Unreal passes, shaders,
objects or game frames. Unknown process identities and approximate correlations
remain explicitly labeled. Quest 3 validation does not cover every headset,
engine version or driver. See the Quest capture guide.

Windows binaries are not Authenticode-signed. Component licenses, native reader
sources and SHA-256 checksums are included with the release.

CyInsights 0.2.0

CyInsights 0.2.0

Interface et analyse

• Intégration de CyUI : cinq thèmes, densités compacte et confortable,
  écran de capture adaptatif et réglages avancés repliables.
• Commandes d'analyse regroupées, recherche avec effacement, menu des panneaux
  et barre d'état rappelant les interactions.
• Plusieurs captures indépendantes, avec onglets et fenêtres natives détachables.
• Déplacement continu pendant les chargements, frames synchronisées, hauteur
  des pistes adaptée au contenu visible, règle de mesure et sélection d'intervalle.
• Filtre exact au double clic et histogramme de fonction depuis le menu
  contextuel, limité à l'intervalle sélectionné.
• Réduction des commandes de rendu des labels de timeline ; préparation et
  requêtes bornées en arrière-plan pour les index natifs sur disque.
• Outils IA/MCP, SDK optionnel et méthode d'analyse disponibles depuis le produit
  autonome ; l'inspecteur natif fonctionne sans Python.

Capture et GPU

• Un seul plugin CyInsights avec modules Windows internes facultatifs,
  configurations de capture et commandes réseau. Les copies de textures/buffers
  restent désactivées par défaut.
• Sources natives réseau, fichiers, chargement et mémoire consultables avec la
  timeline ; leur disponibilité dépend des canaux et lecteurs installés.
• Import des stages matériels Meta sur des pistes GPU distinctes, en préservant
  les horloges, l'identité inconnue et les limites d'association aux groupes Unreal.
• Correction du script ADB de récupération et du contrôle des dispatchs Vulkan
  pour UE 5.5 standard, qui n'exporte pas EndRenderPass2 comme le fork Meta.
• Petit projet Quest reproductible et outils de diagnostic des groupes réellement
  enregistrés, sans modification du moteur.

Limites et installation

Cette version n'offre pas encore tous les fournisseurs
d'Unreal Insights. Sur le Quest testé, des événements Workload, Dispatch, Blit,
Preempt et surfaces ont été reçus ; Binning, Render et les chargements/écritures
séparés n'ont pas été obtenus. Des crashs dans la couche Meta/Adreno ont interrompu
les essais suivants. Le flux détaillé complet dans l'APK reste à valider.
Voir les résultats Quest.

Extraire l'archive Windows et lancer CyInsightsApp.exe. Enregistrer la racine
de son installation Unreal dans Session si nécessaire. Les lecteurs natifs sont
préparés automatiquement avec cette installation et les outils C++ requis ;
aucun script manuel ni rebuild du moteur n'est demandé. Ils sont distribués sous
forme de sources, sans bibliothèques Epic.

Les sources du plugin ciblent UE 4.27–5.8, avec des vérifications et limites
détaillées dans la matrice de compatibilité. Les modules
de capture restent réservés à Editor, Debug, DebugGame et Development ; Shipping,
Test et Server sont exclus. La matrice ne signifie pas que chaque combinaison
matérielle a été validée.

Les exécutables Windows ne disposent pas d'une signature Authenticode de confiance.
Les archives comportent leurs empreintes et l'état réel des signatures ; cela ne
constitue pas un verdict antivirus. Les licences des composants sont conservées.

CyInsights 0.2.0 preview — CyUI, multi-captures et outils IA

CyInsights 0.2.0 preview

Interface et analyse

• Intégration de CyUI : cinq thèmes, densités compacte et confortable,
  écran de capture adaptatif et réglages avancés repliables.
• Commandes d'analyse regroupées, recherche avec effacement, menu des panneaux
  et barre d'état rappelant les interactions.
• Plusieurs captures indépendantes, avec onglets et fenêtres natives détachables.
• Déplacement continu pendant les chargements, frames synchronisées, hauteur
  des pistes adaptée au contenu visible, règle de mesure et sélection d'intervalle.
• Filtre exact au double clic et histogramme de fonction depuis le menu
  contextuel, limité à l'intervalle sélectionné.
• Réduction des commandes de rendu des labels de timeline ; préparation et
  requêtes bornées en arrière-plan pour les index natifs sur disque.
• Outils IA/MCP, SDK optionnel et méthode d'analyse disponibles depuis le produit
  autonome ; l'inspecteur natif fonctionne sans Python.

Capture et GPU

• Un seul plugin CyInsights avec modules Windows internes facultatifs,
  configurations de capture et commandes réseau. Les copies de textures/buffers
  restent désactivées par défaut.
• Sources natives réseau, fichiers, chargement et mémoire consultables avec la
  timeline ; leur disponibilité dépend des canaux et lecteurs installés.
• Import des stages matériels Meta sur des pistes GPU distinctes, en préservant
  les horloges, l'identité inconnue et les limites d'association aux groupes Unreal.
• Correction du script ADB de récupération et du contrôle des dispatchs Vulkan
  pour UE 5.5 standard, qui n'exporte pas EndRenderPass2 comme le fork Meta.
• Petit projet Quest reproductible et outils de diagnostic des groupes réellement
  enregistrés, sans modification du moteur.

Limites et installation

Cette version reste une preview : elle n'offre pas encore tous les fournisseurs
d'Unreal Insights. Sur le Quest testé, des événements Workload, Dispatch, Blit,
Preempt et surfaces ont été reçus ; Binning, Render et les chargements/écritures
séparés n'ont pas été obtenus. Des crashs dans la couche Meta/Adreno ont interrompu
les essais suivants. Le flux détaillé complet dans l'APK reste à valider.
Voir les résultats Quest.

Extraire l'archive Windows et lancer CyInsightsApp.exe. Enregistrer la racine
de son installation Unreal dans Session si nécessaire. Les lecteurs natifs sont
préparés automatiquement avec cette installation et les outils C++ requis ;
aucun script manuel ni rebuild du moteur n'est demandé. Ils sont distribués sous
forme de sources, sans bibliothèques Epic.

Les sources du plugin ciblent UE 4.27–5.8, avec des vérifications et limites
détaillées dans la matrice de compatibilité. Les modules
de capture restent réservés à Editor, Debug, DebugGame et Development ; Shipping,
Test et Server sont exclus. La matrice ne signifie pas que chaque combinaison
matérielle a été validée.

Les exécutables Windows ne disposent pas d'une signature Authenticode de confiance.
Les archives comportent leurs empreintes et l'état réel des signatures ; cela ne
constitue pas un verdict antivirus. Les licences des composants sont conservées.

CyInsights v0.1.1-preview.20261011

CyInsights prépare maintenant ses lecteurs Unreal automatiquement au démarrage. Il n'est plus nécessaire de lancer InstallNativeReaders.ps1 à la main.

• Détection des installations Unreal via les inscriptions Epic et le Launcher, puis mémorisation de l'analyseur choisi. Une installation peut aussi être sélectionnée dans Session.
• Préparation des lecteurs de timings, tâches et activités en arrière-plan, avec progression, journal, annulation et relance depuis l'interface.
• Cache par installation du moteur, réutilisé aux lancements suivants. Une mise à jour du moteur ou des sources provoque une nouvelle préparation.
• Une capture ouverte pendant la préparation attend sa fin puis s'ouvre automatiquement. Le pont CSV reste disponible si la préparation est annulée ou ne peut pas aboutir.

Installation

Télécharger CyInsights-v0.1.1-preview.20261011-Windows-x64.zip, extraire tout le ZIP puis lancer CyInsightsApp.exe.

La lecture .utrace utilise toujours une installation Unreal Insights séparée. La préparation automatique des lecteurs exige une installation Unreal licenciée 5.5–5.8 et les outils C++/CMake Visual Studio ; UE 5.8 nécessite MSVC 14.44. Ces dépendances ne sont pas installées automatiquement. Nos adaptateurs sont compilés localement, sans modifier ni recompiler le moteur. Aucune DLL Epic ni adaptateur Unreal précompilé n'est distribué dans le paquet.

Le compagnon IA reste facultatif : Python 3.11 x64 puis powershell -File AI/SetupRuntime.ps1. Ses dépendances verrouillées sont fournies hors ligne.

Le ZIP Unreal-Plugins-Source contient les plugins en sources, ciblant UE 4.27–5.8 dans les configurations autorisées. Voir Docs/UnrealCompatibility.md pour la matrice de compilation et les limites de validation. SHA256SUMS.txt fournit les empreintes des deux archives ; les sources complètes sont disponibles avec le tag GitHub.

Validation et limites

Les 16 suites de composants passent, dont les contrôles du cache, de la sélection d'analyseur, des erreurs et de l'annulation du processus de préparation. Le premier lancement avec UE 5.8 a compilé les trois lecteurs puis ouvert une trace synthétique par le chemin direct. Une réouverture et un lancement depuis le ZIP extrait ont réutilisé le cache.

Cette preview reste non signée et en développement. La préparation automatique ne rend pas l'analyseur autonome vis-à-vis d'Unreal. La disponibilité des données dépend toujours des canaux enregistrés et de la plateforme ; la collecte Quest reste à valider sur casque et tous les modules Unreal Insights ne sont pas encore intégrés.

Application sous AGPL-3.0-or-later ; intégrations et dépendances selon les licences incluses. Voir Docs/Licensing.md et LICENCES/.

CyInsights v0.1.0-preview.20261010

Première preview Windows de CyInsights, application C++ indépendante avec interface Dear ImGui pour analyser les captures Unreal et les données GPU complémentaires.

• Timeline continue CPU/GPU, frames synchronisées, navigation et zoom, filtres par fonction, histogrammes et analyses sur une plage sélectionnée.
• Analyse des tâches, compteurs et activités réseau, stockage et mémoire selon les données présentes dans la trace.
• Lecture directe des timings .utrace via les providers Unreal installés, avec index paginé et préparation en arrière-plan. Sur une capture locale de 14,2 millions d'événements, l'ouverture est passée de 42,77 s à 4,05 s ; le résultat dépend de la trace et du matériel.
• Plugins Unreal en sources pour les captures locales ou à distance, et compagnon IA/SDK/MCP facultatif.

Téléchargements et installation

CyInsights-v0.1.0-preview.20261010-Windows-x64.zip : extraire tout le ZIP puis lancer CyInsightsApp.exe. Un Unreal Insights installé séparément est nécessaire pour lire un .utrace ; le sélectionner dans Session.

Les lecteurs Unreal natifs sont fournis en sources. Pour activer la lecture accélérée et les lecteurs de tâches/activités, installer les outils C++ Visual Studio puis lancer depuis le dossier extrait :

powershell -File Tools/InstallNativeReaders.ps1 -Engine "C:/Example/UE_5.8/Engine"

Le script utilise votre installation Unreal licenciée 5.5–5.8 et compile uniquement nos adaptateurs, sans recompiler le moteur. UE 5.8 nécessite MSVC 14.44. Le pont CSV reste utilisable sans les lecteurs compilés. Aucune DLL Epic n'est distribuée dans le ZIP.

Le compagnon IA est facultatif : avec Python 3.11 x64 installé, lancer powershell -File AI/SetupRuntime.ps1. Les dépendances verrouillées sont fournies pour une installation hors ligne.

CyInsights-v0.1.0-preview.20261010-Unreal-Plugins-Source.zip : sources des plugins, à compiler dans votre projet Unreal. Les plugins ciblent 4.27–5.8 en Editor, Debug, DebugGame et Development ; les configurations Shipping, Test et Server sont exclues. La matrice de compilation et les limites de validation figurent dans Docs/UnrealCompatibility.md.

SHA256SUMS.txt : empreintes des deux archives. Les sources complètes de cette version sont disponibles avec le tag et les archives GitHub.

État de cette preview

Les binaires ne sont pas signés. L'application et les plugins restent en développement ; la disponibilité des métriques dépend de la plateforme et des canaux capturés. La collecte Quest doit encore être validée sur casque. La parité complète avec tous les modules Unreal Insights n'est pas annoncée.

Application sous AGPL-3.0-or-later, composants d'intégration et dépendances selon leurs notices incluses. Voir Docs/Licensing.md et LICENCES/.