pttr: port and process terminator is cross-platform terminal UI application for viewing and managing open ports - process on your system.
- Cross-platform: Works on macOS, Linux, and Windows
- Modern Terminal UI: Beautiful interface with colors, icons, and visual indicators
- Triple View Modes: Toggle between viewing open ports, running processes, and network interfaces
- Port Detection: Automatically scans for open ports and listening services
- Process Management: Kill processes by PID with a single keypress
- Real-time Updates: Refresh current view on demand
- Filtering: Search and filter by name, process, port number, or PID
- Visual Resource Monitoring: CPU and memory usage bars with color-coded indicators
You can run the below curl to install it somewhere in your PATH for easy use. Ideally it will be installed at ./bin
folder
curl -sfL https://raw.githubusercontent.com/abhimanyu003/pttr/main/install.sh | shIf you are on macOS and using Homebrew, you can install pttr with the following:
brew install abhimanyu003/tap/pttrsudo snap install --devmode pttr
yay -S pttr-binscoop bucket add pttr https://github.com/abhimanyu003/scoop-bucket.git
scoop install pttrgo install github.com/abhimanyu003/pttr@latestMacOS Binary ( Multi-Architecture )
Linux (Binaries) amd64 | arm64 | i386
Windows (Exe) amd64 | arm64 | i386
FreeBSD (Binaries) amd64 | arm64 | i386
Download the pre-compiled binaries from the Release! page and copy them to the desired location.
- Smart Process Names: Shows user-friendly names (e.g., "Google Chrome" instead of "chrome")
- Fast Process Icons: Optimized text-based icons ([Web], [Dev], [DB], [Sys], etc.)
- Multiple Sort Modes: Sort by CPU usage (default), memory usage, name, or PID (works in both flat and tree view)
- Enhanced Process Tree: Proper tree structure with ├── and └── symbols, sorted at each level
- Visual Resource Usage: CPU and memory bars with color-coded indicators (░▒▓█)
- High Usage Alerts: 🔥 for high CPU, 💾 for high memory usage
- Parent Process Info: Shows parent PID for process relationships
- Smart Filtering: Filter/search works correctly without interfering with hotkeys
- High Performance: Optimized for fast loading and responsive UI
- Flexible Startup: Start with either ports or processes view using command line flags
- Permission Management: Intelligent permission checking with sudo suggestions
The application includes comprehensive fallback mechanisms:
- If
lsofis not available, falls back tonetstat - If extended
psoptions fail, uses basicpscommands - Multiple kill methods for different permission levels
- Graceful degradation when commands are not available
- Automatic Detection: Shows current user and privilege level
- Smart Error Messages: Identifies permission-related failures
- Sudo Suggestions: Recommends using sudo when needed
- Safe Testing: Pre-checks permissions before attempting to kill processes
# For killing system processes
sudo pttrOther similar tools from which pttr draws inspiration
- https://github.com/productdevbook/port-killer ( macOS only )
- https://github.com/treadiehq/port-kill ( macOS only )
This project welcomes your PR and issues. For example, refactoring, adding features, correcting English, etc. If you need any help, you can contact me on Twitter.
Thanks to all the people who already contributed!