Back to the store
Plugin

GPU-Z Plugin

by DodecaDev

Live GPU-Z sensor readings and graphics card details as Macro Deck variables.

Code

GPU-Z Plugin for Macro Deck 3

Live hardware readings from GPU-Z as Macro Deck variables: clocks, temperatures, load, fan speed and power draw, plus your graphics card's details (name, driver, memory, BIOS).

This is the Macro Deck 3 version of the Macro Deck 2 GPU-Z plugin. It is not affiliated with or endorsed by TechPowerUp.

Requirements

Windows (GPU-Z is Windows only) GPU-Z running. The plugin reads the shared memory GPU-Z publishes while it is open; nothing needs to be configured in GPU-Z itself.

Using the variables

Open the variable browser in Macro Deck and expand GPU-Z:

Folder Contains Type Card info Everything GPU-Z lists about the card: CardName, DriverVersion, MemSize, BIOSVersion, ... Text Sensors Every sensor GPU-Z shows for your card: GPU Clock, GPU Temperature, GPU Load, ... Number

Pick the readings you want. Each one becomes an ordinary variable named after GPU-Z's own name, for example GPU Temperature becomes gpuzgputemperature. Only bound readings are read, so there is no list to maintain and no cost for the ones you do not use.

A sensor's value is just the number, so it works in calculations. Its unit and GPU-Z's precision are attributes:

{{ vars.gpuzgputemperature }} → 64.5 {{ vars.gpuzgputemperature.unit }} → °C {{ vars.gpuzgputemperature.digits }} → 1 {{ vars.gpuzgputemperature times: 1.8 plus: 32 }} → 148.1

Unit conversions

Some sensors also get a converted entry, listed right after the original in Sensors. These are useful for bindings, where there is no template to do the maths in:

GPU-Z unit Converted entry Example name MB GB (divided by 1024, as GPU-Z's MB are binary) gpuzmemoryuseddedicatedgb MB/s GB/s (divided by 1024) gpuzgbs MHz GHz gpuzgpuclockghz °C °F gpuzgputemperaturef

gpuzisrunning is true while GPU-Z is running. While it is false, every other GPU-Z variable is unavailable, and they all come back on their own once GPU-Z starts. Test for that in a template with vars.gpuzgputemperature.state.isavailable.

The available sensors depend on your card and GPU-Z version.

Coming from Macro Deck 2

There is no whitelist and no polling frequency to set: bind what you need in the variable browser. Readings refresh every second. Card-info variables keep their Macro Deck 2 names (gpuzcardname). Each sensor is now one variable. Macro Deck 2's gpuzvalue is now gpuz, unit is .unit and digits is .digits. The Refresh Variables action is gone: readings are always current.

Development

The plugin is a .NET 10 console app built on the Macro Deck 3 plugin SDK.

src/DodecaDev.GpuZ/ the plugin GpuZ/ reading and parsing GPU-Z's shared memory, the 1-second monitor Variables/ catalog ids and variable names PluginIntegration.cs the variable provider tests/DodecaDev.GpuZ.Tests/ PluginTestHarness tests, with GPU-Z faked

dotnet test # unit and harness tests macrodeck-plugin run --project src/DodecaDev.GpuZ --stub-host # run without Macro Deck macrodeck-plugin test --project src/DodecaDev.GpuZ # conformance suite macrodeck-plugin run --project src/DodecaDev.GpuZ # against Macro Deck (Developer Mode on)

Install the CLI with dotnet tool install --global MacroDeck.Plugin.Cli --version 3.0.0-beta.15. The SDK version is pinned in Directory.Packages.props.

AGENTS.md holds the plugin-writing rules from the Macro Deck plugin template.

Releasing

Publish a GitHub release tagged vX.Y.Z. .github/workflows/release.yml builds, runs the conformance suite and uploads the package to the Macro Deck Creator Portal, which signs it after review.

License

MIT

README badge

Paste this into your README so people can open this page in the Macro Deck Store.