The Flame of the West · Reforged in Rust
A System Monitor Reforged
Named after the blade shattered at the dawn of the Third Age
and reforged for a king — narsil is sharper
than the tools that came before it.
What Narsil Sees
Every metric your system holds, rendered in Braille and flame — without ever leaving the terminal. Runs on Linux, Windows and macOS. GPU monitoring is Linux-only for now.
Every percentage label inside a gauge automatically inverts its colour character-by-character at the fill boundary — so text is always readable, even when the bar sits at exactly 50%. No other terminal monitor does this.
unique to narsilCPU & RAM gauges, live RX/TX sparklines, and a process list that fills every available line of your terminal.
Global usage history rendered in Braille dot art, followed by per-core gauges colour-coded by load intensity.
Braille chartsRAM and Swap history charts with live GiB usage gauges. See exactly how much of your kingdom's silver remains.
Combined RX/TX history chart alongside live per-direction throughput — every packet a message from the realm.
Per-partition usage bars at fixed height, with ▲ ▼ scroll indicators when your vaults exceed the visible height.
scrollableProcess table sorted by CPU usage — the lords of the realm and their burdens, always filling the visible height.
Per-GPU cards with utilisation and VRAM history charts, live gauges, temperature, and power draw. AMD and NVIDIA fully supported. GPU monitoring requires Linux with the amdgpu or NVIDIA proprietary driver.
Pass --interval <ms> to tune between low-latency and low-CPU usage. Defaults to 1 000 ms. Key events are processed between ticks with zero busy-waiting — swift and silent as a ranger.
--interval <ms>
Forge Your Blade
Runs on Linux, Windows 10+, and macOS 12+. Rust is only needed for the crates.io and source options. GPU support requires Linux.
cargo install narsil
yay -S narsil-bin
./narsil-*.AppImage
narsil.exe
tar xzf narsil-*.tar.gz
cargo build --release
The quickest path. Cargo fetches, compiles with full optimisations, and installs the binary to ~/.cargo/bin/. Works on Linux, Windows, and macOS.
~/.cargo/bin/ is on your $PATH. For NVIDIA GPU support see the NVIDIA support tab.
Four AUR packages cover every combination of source/binary and standard/NVIDIA.
Self-contained Linux bundle — no installation needed. Download, make executable, run.
narsil-{version}-x86_64.AppImage (standard) and
narsil-nvidia-{version}-x86_64.AppImage (with NVIDIA support).
Requires a Linux x86_64 system.Prebuilt Windows x86_64 executable — no Rust, no compiler needed. Download, extract, run in PowerShell or cmd.
narsil-{version}-x86_64-windows.zip from
GitHub Releases ↗.
A NVIDIA variant (narsil-nvidia-…-windows.zip) is also provided.Plain Linux tarball — drop the binary wherever you like. No package manager needed.
narsil-{version}-x86_64.tar.gz (standard) and
narsil-nvidia-{version}-x86_64.tar.gz (with NVIDIA support).
Clone and build locally — ideal for development or inspecting the forge.
Enable NVIDIA GPU monitoring via NVML. Requires proprietary NVIDIA drivers at link time. Linux only.
nvidia feature links against libnvidia-ml.so. If the NVML library is absent at link time, the build fails — this is by design.
The Stewards of Silicon
GPU monitoring is Linux-only — narsil reads deep into the kernel’s sysfs and NVML to bring you real GPU metrics. On Windows and macOS the GPU tab is not compiled in; all other tabs work normally.
AMD APU VRAM values reflect GTT — system RAM dynamically shared with the GPU. The numbers are accurate; dedicated-vs-shared label disambiguation is planned.
Command the Blade
Measured Against Heroes of Old
The blades that came before, and what sets narsil apart.
| Feature | top |
htop |
gotop |
⚔️ narsil |
|---|---|---|---|---|
| Language | C | C | Go | 🦀 Rust |
| GPU metrics | ✗ | ✗ | partial | AMD + NVIDIA (Linux) |
| Braille charts | ✗ | ✗ | ✓ | ✓ |
| Per-char label inversion | ✗ | ✗ | ✗ | ✓ |
| Disk usage bars | ✗ | ✗ | ✓ | ✓ |
| Scroll indicators | ✗ | ✓ | ✗ | ✓ |
| Keybinding status bar | ✗ | ✗ | ✗ | ✓ |
| Log tail panel | ✗ | ✗ | ✗ | planned |
| Alert rules | ✗ | ✗ | ✗ | planned |
| Remote / SSH mode | ✗ | ✗ | ✗ | planned |
What the Palantír Foretells
--interval <ms>--json / --prometheus export for Grafana