Skip to content

Latest commit

 

History

6 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

TopView ⚡

npm version

A beautiful, interactive terminal system monitor and process viewer (an htop-style) built in Node.js with blessed and systeminformation.


Features

  • Interactive Loading Screen: A smooth, dynamic resource initialization screen that fetches device details, memory, disk, and network configurations before launching the main dashboard.
  • Real-Time System Metrics: High-performance progress bars tracking:
    • CPU utilization
    • RAM & Swap usage
    • Disk storage capacity
    • Network throughput

Installation & Setup

Install globally via NPM (CLI)

You can install TopView directly from NPM to run it globally on your system:

npm install -g @kigemmanuel/topview

After installation, simply run the tool from anywhere in your terminal:

topview

Run from Source (Local Development)

  1. Clone the repository:

    git clone https://github.com/kigemmanuel/topview.git
    cd topview
  2. Install dependencies:

    npm install

How to Run

  • For local development:

    npm run dev
  • To run globally as a CLI tool:

    npm link
    topview

Tip

Make your terminal full screen for the best visual experience and layout alignment.


Controls

Key Action
q or Ctrl + C Exit TopView
/ (Arrow Keys) Scroll through the running processes

Built With

  • blessed — A high-level terminal interface library for Node.js.
  • systeminformation — System information library for Node.js.

Created with ⚡ by kigemmanuel.

About

A beautiful, interactive terminal system monitor and process viewer (an htop-style) built in Node.js with blessed and systeminformation.

Resources

Stars

4 stars

Watchers

0 watching

Forks

Contributors

Languages