Releases: lhl/amdtop
Releases · lhl/amdtop
Release list
amdtop v0.2.6
Added
- Allow quitting with
Ctrl+Cin addition toqandEsc. - Show each GPU's maximum PCIe link generation and width beside its PCI BDF
when available. - Add an XDNA NPU telemetry and workload guide covering fdinfo compatibility,
matched driver/XRT builds, runtime setup, validation, and troubleshooting. - Add a hidden
rshortcut to rediscover devices after hotplug while retaining
sparklines for unchanged GPUs.
Changed
- Simplify the GPU sensor row to show power first, followed by labeled edge and
memory temperatures, while omitting unavailable values.
Fixed
- Fall back to input power on GPUs that do not expose average power.
- Keep runtime-suspended GPUs visible as sleeping, preserve their PCI-order
indices, and initialize telemetry in place when another workload wakes them. - Allow for delayed AUR package-page/RPC indexing after a successful packaging
push, avoiding false publication failures during normal index convergence.
Full Changelog: v0.2.5...v0.2.6
amdtop v0.2.5
Highlights
- Adds 41 bundled native TOML themes with semantic telemetry roles and positioned gradients;
tokyo-nightis now the default for new installations. - Adds adaptive APU GPU bandwidth reporting, combining memory-controller utilization with SoC DRAM read/write throughput when both are available.
- Relicenses amdtop under Apache-2.0, with bundled-theme provenance and attribution documented in
THIRD_PARTY.md. - Adds the published
amdtopAUR package and a reviewed local maintenance workflow. - Refreshes the project screenshot using real Ghostty terminal rendering and a bounded GPU activity sweep.
See CHANGELOG.md for the full release history and docs/THEMES.md for theme customization.
Full Changelog: v0.2.4...v0.2.5
amdtop v0.2.4
Added
- Show resident system memory as
MEMalongside per-process VRAM/GTT usage. - Add a reproducible screenshot generator with configurable terminal geometry,
fonts, cell dimensions, representative CPU load, and frame selection.
amdtop v0.2.3
amdtop 0.2.3 is a maintenance release that fixes GPU process discovery and establishes tokenless crates.io publishing.
Added
- Add a maintainer publishing checklist and a GitHub Actions OIDC workflow for tokenless crates.io releases.
Changed
- Refresh the README screenshot with representative variable CPU and dual-GPU load, including live GPU process telemetry.
Fixed
- Refresh GPU process indexes periodically so applications started or restarted after amdtop launches appear in the process table.
Install
cargo install amdtop --version 0.2.3 --lockedamdtop requires Linux, an AMD GPU using the amdgpu driver, and Rust 1.88 or newer when building from source.
amdtop v0.2.2
amdtop 0.2.2 is the first release published on crates.io under the amdtop name.
Install it with:
cargo install amdtop --lockedChanged
- Sort physical GPUs by PCI BDF so amdtop numbering is deterministic and agrees with
rocm-smi/rocminfophysical ordering. - Document the distinction between system-wide GPU indices and
HIP_VISIBLE_DEVICES/ROCR_VISIBLE_DEVICESprocess-local mappings. - Pin
libamdgpu_topto the reviewed 0.11.5 release so backend behavior cannot change without an amdtop update.
Fixed
- Keep discrete-GPU device handles open by default to prevent utilization, clocks, and sensors from becoming stuck at idle after low-power transitions or system sleep. Set
AGT_NO_DROP=0to restore runtime D3Hot behavior. - Fall back to the driver's default power limit when it reports a zero current cap, rather than displaying
0W. - Refresh the screenshot with corrected GPU ordering and live sensors for both test GPUs.
See the README for requirements, configuration, and usage details.