Files

T

weinguyenandGitHub 691398d9da update(procmon): fix windowed table follow-scroll & row sizing` (#340 )

* update(procmon): fix windowed table follow-scroll & row sizing`

* Update plugin.toml

* Update README.md

* fix(procmon): always render list body as scroll to stop bottom clipping

0-result search switched the body from ui.scroll to a bare ui.row; when
results returned the row->scroll switch left the flexGrow viewport stuck
short, clipping bottom rows. Use ui.scroll with a shared key in both
branches so the tree keeps one stable scroll node.

2026-08-12 22:41:55 -04:00

translations

chore(i18n): procmon

2026-08-09 13:55:51 -04:00

panel.luau

update(procmon): fix windowed table follow-scroll & row sizing` (#340 )

2026-08-12 22:41:55 -04:00

plugin.toml

update(procmon): fix windowed table follow-scroll & row sizing` (#340 )

2026-08-12 22:41:55 -04:00

README.md

update(procmon): fix windowed table follow-scroll & row sizing` (#340 )

2026-08-12 22:41:55 -04:00

service.luau

Update(procmon-plugin): Add keyboard navigation and reduce CPU sampling (#321 )

2026-08-09 13:55:01 -04:00

thumbnail.webp

Add procmon plugin with live process panel (#301 )

2026-08-08 15:40:32 -04:00

widget.luau

Update(procmon-plugin): Add keyboard navigation and reduce CPU sampling (#321 )

2026-08-09 13:55:01 -04:00

README.md

Process Monitor

A bottom-style process monitor for Noctalia: live CPU/RAM/swap bars and a sortable, searchable process table with a per-process kill action, all in a panel. Great for spotting a runaway process or a zombie and killing it without opening a terminal.

Plugin

Field	Value
ID	`weinguyen/procmon`
Entries	Bar widget: `widget`; panel: `panel`; service: `service`

Requirements

Install ps, kill, head, grep and cat on PATH (all are present on virtually every Linux distribution).

Usage

Add the Process Monitor widget to a bar. It shows the current CPU and RAM usage (plus the process count). Click the widget to toggle the process panel:

noctalia msg panel-toggle weinguyen/procmon:panel

The panel shows CPU, RAM and swap bars with the 1/5/15-minute load averages, then a process table. Sort by the column dropdown (PID, CPU%, MEM%, RSS, COMMAND) and flip asc/desc with the arrow button. Type in the filter box to match a process by name, user or PID. Click the ✕ button on a row to run the configured kill command against that PID (default kill -TERM). Zombie processes are tinted with the error color so they stand out. The table refreshes on the interval set in the refresh_interval setting. The panel re-renders automatically as new samples arrive, so the view stays live while it is open.

Settings

Setting	Type	Default	Description
`refresh_interval`	`int`	`1000`	Process resample interval in milliseconds. (default 1000)
`sort_by`	`select`	`cpu`	Initial sort column when the panel opens (`cpu`, `mem`, `pid`, `cmd`).
`kill_command`	`string`	`kill -TERM`	Command run against a selected PID; the PID is appended. Empty falls back to `kill -TERM`.
`show_count`	`bool`	`true`	Bar widget also shows the total process count.

Notes

Spawns processes. A background service runs ps every 2nd refresh interval (the process table changes slowly) and reads /proc stats every interval; runAsync runs the configured kill_command when a row's ✕ is clicked. There is no confirmation dialog, so check the PID before clicking.
The bar widget only renders data the service publishes; it never runs commands. The panel runs the configured kill_command when a row's ✕ is clicked.
Requires plugin_api = 13. The panel renders a windowed slice of the process table and follows the keyboard cursor with edge-follow scrolling (window slides only when the cursor pushes past an edge, so scrolling up doesn't collapse the page until the top edge is reached). CPU%, RAM%, swap and the 1/5/15-minute load averages are sampled from /proc (/proc/stat, /proc/meminfo, /proc/loadavg) by the service, so they work with no separate system-monitor dependency.