Omahub
← All plugins
E

Network Throughput

by EGOIST

Compact upload and download rates with a stable per-process activity panel.

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
01bb389
Scanned
1 month ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
01bb389
Reviewed
1 month ago

The plugin is a benign network throughput widget that reads system counters and uses standard commands (ip, ss, awk, jq) to display rates and per-process activity. It performs no installation, no privileged operations, no network access, and no destructive actions. The code is transparent and matches its documented behavior.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/egoist/omarchy-network-throughput --enable
Widgets #bar #quickshell #system

Network Throughput for Omarchy

A compact Omarchy Quattro bar widget that stacks upload above download and opens a native per-process activity panel.

Network Throughput preview

Features

  • Interface-wide upload and download rates in a narrow two-line bar slot
  • Stable recent-process roster that keeps idle apps visible at 0 B/s
  • Per-process TCP throughput without root privileges
  • An Other traffic row for UDP/HTTP3, proxy/TUN, system-owned, short-lived, and protocol-overhead traffic
  • Optimistic background refreshes that keep the last snapshot visible
  • Theme-aware native Quattro panel and application icons

Install

omarchy plugin add https://github.com/egoist/omarchy-network-throughput.git --enable

The widget lands in the right section of the bar. Move it if needed:

omarchy bar move dev.egoist.network-throughput --section right

Configure

Set the fixed horizontal widget width (default 68):

omarchy bar set dev.egoist.network-throughput width 68

Set the number of recent process rows (default 5, range 1–10):

omarchy bar set dev.egoist.network-throughput processCount 5

How attribution works

The bar reads the active interface counters in /sys/class/net. The panel uses ss TCP counters to attribute traffic to user-visible processes, then reconciles the remaining interface bytes as Other traffic. This avoids claiming there is no activity when traffic cannot be safely assigned to a process.

Local loopback sockets may seed idle entries in the recent-process roster, but their traffic is never counted against interface throughput.

Dependencies and security

The plugin runs unsandboxed with your user permissions, like every Omarchy shell plugin. It does not use sudo, install packages, start services, or access the network itself.

It uses commands included with a standard Omarchy installation: Bash, ip, ss, awk, jq, sort, head, and date.

Update

omarchy plugin update dev.egoist.network-throughput

Remove

omarchy plugin remove dev.egoist.network-throughput

License

MIT