kentralisten 0.1.0

Add your description here

kentraLISTEN

A beautiful, terminal-based CLI application that lists every network port your host is listening on. Built with Python, it uses the Rich library to render a clean, colorful table and psutil to securely discover network connections and process information.

Features

• Detailed Process Info: Displays protocol type, local address, port number, PID, and process name.
• Beautiful UI: Uses Rich for a visually appealing and organized terminal output.
• macOS Friendly: Gracefully handles macOS security restrictions on connection discovery with intelligent fallbacks.
• Cross-Platform: Designed to work across different operating systems.

Prerequisites

This project uses uv for dependency management and execution.

• Python 3.12+
• uv package manager

How to Run

You can run the application directly using uv, which will automatically handle the dependencies:

uv run kentralisten

Elevated Privileges

By default, running the application as a standard user restricts it from viewing connections owned by other users or the system (especially on macOS). To get a complete, system-wide list of all listening ports, run the application with elevated privileges:

sudo uv run kentralisten

Technologies Used

• Rich: For the beautiful terminal formatting.
• psutil: For cross-platform process and system monitoring.
• uv: For lightning-fast Python package and project management.