Skip to content

Latest commit

 

History

13 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Pulse

A lightweight terminal-based network monitoring panel written in C using ncurses.

Pulse provides a clean, real-time overview of your current network connection without requiring a full desktop environment. It is designed to be a small component of a larger terminal user interface ecosystem.


Features

  • Detect active network interface
  • Display connection status
  • Show IPv4 address
  • Display default gateway
  • Detect connected Wi-Fi SSID
  • Display Wi-Fi signal strength with a visual bar
  • Monitor total received (RX) and transmitted (TX) traffic
  • Display live download and upload speeds
  • Measure network latency (Ping)
  • Lightweight ncurses interface
  • Minimal dependencies

Preview

Pulse

Interface : wlo1
Status    : Connected
IPv4      : 10.33.56.179
Gateway   : 10.33.56.128

SSID      : ssh
Signal    : [########..] -62 dBm

RX        : 32.6 MB    Down : 70.5 KB/s
TX        : 37.6 MB    Up   : 63.6 KB/s

Ping      : 5.66 ms

Press q to quit

Requirements

  • Linux
  • GCC
  • GNU Make
  • ncurses
  • iw
  • ping (iputils)

Build

make

Run

./pulse

Project Structure

include/
└── pulse/

src/
├── core/
│   ├── network.c
│   ├── ping.c
│   ├── pulse.c
│   ├── traffic.c
│   └── wifi.c
├── internal/
├── ui/
└── main.c

Modules

Network

  • Active interface detection
  • IPv4 detection
  • Gateway detection

Wi-Fi

  • SSID detection
  • Signal strength

Traffic

  • RX/TX counters
  • Live bandwidth calculation

Ping

  • Gateway latency monitoring

UI

  • ncurses-based terminal interface

Design Goals

  • Lightweight
  • Fast
  • Simple
  • Terminal-first
  • Modular architecture
  • Easy to extend

Roadmap

Version 1.0

  • Interface detection
  • Connection status
  • IPv4 address
  • Gateway detection
  • Wi-Fi information
  • Signal strength indicator
  • RX/TX statistics
  • Live bandwidth
  • Ping monitoring

Future Ideas

  • Multiple interfaces
  • Historical traffic graphs
  • Configurable refresh interval
  • Themes
  • IPv6 support
  • Public IP detection
  • Export metrics
  • Plugin system

License

This project is licensed under the MIT License.


Built with C, ncurses, and Linux system interfaces.

About

A lightweight, modular TUI network monitor for Linux with live Wi-Fi status, bandwidth, latency, and traffic graphs, designed to integrate into terminal desktop environments.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages