Omniverse Realtime Viewer

NVIDIAOfficialCreated by NVIDIA Omniverse

Skill
Tool integration
Software development
Apache-2.0
Medium risk

From the author

Use as the top-level router for Omniverse Realtime Viewer USD apps, XR delivery, SPG GPU processing, stylized rendering, and focused viewer reference documents.

— the description by NVIDIA Omniverse

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The Omniverse Realtime Viewer skill acts as a central routing and architectural framework for developing USD-based 3D viewer applications. It provides a structured approach to composing rendering, scene state, and delivery mechanisms, ensuring that developers can integrate OVRTX rendering, OVStage scene management, and various UI or streaming adapters effectively. The skill emphasizes a modular architecture where the viewer runtime, UI/input adapters, and delivery systems are decoupled, allowing for consistent behavior across local and streamed environments.

What it does

Provides a routing architecture for USD viewer apps, XR delivery, and GPU-accelerated rendering.
Defines the separation of concerns between viewer runtime, UI adapters, and delivery systems.
Offers guidance on integrating OVRTX for high-fidelity 3D rendering.
Establishes conventions for camera interaction, scene state management, and input handling.
Supports the implementation of specialized features like stylized rendering and CAE/CFD visualization.
Provides protocols for agent-to-UI communication and scene control.

When to use it

When starting the development of a new USD-based realtime viewer application.
When integrating advanced rendering features like stylized visualization or AOV switching.
When building XR or spatial editing capabilities into an existing Omniverse application.
When you need to standardize the architecture for local and streamed viewer deployments.
When implementing chat-driven scene control or agent-based inspection of a 3D scene.

Advantages

Promotes a clean, modular architecture that separates rendering logic from UI and transport.
Ensures consistent behavior across different delivery methods, such as local windows or WebRTC streaming.
Provides clear paths for extending functionality without disrupting the core viewer runtime.
Facilitates the integration of complex simulation and visualization data into the viewer.
Standardizes conventions for scene state, selection, and camera control.

Usage examples

“How do I set up a basic USD viewer application using the Omniverse Realtime Viewer architecture?”: The agent will guide you to start with the viewer app reference, resolve dependencies, and implement the core runtime owner to manage the OVStage and OVRTX renderer.
“I need to add stylized rendering to my existing viewer. Where should I start?”: The agent will direct you to the stylized visualization references to implement the required USD/Lua/CUDA nodes within your existing runtime owner.
“How can I enable an AI agent to control the viewer scene?”: The agent will point to the A2UI Scene Copilot reference to implement an operation interface that allows the agent to send commands through the existing runtime owner.
“How do I switch between different render outputs like beauty and depth in my viewer?”: The agent will explain how to use the AOV switching reference to map RenderVars and update the RenderProduct's orderedVars through the runtime owner.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/nvidia/omniverse-realtime-viewer/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip omniverse-realtime-viewer.zip -d .agents/skills

Documentation by NVIDIA Omniverse

Omniverse Realtime Viewer

Build responsive USD viewers by composing OVRTX rendering, OVStage scene state, and the delivery/UI libraries appropriate to the app. Use this package for viewer architecture and interaction; use each selected SDK's upstream guidance for installation and exact release-specific APIs.

Start With The App

When delivery is explicit, select its recipe through references/routing.md and follow its current phase. Otherwise start with references/usd-viewer-app/README.md. For an existing app, keep its architecture and read only the references for the requested change. Broad app, conventions and UI catalogs are lookups as needed.
Resolve the selected libraries through references/dependencies/README.md. Preserve the project's manifest unless an upgrade is requested.
Build a working frame and camera interaction in the chosen shell, then add the requested capabilities. Read references/conventions.md for shared input, camera, selection, and protocol conventions.
Use references/viewer-ux-workflow/README.md for broader interface design. Loading, selection feedback, errors, and input responsiveness belong in the first working app, alongside rendering.
Validate the actual delivery path with references/validation.md. A browser screenshot does not validate a native window or a different transport.

Architecture

