5c0 /metropolis

A cyberpunk system monitor that transforms kernel metrics into a living terminal skyline. Built with Rust & Ratatui.

★ 303⑂ 15👁 1⑃ 6● 6▤ 4
RustMITCreated 2026-03-16
Download: Release v0.1.3Release-0.1.3 ↓0.1.32026-05-17
+0
Daily
303
stars
15
forks
1
watchers
6
prs
6
issues
4
releases

README

🌃 Metropolis
 The City Powered by Your Kernel






"The year is 20XX. Your processes aren't just rows in a table. They're the residents. Your CPU isn't just silicon. It's the infrastructure. And the city? The city is breathing."

Features • Usage • Controls • Architecture



---

Metropolis is a high-performance, narrative-driven system monitor built for the terminal. It transcends traditional hardware monitoring by transforming raw kernel metrics into a living, breathing Cyberpunk Skyline. 

Every flicker of a neon sign, every shuttle streaking across the sky, and every drop of rain is a direct reflection of your system's heartbeat.

 Demos

 🌃 Night
!Metropolis demo

 ☔ Rain
!Metropolis rain demo

 ❄️ Snow
!Metropolis snow demo

---

 Features

- Dynamic Branding: The central monolith automatically detects your OS and brands itself accordingly (or override it with your own).
- CPU (The Heartbeat): High utility triggers "Rush Hour"—flooding sky-lanes with high-speed traffic and increasing pedestrian density.
- Disk I/O (Logistics): Intense activity triggers Heavy Industrial Shuttles. Watch long-haulers move "physical data" across the district.
- RAM (Illumination): Memory usage dictates the overall occupancy and glow of the city's monoliths.
- Neon Signage: Secondary buildings display your Top CPU Processes as vibrant neon signs.
- Dynamic Pursuits: Random high-stakes police chases streak across the skyline. Look for the Red Fugitive and Interceptor units.
- Procedural Night: Window patterns and traffic cycles are session-unique.
- Fully Customizable: Swap themes, toggle weather, and fine-tune simulation density via a simple config.toml or CLI flags.

---

 Installation

 One-Line Install (Linux / macOS)
bash
curl -fsSL https://raw.githubusercontent.com/5c0/metropolis/main/install.sh | bash


 Crates.io
bash
cargo install metropolis-tui


 Arch Linux (AUR)
bash
yay -S metropolis


 Homebrew (macOS)
bash
brew install 5c0/tap/metropolis


 Windows (winget)
bash
winget install 5c0.Metropolis


 Nix / NixOS (Flake)
Run directly without installing:
bash
nix run github:5c0/metropolis


Or add to your flake.nix inputs:
nix
inputs.metropolis.url = "github:5c0/metropolis";

Then add to environment.systemPackages:
nix
environment.systemPackages = [
  inputs.metropolis.packages.${system}.default
];


 Build from Source
Requires Rust and cargo to be installed.
bash
git clone https://github.com/5c0/metropolis.git
cd metropolis
cargo run --release

---

 Controls

| Key | Action |
|:---:|:---|
| q | Escape the city (Quit) |
| r | Atmospheric Shift (Toggle Rain) |
| s | Cryo Shift (Toggle Snow) |
| d | Core Diagnostics (Debug Overlay) |

---

 Configuration

Metropolis automatically creates its default config.toml on first run:

| OS | Config Path |
|:---|:---|
| Linux | ~/.config/metropolis/ |
| macOS | ~/Library/Application Support/Metropolis/ |
| Windows | %APPDATA%\Metropolis\ |

You can customize almost everything:
- Themes: Switch between built-in theme

Discussions

Latest release

Release v0.1.3 v0.1.3 2026-05-17
Metropolis: The city is breathing. 🌇

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON