Metadata-Version: 2.4
Name: portndock
Version: 1.0.0
Summary: Dev-focused port watcher/killer with Docker awareness and live TUI
Author-email: Marc Carlo Dy <dymarccarlo@yahoo.com>
License: MIT
Project-URL: Homepage, https://github.com/decentaro/portndock
Project-URL: Repository, https://github.com/decentaro/portndock
Project-URL: Issues, https://github.com/decentaro/portndock/issues
Keywords: port,process,docker,development,kill,terminal,tui
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development
Classifier: Topic :: System :: Networking
Classifier: Topic :: System :: Systems Administration
Classifier: Topic :: Terminals
Classifier: Environment :: Console
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# portndock

A cross-platform terminal tool for developers to easily find and kill processes using ports. Perfect for fixing **"port already in use"** errors!

## Features

- **Find processes by port** - See what's using any port
- **Docker aware** - Handles containers intelligently  
- **Interactive TUI** - Color-coded safety levels
- **Related processes** - Find Electron renderers and background processes
- **Safe by default** - Warns about dangerous processes
- **Cross-platform** - Windows, macOS, Linux
- **Zero dependencies** - Pure Python

## Installation

```bash
# Recommended (handles environment isolation)
pipx install portndock

# Upgrade to latest version
pipx upgrade portndock

# Alternatives
pip install portndock --user
python3 -m venv env && source env/bin/activate && pip install portndock
```

## Local Development

```bash
# Clone the repository
git clone https://github.com/decentaro/portndock.git
cd portndock

# Run directly from source (no installation needed)
python3 -m portndock
# or with sudo for system processes
sudo python3 -m portndock ui

# Install in development mode (optional)
pip install -e .
```

## Usage

```bash
# Interactive mode (recommended)
portndock

# Command line
portndock kill --port 3000
portndock list
portndock free --port 8080
```

## Interactive Controls

- **↑/↓** - Navigate • **Enter** - Kill process • **D** - Stop container
- **V** - Filter ports • **P** - Filter protocols • **E** - Toggle related processes
- **X** - Toggle IPv6 • **?** - Help • **Q** - Quit

## Color Coding

- **Blue** - Docker containers (safe)
- **Green** - Your processes (safe)
- **Yellow** - System processes (careful) 
- **Red** - Critical processes (danger)

## Examples

```bash
portndock ui                   # Interactive TUI
portndock kill --port 3000     # Kill by port
portndock kill --pid 12345     # Kill by PID  
portndock list --protocol tcp  # List TCP only
portndock free --port 8080     # Free port (Docker-aware)
```

## Requirements

Python 3.8+ • No dependencies • Cross-platform

## License

MIT
