Skip to content

nvtop: support for shared encode/decoder, process kill/terminate #505

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
ItsLemmy merged 3 commits into from
Aug 30, 2026
+349 −74
Merged

nvtop: support for shared encode/decoder, process kill/terminate #505

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
764646d
nvtop: shared enc/dec support, process kill/copy info
tordex Aug 27, 2026
b910a5c
nvtop: added kill to the README.md
tordex Aug 27, 2026
ba3be2b
fix(nvtop): sort translation by key
tordex Aug 28, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
47 changes: 27 additions & 20 deletions nvtop/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,16 @@ Monitor real-time information about your GPU status and running processes with n

# Features

* Uses `nvtop` to monitor real-time information about your GPU status.
* Support for multiple GPUs
* View processes using the GPU
* Process columns: **PID**, **GPU Usage**, **Video Encoder Usage**, **Video Decoder Usage**, **GPU Memory Usage**, and **Command Line**
* Sort processes by any column by clicking its header
* Customizable polling interval
* Customizable colors for the sorted column
* The plugin runs `nvtop` when the panel is opened and closes it when the panel is closed. This helps you save resources.
* Uses `nvtop` to monitor real-time GPU status.
* Supports multiple GPUs.
* View processes using the GPU.
* Process columns: **PID**, **GPU Usage**, **Video Encoder Usage**, **Video Decoder Usage**, **GPU Memory Usage**, and **Command Line**.
* Sort processes by any column by clicking its header.
* Kill a process with SIGINT or terminate it with SIGKILL.
* Copy a process PID or command line to the clipboard.
* Customizable polling interval.
* Customizable colors for the sorted column.
* The plugin launches `nvtop` when the panel opens and closes it when the panel is closed. This helps save resources.

![NVTOP panel](screenshots/panel.png)

Expand All @@ -24,7 +26,7 @@ Monitor real-time information about your GPU status and running processes with n

## Requirements

The plugin requires `nvtop`, `jq`, and `pkill` to be installed and available in `$PATH`.
The plugin requires `nvtop`, `jq`, `kill`, and `pkill` to be installed and available in `$PATH`.

## Usage

Expand Down Expand Up @@ -56,14 +58,14 @@ noctalia msg panel-toggle tordex/nvtop:panel [order_by]

Possible values for `order_by`:

| `order_by` value | Effect |
|--------------------|-------------------------------|
| `pid` | Order by Process ID (PID) |
| `gpu` | Order by GPU Usage |
| `enc` | Order by Video Encoder Usage |
| `dec` | Order by Video Decoder Usage |
| `mem` | GPU Memory Usage |
| `cmd` | Order by Process Command Line |
| `order_by` value | Effect |
| --- | --- |
| `pid` | Sort by Process ID (PID) |
| `gpu` | Sort by GPU Usage |
| `enc` | Sort by Video Encoder Usage |
| `dec` | Sort by Video Decoder Usage |
| `mem` | Sort by GPU Memory Usage |
| `cmd` | Sort by Process Command Line |

Without `order_by`, the panel opens with the previous sort mode.

Expand All @@ -73,11 +75,16 @@ Add `-` before `order_by` to reverse the sort order. For example:
noctalia msg panel-toggle tordex/nvtop:panel -mem
```

Note: some GPUs share an encoder/decoder. In this case, the `ENC` and `DEC` columns are replaced by a single `ENC/DEC` column. The `order_by` values `enc` and `dec` still work, and both sort processes by the `ENC/DEC` column.


## Settings

| Setting | Type | Default | Description |
| --- | --- | --- | --- |
| `delay` | `int` | `5` | Refresh rate. 1 == 0.1s. Valid values 1-20 |
| `sort_column_background` | `color` | `secondary` | The background color for the sort column. |
| `sort_column_color` | `color` | `on_secondary` | The text color for the sort column. |
| `delay` | `int` | `5` | Refresh rate. `1` == `0.1s`. Valid values: `1-20`. |
| `sort_column_background` | `color` | `surface_variant` | Background color for the sorted column. |
| `sort_column_color` | `color` | `on_surface_variant` | Text color for the sorted column. |
| `process_hover_background` | `color` | `surface_variant` | Background color for the hovered row. |
| `process_hover_color` | `color` | `on_surface_variant` | Text color for the hovered row. |

Loading