GPU Shark

GPU Shark is a native Windows desktop application built with Rust and egui, without a browser or web runtime and without silent background telemetry. It shows only measurements that the hardware and driver actually expose; unavailable sensors stay hidden instead of being replaced with guessed values.¹

• GPU Core, HotSpot and VRAM temperatures when the hardware exposes them
• Decoded NVIDIA PerfCap reasons compatible with GPU-Z: Pwr, Thrm, VRel, VOp, Idle and SLI
• Separate fan RPM values on supported multi-fan boards
• GPU, board and source power and voltage sensors
• Live graph for the selected sensor
• Per-sensor maximum tracking, enabled by double-clicking a sensor row
• Persistent language, refresh interval and accent settings
• Persistent light and dark themes and optional Windows startup
• Localized About view with the project logo and application version
• Consent-based feedback form with no automatic submission
• Optional update checks and explicit SHA-256-verified installation

The interface keeps live readings, settings, About information and consent-based feedback in one compact resizable desktop application.

The regular driver/provider path works with many NVIDIA GPUs, but the exact set of visible sensors depends on the GPU, board design, driver and firmware. Enhanced temperature support is deliberately tracked per validated device profile.¹

See SUPPORTED_GPUS.md for the user-facing support matrix. If a measurement cannot be confirmed, GPU Shark leaves it unavailable.

The immediate focus is the GUI polish pass, RTX 50 beta validation and expanding the sensor model without weakening the read-only or privacy guarantees.

AMD GPU support is a long-term idea only: there is no active implementation or release target for it yet.

1. Open the releases page.
2. Download GPU-Shark-win-x64.zip and SHA256SUMS.txt from the newest release.
3. Compare the archive SHA-256, unpack it and launch GPU-Shark.exe.
4. Accept the Windows administrator prompt required for read-only hardware access.

(Get-FileHash .\GPU-Shark-win-x64.zip -Algorithm SHA256).Hash

The official package contains a standalone executable. Windows SmartScreen may warn because the current binaries are not code-signed. Download only from this repository and verify the published hash.

• Windows 10 or Windows 11, x64
• NVIDIA GPU with an installed display driver
• Administrator privileges for local hardware access

The application never sends a report automatically. Feedback is submitted only after the user writes a message and explicitly accepts the consent option. A report can contain the app version, selected interface language, detected GPU name, currently displayed public sensors, a safe provider error, the user's message and an optional reply address.

Reports do not include GPU UUIDs, serial numbers, computer name, Windows account name or private hardware diagnostics.

The public Rust/egui GUI source is in gui-source/. The managed and native telemetry-provider implementations are intentionally not published. Matching public runtime DLLs are supplied through the GPU-Shark-gui-runtime-win-x64.zip release asset.⁴

• Stable Rust toolchain with rustfmt
• Visual Studio C++ Build Tools
• The runtime asset matching the GUI version

1. Download the matching runtime asset and extract it.
2. Open PowerShell in gui-source/.
3. Configure a compatible feedback destination. The production destination is not stored in public source.
4. Format, test and build the GUI.
5. Build either an adjacent-runtime development package or a standalone EXE.

$env:GPU_SHARK_FEEDBACK_HOST = "your-compatible-feedback-host"
$env:GPU_SHARK_FEEDBACK_PATH = "/your/api/path"

cargo fmt --check
cargo test
cargo build --release --locked

Copy-Item C:\path\to\runtime\*.dll .\target\release\
.\target\release\gpu-shark-gui.exe

For the official standalone layout, embed the verified runtime while building:

$env:GPU_SHARK_EMBED_PUBLIC_RUNTIME = "1"
$env:GPU_SHARK_PUBLIC_PAYLOAD_DIR = "C:\path\to\verified-runtime"
cargo build --release --locked

The GUI loads gs.dll beside the executable and calls the small public export q to receive one privacy-filtered JSON telemetry snapshot. Runtime and GUI versions must match.

The Build public GUI workflow formats, checks and builds the GUI, downloads the matching runtime, verifies its published SHA-256, embeds it and uploads a standalone single-EXE CI artifact. The workflow has read-only repository permissions and cannot publish or modify releases.

Small, focused pull requests are welcome. Keep implementation, documentation and build changes in separate commits when practical.

git checkout -b feat/short-description

cargo fmt --check
cargo test
cargo check --locked

git add path\to\changed-file
git diff --cached
git commit -m "feat: describe the user-visible change"
git push -u origin feat/short-description

Open a pull request against main and explain:

• what changed and why;
• how it was tested;
• which GPU/driver was used for hardware-specific behavior;
• whether the change affects privacy, packaging or the public ABI.

GPU Shark's original code and release binaries are available under the Beerware license. Third-party components retain their own licenses; their notices are included in every binary/runtime release asset.

Bug reports are welcome through GitHub Issues.