Metadata-Version: 2.4
Name: kentralisten
Version: 0.1.0
Summary: Add your description here
Requires-Python: >=3.12
Requires-Dist: psutil>=7.2.2
Requires-Dist: rich>=15.0.0
Description-Content-Type: text/markdown

# 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](https://docs.astral.sh/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:

```bash
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:

```bash
sudo uv run kentralisten
```

## Technologies Used
- [Rich](https://rich.readthedocs.io/): For the beautiful terminal formatting.
- [psutil](https://psutil.readthedocs.io/): For cross-platform process and system monitoring.
- [uv](https://github.com/astral-sh/uv): For lightning-fast Python package and project management.
