whatisgithub

What is netwatch?

yeet-src/netwatch — explained in plain English

Analysis updated 2026-05-18

11JavaScriptAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

netwatch is a Linux terminal dashboard that shows live upload and download network speed as a colorful, scrolling, two-sided bar chart, with no root access required.

Mindmap

mindmap
  root((netwatch))
    What it does
      Live network speed chart
      Mirrored up down bars
      Per interface view
      Hover readout
    Tech stack
      JavaScript
      JSX
      yeet runtime
    Use cases
      Monitor bandwidth usage
      Compare interfaces
      Always on terminal widget
    Audience
      Developers
      Linux users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Watch a download or upload saturate a network link in real time in the terminal.

USE CASE 2

Compare live traffic across multiple network interfaces, like a wired connection, a VPN tunnel, or a Docker bridge.

USE CASE 3

Keep an always-visible throughput monitor running in a spare terminal or tmux pane.

USE CASE 4

Scrub back through recent traffic history and read the exact speed at a specific past moment.

What is it built with?

JavaScriptJSXyeet

How does it compare?

yeet-src/netwatch100/tab-organizerchalarangelo/jsiqle
Stars111111
LanguageJavaScriptJavaScriptJavaScript
Last pushed2021-03-01
MaintenanceDormant
Setup difficultyeasyeasyeasy
Complexity2/51/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Linux only, requires installing the yeet runtime first via its install script.

GPL-2.0 license: you can use and modify the code, but any distributed modified versions must also be released under the same license.

So what is it?

netwatch is a terminal dashboard that shows how much data your computer is sending and receiving over the network, right now, drawn as a colorful two-sided bar chart. Outgoing traffic climbs upward from a center line while incoming traffic falls downward from the same line, with the newest reading always appearing on the right and older readings scrolling off to the left as time passes. It runs as a script for a tool called yeet, and reads live network counters straight from the operating system's kernel without needing administrator or root access, since yeet exposes those counters over its own unprivileged connection. The kernel only tracks total bytes sent and received over time, so netwatch samples those totals twice a second and calculates the difference between samples to get an actual speed, which it then keeps a short rolling history of so the chart can scroll smoothly. You can pick which network interface to watch, such as a wired connection, a WireGuard tunnel, or a Docker network, or view all of them combined, switching between them with arrow keys, a mouse click on a dropdown, or the scroll wheel. Hovering or dragging across the chart shows the exact speed at that point in time along with how long ago it was recorded. The whole display uses a purple, magenta, and gold color gradient for outgoing traffic and a cooler blue and cyan gradient for incoming traffic, giving it a retro synthwave look, and it reports speeds using standard units like kilobytes and megabytes per second. Installation is a single command that installs the yeet runtime and then runs netwatch directly from its GitHub repository, and it currently only supports Linux. The project is released under the GPL-2.0 license.

Copy-paste prompts

Prompt 1
Show me the one-line command to install yeet and run netwatch from GitHub on Linux.
Prompt 2
Explain how netwatch turns the kernel's cumulative byte counters into a live speed reading.
Prompt 3
How do I switch netwatch between watching eth0, a WireGuard interface, and the combined 'all' view?
Prompt 4
Describe the color scheme and layout netwatch uses to show upload versus download traffic.

Frequently asked questions

What is netwatch?

netwatch is a Linux terminal dashboard that shows live upload and download network speed as a colorful, scrolling, two-sided bar chart, with no root access required.

What language is netwatch written in?

Mainly JavaScript. The stack also includes JavaScript, JSX, yeet.

What license does netwatch use?

GPL-2.0 license: you can use and modify the code, but any distributed modified versions must also be released under the same license.

How hard is netwatch to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is netwatch for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.