Owner	Responsibility
Viewer runtime	Own the live OVStage, publication clock, OVRTX renderer, scene changes, and render stepping.
UI and input adapter	Display frames and copied app state; send user intent to the runtime owner.
Storage/query/simulation workers	Perform their assigned work and return results through the selected integration boundary.
Delivery adapter	Present locally or stream through ovstream; respect frame ownership and backpressure.

Use OVRTX for USD/3D rendering. Browser apps display its WebRTC video; local apps present its output through their native shell. A missing GPU means rendering is unverified, not a reason to substitute a browser 3D renderer.

Keep viewer cameras, settings, effects, and transient edits in app-owned session or runtime state so the source USD stays intact. Serialize scene mutation and render stepping through the runtime owner. Read references/ovstage-ovrtx-integration/README.md for that loop, then the population or data-plane references when implementing scene loading or attribute writes.

Keep expensive loading and metadata work off the UI and render threads. Keep transport details behind a delivery adapter so camera, selection, properties, and loading state can be reused across local and streamed shells.

Add Capabilities As Needed

Use references/routing.md to select camera/picking, scene management, render settings, cloud assets, simulation, editor tools, deployment, or CAE/CFD visualization. Read the selected capability's implementation flow and its linked contract; the full reference catalog is not a prerequisite for a first frame.

For simulation, use the routing reference's Simulation Ecosystem section plus references/realtime-sim-integration/README.md. For UI-driven forces or control, add references/interaction-round-trip/README.md.

For example scenes, use references/usd-sample-data/README.md. When a runtime failure needs diagnosis, use references/troubleshooting/README.md and the selected SDK's matching release guidance before changing the architecture.

Solid Modeling: Upstream First

For usd-brep, exact BRep, solid modeling, kernel failures, CAD topology, or BrepArray questions, first read references/dependencies/README.md → USD BRep. Follow the owning repository's current agent guidance, skills, operation docs, and package API before selecting local integration references. Discover the upstream router rather than assuming skill names or directory layouts remain fixed. Upstream owns modeling semantics, schema rules, tuning, and diagnostics; this package owns OVRTX display, worker handoff, selection mapping, and publication timing.

GPU Processing And Stylized Viewers

For custom GPU processing, chained outputs and lens sampling, read references/spg-processing/README.md. For toon, ink, technical/X-Ray styles, geometry strokes or full wireframe, continue to references/stylized-visualization/implementation.md. Its USD/Lua/CUDA starting node and geometry/depth/composite build sequence work with the selected viewer recipe; use references/stylized-visualization/style-recipes.md for the preset math and references/stylized-visualization/README.md for supporting contracts. Implement the result inside the existing OVRTX/runtime owner and deliver the published processed output. These instructions do not require a sample checkout or a prior stylized-rendering implementation.

For an optional usd-brep geometry source, first read references/dependencies/README.md → USD BRep and the owning repository's current agent guidance, skills, and operation docs; then read references/stylized-visualization/usd-brep-source.md for the display boundary.

XR Viewers

For headsets, immersive viewers, or spatial editors, start with references/xr-viewer-recipe/README.md. Resolve SDK setup and contracts through references/dependencies/ovxr.md; the library owns OpenXR lifecycle and frame submission. For controllers, hands, navigation, or scene tools, add references/xr-spatial-input/README.md and references/ovxr-python-interactions/README.md. For projection-integrated UI, read references/ovxr-composition-ui/README.md and references/ovxr-composition-ui-validation/README.md.

Files

ATTRIBUTION.mdAdded by AutoGineer943 B
BENCHMARK.md13.4 KiB
LICENSELicence file added by AutoGineer11.2 KiB
SKILL.md6.4 KiB
evals/evals.json7.0 KiB
references/a2ui-scene-copilot/README.md10.9 KiB
references/aov-switching/README.md10.5 KiB
references/cae-cfd-visualization/README.md10.1 KiB
references/cae-cfd-visualization/cae-data-ingestion.md5.6 KiB
references/cae-cfd-visualization/coordinate-systems-and-up-axis.md11.0 KiB
references/cae-cfd-visualization/data-and-operators.md11.7 KiB
references/cae-cfd-visualization/driving-cae-viz-via-ovstage.md6.4 KiB
references/cae-cfd-visualization/emitter-and-seed-sources.md16.3 KiB
references/cae-cfd-visualization/glyphs.md7.1 KiB
references/cae-cfd-visualization/ovstage-render-and-camera.md11.0 KiB
references/cae-cfd-visualization/ovui-controls.md13.2 KiB
references/cae-cfd-visualization/rtwt-blueprint-recreation.md11.9 KiB
references/cae-cfd-visualization/streaming-cae-viewer.md25.9 KiB
references/cae-cfd-visualization/temporal-playback.md9.2 KiB
references/cae-cfd-visualization/usd-authoring-and-materials.md21.5 KiB
references/cae-cfd-visualization/volume-rendering.md2.5 KiB
references/camera-auto-select/README.md9.0 KiB
references/camera-controls/README.md20.9 KiB
references/camera-picker/README.md9.5 KiB
references/cloud-assets/README.md4.5 KiB
references/cloud-deployment/README.md19.6 KiB
references/cloud-deployment/container-image-build.md2.2 KiB
references/cloud-deployment/gpu-container-runtime.md2.8 KiB
references/cloud-deployment/nvcf-self-hosted.md8.4 KiB
references/cloud-deployment/nvcf-viewer-container-contract.md4.8 KiB
references/cloud-deployment/webrtc-network-diagnostics.md3.9 KiB
references/cloudxr-opaque-data-channel/README.md1.1 KiB
references/conventions.md7.4 KiB
references/cpp-native-viewer/README.md4.9 KiB
references/cpp-native-viewer/build-details.md5.2 KiB
references/cpp-native-viewer/interaction-features.md11.3 KiB
references/cpp-native-viewer/presentation-loop.md8.0 KiB
references/cpp-native-viewer/project-build.md3.4 KiB
references/cpp-native-viewer/renderer-session.md7.1 KiB
references/cpp-native-viewer/validation.md3.4 KiB
references/dependencies/README.md6.8 KiB
references/dependencies/electron-shm.md1.5 KiB
references/dependencies/environment-validation.md6.6 KiB
references/dependencies/frontend.md2.3 KiB
references/dependencies/local-openusd-gpu.md8.7 KiB
references/dependencies/nvidia-runtime.md14.8 KiB
references/dependencies/ovrtx.md3.1 KiB
references/dependencies/ovstream.md3.3 KiB
references/dependencies/ovxr.md2.3 KiB
references/dependencies/quick-setup.md2.6 KiB
references/dependencies/skia-yoga.md936 B
references/electron-shm-viewer/README.md2.5 KiB
references/electron-shm-viewer/architecture-project.md6.3 KiB
references/electron-shm-viewer/electron-client.md6.5 KiB
references/electron-shm-viewer/protocol-interaction-lifecycle.md7.9 KiB
references/electron-shm-viewer/python-shm-server.md5.5 KiB
references/electron-shm-viewer/validation.md2.8 KiB
references/exact-brep-in-usd/README.md2.5 KiB
references/gl-viewport-overlay/README.md8.0 KiB
references/gl-viewport-overlay/architecture.md4.1 KiB
references/gl-viewport-overlay/example-gizmo.md5.5 KiB
references/gl-viewport-overlay/interaction-pattern.md4.0 KiB
references/gl-viewport-overlay/projection-alignment.md4.3 KiB
references/headless-shm-cli/README.md12.3 KiB
references/huggingface-usd/README.md7.7 KiB
references/interaction-round-trip/README.md40.1 KiB
references/local-viewer/README.md17.8 KiB
references/native-picking-selection/README.md13.1 KiB
references/navigation-presets/README.md4.6 KiB
references/navigation-presets/preset-camera-ops.md5.1 KiB
references/newton-physics/README.md8.8 KiB
references/object-selection/README.md11.1 KiB
references/ovrtx-rendering/README.md23.0 KiB
references/ovstage-data-plane/README.md3.5 KiB
references/ovstage-live-geometry/README.md3.3 KiB
references/ovstage-ovrtx-integration/README.md5.0 KiB
references/ovstage-population/README.md3.7 KiB
references/ovstage-runtime/README.md3.1 KiB
references/ovui-library/README.md3.3 KiB
references/ovui-library/api-reference.md4.3 KiB
references/ovui-library/extending.md4.8 KiB
references/ovui-local-viewer-recipe/README.md4.7 KiB
references/ovui-local-viewer-recipe/interaction-features.md16.9 KiB
references/ovui-local-viewer-recipe/project-structure.md6.2 KiB
references/ovui-local-viewer-recipe/setup-shell-renderer.md16.4 KiB
references/ovui-local-viewer-recipe/validation-build-order.md6.1 KiB
references/ovwidgets-editor-shell/README.md5.4 KiB
references/ovxr-composition-ui-validation/README.md7.1 KiB
references/ovxr-composition-ui-validation/evidence-gates.md3.5 KiB
references/ovxr-composition-ui-validation/frustum-placement.md2.4 KiB
references/ovxr-composition-ui-validation/library-only-validation.md8.1 KiB
references/ovxr-composition-ui-validation/owned-orchestration.md5.3 KiB
references/ovxr-composition-ui-validation/viewer-evidence.md4.0 KiB
references/ovxr-composition-ui/README.md8.5 KiB
references/ovxr-composition-ui/async-raster-pipeline.md5.0 KiB
references/ovxr-composition-ui/compositor-passes-and-sync.md6.4 KiB
references/ovxr-composition-ui/depth-tools.md5.0 KiB
references/ovxr-composition-ui/editor-document-model.md4.8 KiB
references/ovxr-composition-ui/experience-quality.md8.5 KiB
references/ovxr-composition-ui/foveation-and-edge-math.md3.5 KiB
references/ovxr-composition-ui/library-only-compositor.md10.4 KiB
references/ovxr-composition-ui/native-build-and-discovery.md4.6 KiB
references/ovxr-composition-ui/performance-and-telemetry.md7.9 KiB
references/ovxr-composition-ui/primary-projection-compositor.md3.5 KiB
references/ovxr-composition-ui/primary-projection.md4.1 KiB
references/ovxr-composition-ui/projection-and-depth.md5.3 KiB
references/ovxr-composition-ui/raster-abi.md3.0 KiB
references/ovxr-composition-ui/sdk-frame-backend.md1.6 KiB
references/ovxr-composition-ui/skia-yoga.md2.8 KiB
references/ovxr-composition-ui/spatial-interaction.md5.6 KiB
references/ovxr-composition-ui/spatial-surfaces-and-interaction.md10.4 KiB
references/ovxr-composition-ui/telemetry-contract.md3.8 KiB
references/ovxr-composition-ui/validation-and-live-gates.md3.9 KiB
references/ovxr-foveation-and-display/README.md1.1 KiB
references/ovxr-frame-loop-and-readback/README.md1.2 KiB
references/ovxr-library-runtime/README.md1.1 KiB
references/ovxr-library-runtime/ar-compositing.md4.4 KiB
references/ovxr-library-runtime/frame-input-order.md2.2 KiB
references/ovxr-library-runtime/library-only.md1.1 KiB
references/ovxr-library-runtime/live-ar-controls.md4.3 KiB
references/ovxr-library-runtime/mirror-lifetime.md4.1 KiB
references/ovxr-library-runtime/settings-and-lifetime.md3.9 KiB
references/ovxr-library-runtime/viewer-assembly.md225 B
references/ovxr-openxr-runtime/README.md1012 B
references/ovxr-python-interactions/README.md1.8 KiB
references/ovxr-python-interactions/architecture.md5.5 KiB
references/ovxr-python-interactions/feature-patterns.md7.4 KiB
references/physics-simulation/README.md7.1 KiB
references/prim-info-display/README.md10.9 KiB
references/prim-pick-effects/README.md7.3 KiB
references/prim-transform-safety/README.md8.6 KiB
references/realtime-sim-integration/README.md7.0 KiB
references/render-settings/README.md12.6 KiB
references/routing.md37.7 KiB
references/section-views/README.md5.8 KiB
references/seg-outline-highlight/README.md1.5 KiB
references/selection-animation/README.md5.0 KiB
references/selection-feedback/README.md7.5 KiB
references/smlib-brep-pitfalls/README.md2.5 KiB
references/spg-processing/README.md8.0 KiB
references/stage-attribute-reads/README.md6.2 KiB
references/stage-hierarchy/README.md20.3 KiB
references/stage-hierarchy/fallback-worker-protocol.md7.4 KiB
references/stage-loading/README.md7.1 KiB
references/stage-management/README.md6.6 KiB
references/stage-queries/README.md6.1 KiB
references/streaming-client/README.md25.6 KiB
references/streaming-lifecycle/README.md4.6 KiB
references/streaming-messages/README.md19.5 KiB
references/streaming-messages/server-handler-map.md3.1 KiB
references/streaming-server/README.md17.7 KiB
references/streaming-server/frame-loop-and-continuity.md3.8 KiB
references/streaming-viewer-recipe/README.md1.9 KiB
references/streaming-viewer-recipe/client-protocol.md14.2 KiB
references/streaming-viewer-recipe/interaction-features.md13.8 KiB
references/streaming-viewer-recipe/project-structure.md7.3 KiB
references/streaming-viewer-recipe/server-runtime.md20.2 KiB
references/streaming-viewer-recipe/validation-build-order.md8.5 KiB
references/streaming-vs-local/README.md9.4 KiB
references/stylized-visualization/README.md8.7 KiB
references/stylized-visualization/aov-guide-contracts.md8.1 KiB
references/stylized-visualization/implementation.md11.4 KiB
references/stylized-visualization/line-compositor-delivery.md7.7 KiB
references/stylized-visualization/mesh-xray.md10.1 KiB
references/stylized-visualization/reproduction-validation.md10.2 KiB
references/stylized-visualization/style-composition-contract.md5.4 KiB
references/stylized-visualization/style-recipes.md14.7 KiB
references/stylized-visualization/usd-brep-source.md4.9 KiB
references/subprocess-geometry-bridge/README.md3.5 KiB
references/tauri-local-viewer/README.md6.7 KiB
references/tauri-shm-transform-gizmo/README.md12.3 KiB
references/transform-manipulator/README.md17.1 KiB
references/troubleshooting/README.md11.2 KiB
references/troubleshooting/scenario-playbooks.md24.7 KiB
references/usd-sample-data/README.md12.0 KiB
references/usd-viewer-app/README.md5.0 KiB
references/validation.md6.3 KiB
references/viewer-backend-interface/README.md20.1 KiB
references/viewer-control-patterns/README.md4.8 KiB
references/viewer-data-view-patterns/README.md5.6 KiB
references/viewer-feedback-status/README.md5.0 KiB
references/viewer-input-routing/README.md11.9 KiB
references/viewer-layout-patterns/README.md4.7 KiB
references/viewer-ux-workflow/README.md5.2 KiB
references/viewport-overlays/README.md9.9 KiB
references/viewport-overlays/cuda-compositing.md6.6 KiB
references/viewport-resize/README.md4.0 KiB
references/vulkan-compositing/README.md6.1 KiB
references/vulkan-compositing/depth-overlays.md15.7 KiB
references/vulkan-compositing/interop-and-lifecycle.md6.6 KiB
references/webgl-shm-transport/README.md14.5 KiB
references/windows-native-setup/README.md11.6 KiB
references/xr-client-connection/README.md1.1 KiB
references/xr-client-message-contract/README.md8.5 KiB
references/xr-desktop-mirror/README.md13.8 KiB
references/xr-session-modes-and-passthrough/README.md930 B
references/xr-spatial-input/README.md2.3 KiB
references/xr-spatial-input/advanced-tools.md5.2 KiB
references/xr-spatial-input/controllers.md16.3 KiB
references/xr-spatial-input/feature-validation.md4.9 KiB
references/xr-spatial-input/gesture-arbitration.md4.9 KiB
references/xr-spatial-input/gesture-filtering.md5.5 KiB
references/xr-spatial-input/hand-recognizers.md4.0 KiB
references/xr-spatial-input/hands.md10.3 KiB
references/xr-spatial-input/navigation.md13.5 KiB
references/xr-spatial-input/physics-interaction.md23.2 KiB
references/xr-spatial-input/simulation-lifecycle.md5.9 KiB
references/xr-spatial-input/stage-composition.md4.9 KiB
references/xr-spatial-input/teleport-acceptance.md5.2 KiB
references/xr-spatial-input/webxr-client.md3.9 KiB
references/xr-tracking-anchor-and-scale/README.md950 B
references/xr-viewer-recipe/README.md10.5 KiB
skill-card.md7.7 KiB
skill.oms.sig58.2 KiB

