Back to plugins
Network Indicator

Network Indicator

A `lively` network traffic indicator.

v2.0.0 tonigineer MIT May 3, 2026

About

NetworkIndicator Plugin for Noctalia

A Noctalia bar widget that displays current network upload (TX) and download (RX) activity. Includes optional live throughput values and a hover-activated graph panel.

Features

  • TX/RX Activity Indicators: Icons for TX and RX with active/idle coloring based on a configurable traffic threshold.
  • Vertical and Horizontal Layouts: Configurable cell grid: arrange up to four cells (TX icon, RX icon, TX speed, RX speed) in a horizontal row or a 2脳2 grid. Cells can be left empty to show only icons or only values.
  • Network Graph Panel: Click on the widget to open a live graph panel showing recent RX and TX history.
  • Custom Font: Override the default font for speed values, with optional bold and italic styles.
  • Theme Support: Uses theme colors by default; all colors can be overridden individually.

Installation

This plugin is part of the noctalia-plugins repository.

Configuration

Access settings through the widget's context menu.

Layout: Choose between horizontal (single row) and vertical (2脳2 grid) cell arrangement. Cell Assignment: Assign what each cell displays. Duplicates are not allowed. Use empty cells to reduce the widget to just icons or just speed values. Icon Type: Select the icon style for the TX/RX indicators (arrow, arrow-bar, arrow-big, arrow-narrow, caret, chevron, chevron-compact, fold). Activity Threshold: Traffic below this value (B/s) is treated as inactive, and icons switch to the idle color. Font & Icon Size: Scale text and icon sizes relative to the defaults. Custom Font: Override the default font for speed values, with optional bold and italic. Custom Colors: Override theme colors for TX active, RX active, inactive, and text individually. Spacing & Padding: Adjust left/right padding, column spacing, and row spacing.

Usage

  • Add the widget to your Noctalia bar.
  • Left-click the widget to open the network graph panel.
  • Right-click the widget to access settings.
  • Configure the plugin settings as required.

Requirements

  • Noctalia 4.7.6 or later.

Technical Details

  • The widget reads SystemStatService.txSpeed and SystemStatService.rxSpeed; the polling interval is determined by that service.
  • The graph panel uses SystemStatService.rxSpeedHistory and SystemStatService.txSpeedHistory with NGraph from the Noctalia Shell.
  • Unfortunately, the update interval SystemStatService.networkIntervalMs is currently hardcoded to 3000 by Noctalia.