zaibatsu 0.2.1

A cyberpunk-themed terminal 3D cityscape process monitor

🌆 Zaibatsu Cityscape Process Monitor

Zaibatsu is an interactive, retro-cyberpunk terminal-based process monitor that represents running system processes as a living city skyline. The height, density, and animation of the buildings directly reflect how active and full your computer is.

---

🎨 Visual Features

• The Skyline (Processes): Each building represents a running process.
  • Height: Proportional to the resource usage of the process (CPU % or Memory RSS).
  • Windows: The density of lit windows and their blinking speed represent real-time CPU usage.
  • Top Chimneys: Processes with high Disk I/O activity will release smoke or steam particles rising from their roofs.
  • Neon Signs: The names of the processes are printed vertically down the center of the buildings.
• The Sky (System Load):
  • Stars: Twinkle dynamically.
  • Moon: Displays phases (Crescent, Half, Gibbous, Full) and warning colors based on overall RAM consumption.
  • Clouds: Scroll horizontally with speeds mapped to background activity.
  • Lightning: Flashes across the sky when system-wide CPU load exceeds 80%.
• The Street (I/O Traffic):
  • Cars drive across the bottom lanes of the city.
  • Car spawn rate and driving speed are mapped to overall Disk Read/Write and Network speeds.
• The Dashboard (TUI Control Panel):
  • Shows real-time CPU and RAM progress bars.
  • Displays Disk and Network speeds in B/s, KB/s, or MB/s.
  • Displays full detail statistics of the currently highlighted building/process.
  • Displays a terminal text filter/search bar.

---

🎮 Keyboard Controls

Key	Action
← / → / ↑ / ↓ or W / A / S / D	Target/Highlight a building in the 2D grid
C	Sort city buildings by CPU usage
M	Sort city buildings by Memory usage
F	Open process name filter (type query, press Enter to apply, Esc to cancel)
Space	Pause / Resume real-time metrics updates (city animations stay active)
K / Delete	Demolish Building — terminates the selected process with an explosion and collapse animation!
Q / Esc	Shutdown Zaibatsu monitor

---

🚀 Setup & Launch

Zaibatsu runs on Windows, macOS, and Linux, and requires a terminal that supports Unicode box characters and ANSI colors (e.g., Windows Terminal, VS Code, PowerShell, Command Prompt, or standard Unix terminal).

Installation

Option A: Install via pipx (Recommended)

pipx isolates Zaibatsu and its dependencies, making it available as a global command-line tool:

pipx install zaibatsu

Option B: Install via pip

You can install Zaibatsu directly from PyPI:

pip install zaibatsu

Once installed, launch it from any terminal:

zaibatsu

Or to demo

zaibatsu -d

You can customize themes (cyberpunk, matrix, sunset) and refresh rates:

zaibatsu --theme matrix --interval 0.2

---

Run from Source (Development)

1. Setup Virtual Environment

Initialize a Python virtual environment and install dependencies:

py -m venv venv
venv\Scripts\activate
pip install -r requirements.txt

2. Run Zaibatsu Launcher

python run.py

---

🛠️ Project Structure

• run.py: CLI launcher script.
• zaibatsu/cli.py: Main terminal screen layout controller.
• zaibatsu/renderer.py: Cityscape layout drawing logic and animations.
• zaibatsu/monitor.py: System and process stats gathering using psutil.
• zaibatsu/input.py: Non-blocking keyboard event listening queue.
• zaibatsu/config.py: Theme declarations and scaling parameters.