references/troubleshooting/README.md

Troubleshooting

Triggers

Use this skill for troubleshoot, debug Omniverse Realtime Viewer, server won't start, no video, data channel not working, wrong colors, black frame, scene won't load, camera doesn't move, picking broken, or WebRTC internals.

Use this when an Omniverse Realtime Viewer fails during startup, streaming, scene loading, rendering, input, selection, or UI state sync. Start by classifying the first broken boundary instead of chasing downstream symptoms.

Triage Flowchart

Server process does not start
  -> Server startup diagnostics
Server starts but browser cannot connect
  -> WebRTC signaling and port diagnostics
Browser connects but video is blank or frozen
  -> Video streaming and renderer step diagnostics
Embedded host hides media capabilities or connection does not decode a frame
  -> Embedded-host H264 preflight and decoded-frame diagnostics
Electron SHM viewer opens but viewport is black, disconnected, or stutters
  -> Electron SHM Viewer diagnostics
Tauri or desktop WebView drag loses release, sticks, or selects after a drag
  -> Desktop WebView Pointer Lifecycle in viewer-input-routing
Video streams but colors/materials/frame are wrong
  -> Render var, BGRA conversion, camera, MDL diagnostics
UI connects but buttons/tree/settings do nothing
  -> Data-channel diagnostics
Stage open fails or loads as empty
  -> Scene loading and asset path diagnostics
Scene loads but camera does not move
  -> Input callback and live camera write diagnostics
Camera works but click selection is wrong or empty
  -> Picking, coordinate, and segmentation diagnostics
Selection works but highlight/info/tree is stale
  -> Derived state reset and message routing diagnostics
Physics or runtime transforms crash, no-op, or desynchronize
  -> OVStage/OVPhysX boundary diagnostics
Scene switch crashes or hangs
  -> Renderer ownership and stage reset diagnostics

Fast Rules

Debug one boundary at a time: process startup, WebRTC connection, rendered frame, JSON message, USD query, then feature state.
Keep one render thread as the owner of renderer.step(), reset_stage(), open_usd(), open_usd_from_string(), reference mutation, native pick queries, selection outline writes, and live write_attribute() calls.
In OVStage-backed apps, the parent viewer runtime also owns stage lifetime, ordinals, write floors, renderer attachment, and publication.
Keep pxr queries and OVPhysX USD population in workers unless the exact ABI/import path is verified. A failed PhysX.attach_ovstage(stage, read_ordinal=...) bridge must not fall back to parent-process OVPhysX population.
In WebRTC streaming apps, mouse, wheel, keyboard, and touch input normally arrive through NVST/ovstream InputEvent callbacks; app state commands use the JSON data channel. If the data channel works but an explicit viewport test produces no native callback, use the documented mutually exclusive browser mouseInput fallback.
A frontend "loading forever" state is usually either a missing openStageResult, a missed proactive state push, or a message-name mismatch.
For an Electron app with a Python sidecar on Windows, first run the App-Local Desktop Preflight in windows-native-setup; then diagnose the process and SHM lifecycle through electron-shm-viewer.
A local Omniverse Realtime Viewer skips WebRTC entirely. If the same renderer and scene code works locally but not in a browser, focus on ovstream, frame conversion, and the standalone ovstream Direct AppStreamer config.

Scenario Playbooks

Detailed startup, streaming, scene, input, selection, hierarchy, and recovery playbooks live in scenario-playbooks.md.

Common Error Map

Message or symptom	Actual cause	Usual fix
`ModuleNotFoundError: ovstream`	Python binding missing or native lib path missing	Install ovstream and set `OVSTREAM_LIB_PATH`
`CRenderApi not found`	ovrtx plugin tree not resolved	Set `OVRTX_BIN_PATH` and plugin library path
`usd-core detected`	ovrtx USD check found another USD package	Set `OVRTX_SKIP_USD_CHECK=1` before ovrtx work
`multiple debug symbol definitions for SDF_ASSET`	Two USD registries loaded	Put ovrtx bundled libs first or split pxr into worker
`_tf` import failure	USD DLL/shared library conflict	Fix import order or use subprocess queries
Duplicate USD registry, `TfType::AddAlias`, or repeated USD plugin/type aliases	`pxr`/`usd-core` or another USD-populating runtime loaded beside OVRTX	Move OpenUSD queries or physics USD population behind a process boundary
`Default.mdl` parse crash	Renderer initialized after wrong USD registry	Fix import/construction order
`PhysX.attach_ovstage(stage, read_ordinal=...)` reports missing `ovstage_register_consumer`, `ovstage_register_output_buffer`, `ovstage_publish`, `ovstage_query_changes`, `ovstage_read_attribute`, or `ovstage_write_attribute`	OVPhysX was built against OVStage bridge symbols unavailable in the installed OVStage wheel	Use the bounded OVPhysX worker path and report the ABI mismatch
Native crash after parent-process OVPhysX population	Competing USD population entered the process that owns OVRTX/OVStage	Move OVPhysX population to a child worker and hand poses back as JSON
Magenta materials	MDL resolver path missing	Set `OVRTX_BIN_PATH` and library path
`Unable to find RenderProduct prim`	Inline/session render path missing or mismatched	Create the render pipeline and pass the exact path
Black frame, no exception	Camera, RenderProduct, resolution, or RenderVar invalid	Validate stage-loading data and camera relation
USD parse error near `RenderVar` inline braces	ovrtx parser rejected one-line `def RenderVar "X" { ... }` syntax	Use multi-line `RenderVar` definitions from `stage-loading`
`RenderProductSetOutputs` has no attribute `get`	`renderer.step()` output was treated as a dict	Use membership checks and `products[render_product_path]`, then map individual RenderVars
Invalid output handle	Renderer-backed output was retained past its valid lifetime	Return owned buffers copied inside each RenderVar map context
First `renderer.step()` exceeds normal test timeout	Cold RTX shader or pipeline compilation	Use a 300s+ first-run timeout and inspect ovrtx logs
Red/blue swapped	RGBA submitted as BGRA	Convert ovrtx `LdrColor` before ovstream
Scene renders but appears sideways	Camera fit, orbit, or pan hard-coded Y-up for a Z-up stage	Query `UsdGeom.GetStageUpAxis` in the metadata worker, set the server camera's `world_up`, refit, and keep the source USD unchanged
Stage load reports success but first frame fails	load operation status or RenderProduct path was not checked	wait/check load status, then step the exact RenderProduct
`TypeError: a coroutine was expected` from `ui.run`	ovui run loop received a callback/function instead of an awaitable	Pass an async render loop coroutine and yield with `await asyncio.sleep(1.0 / 120.0)`
`VIEWPORT_CAMERA_POSE_SOURCE` import failure	stale data adapters installed with newer local UI packages	Install local UI packages from the same package set
ovui widget/adapter dependency resolution fails	first-party versions differ or an obsolete umbrella package was requested	Resolve matching `ovui-widgets-` and `ovui-data-adapters-` distributions through `references/dependencies`
Native UI package requires a compiler toolchain	package/build instructions require local tools	Follow the current `ovui` dependency guidance
`Previous session is already running`	Old WebRTC client/session still active	Close old tab, reduce reconnect storm, restart server if stuck
`Could not get encoded frame` with black video	Direct client codec default was unknown or unsupported	Set explicit `codec: 'H264'` and `codecList: ['H264']` in DirectConfig
Embedded host lacks `navigator.mediaCapabilities`	Host frame does not expose the optional capability API	Record iframe/preflight state, retain explicit H264 config, and require decoded-frame validation; do not reject H264 from API absence alone
`connect()` resolves but no decoded video frame	Startup progress was mistaken for media proof	Check video `readyState`, decoded-frame counter/currentTime, WebRTC internals, and host-frame policy
Connects then disconnects in 1-2 seconds before messages arrive	Server did not stream fallback/idle frames while waiting for a stage command	Stream a valid fallback or last-good BGRA frame every connected tick
Initial app messages never reach the server	Frontend confused startup progress, command readiness, and scene-frame readiness	Follow client readiness; send after confirmed start success, then prove decoded frames
Keyboard/data-channel controls work but mouse drag, button, and wheel produce no server `on_input` events	Native browser input forwarding is unavailable in this host/embed	Verify viewport ownership and callback logs, then enable only the mutually exclusive `mouseInput` fallback in `viewer-input-routing`; do not process native and fallback events together
`NVST_R_INVALID_OPERATION` on second `Server.start()`	`ovstream.shutdown()` ran in a same-process stop path	Use `server.stop()` and `server.close()` for restarts; reserve `ovstream.shutdown()` for process exit
Server sees `messageType` but no `event_type`	AppStreamer envelope not unwrapped	Parse nested `data` payload before dispatch
`POST /sign_in` returns HTTP 501	For a standalone ovstream Direct deployment, frontend used a connection profile intended for a different streaming product or injected auth/session fields	Rebuild the frontend from `streaming-client` using `@nvidia/ov-web-rtc` Direct mode with only the exposed `server` and `signalingPort`
UI waits on `getChildrenResponse`	Protocol name mismatch	Use active `getChildrenResult` route
Picks return old prims	pending pick/selectable state survived scene reload	clear pick state and refresh native pickability
Highlight visible on load	native selection outline groups not cleared	write group `0` for stale selected paths and clear runtime selection
Textures missing only after composition	cache path or sublayer path broke relative references	preserve cache layout and quote the original asset path correctly

Streaming And Local Omniverse Realtime Viewer Paths

Streaming path:

Use streaming-server for ovstream lifecycle, ports, input callbacks, and frame submission.
Use streaming-client for standalone ovstream Direct config, video element setup, browser diagnostics, and guarded sends.
Use streaming-lifecycle when the connection exists but state, messages, or reconnects are wrong.
Use streaming-messages to verify exact JSON event names and payload shapes.

Local Omniverse Realtime Viewer path:

Use local-viewer for ovui shell, image display, UI-thread rules, and coordinate mapping.
Use ovrtx-rendering for renderer construction, frame extraction, and live attribute writes.
Use stage-loading for render prim injection and RenderProduct failures.
Use viewer-input-routing, camera-controls, object-selection, stage-hierarchy, and prim-info-display for feature-specific debugging once the frame renders correctly.

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Python, Needs Node.js

The author says: Orchestrator skill. Downstream focused references may require NVIDIA GPUs, ovrtx, ovstream, ovui, OpenUSD, Python, Node/React, Tauri, Electron, C++, or cloud GPU deployment access depending on the selected viewer path.

Security

What our scanner noticed· Medium risk

Large base64-encoded blobs
Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by

NVIDIA Omniverse

Publisher

NVIDIA (Official)

Source

NVIDIA/skills · skills/omniverse-realtime-viewer · commit fce3cca

Licence

Apache License 2.0 (redistribution allowed)

LICENSE (added by AutoGineer from LICENSE-APACHE)
ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-08

AutoGineer is not affiliated with or endorsed by NVIDIA Omniverse or NVIDIA.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download omniverse-realtime-viewer.zip

From the author

AutoGineer summary

What it does

When to use it

Advantages

Usage examples

Install

Documentation by NVIDIA Omniverse

Omniverse Realtime Viewer

Start With The App

Architecture

Add Capabilities As Needed

Solid Modeling: Upstream First

GPU Processing And Stylized Viewers

XR Viewers

Files

references/troubleshooting/README.md

Troubleshooting

Triggers

Triage Flowchart

Fast Rules

Scenario Playbooks

Common Error Map

Streaming And Local Omniverse Realtime Viewer Paths

Requirements and compatibility

Security

Attribution and licence

Related skills

Setup TS Deep Modules

To Spec

Improve Codebase Architecture

Domain Modeling

Codebase Design

Prototype

Download ZIP