killport-tui

Crates.iokillport-tui
lib.rskillport-tui
version1.0.0
created_at2025-12-04 01:34:38.136502+00
updated_at2025-12-05 02:03:23.669388+00
descriptionA TUI tool to view ports and kill processes.
homepage
repositoryhttps://github.com/last1chosen/killport-tui
max_upload_size
id1965639
size271,000
(last1chosen)

documentation

README

Killport-tui 🦀

A lightweight, terminal-based UI tool to view open ports and kill the processes occupying them. Built with Rust and Ratatui.

License: MIT Platform

Overview

killport-tui provides a visual interface for managing system processes that are listening on network ports. Instead of chaining lsof, grep, and kill commands manually, you can browse, filter, and terminate processes directly from a clean TUI.

Features

  • Visual Dashboard: View Port, PID, Process Name, and Command details in a table.
  • Search & Filter: Press / to filter processes by name, PID, or port number.
  • Safety First: "Confirm to Kill" modal prevents accidental shutdowns.
  • Cross-Platform: Works on Linux, macOS, and Windows.
  • Lightweight: Built with Rust for high performance and low resource usage.

Installation

Option 1: Quick Install

macOS / Linux

curl -sL https://raw.githubusercontent.com/last1chosen/killport-tui/main/install.sh | sh

Windows

  1. Download the latest .exe file from the Releases Page
  2. Rename the file to kp.exe
  3. Place it in a folder in your PATH (or run directly in current folder)

Option 2: Using Cargo

If you have Rust installed, you can install directly from the repository:

cargo install --git https://github.com/last1chosen/killport-tui


# Build and run
cargo run --release

Usage

Key bindings

Key Action
↑ / ↓ Navigate the list of ports
/ Search mode (Type to filter list)
k Kill mode (Opens confirmation dialog)
y Confirm kill (inside confirmation dialog)
n/Esc Cancel kill
Esc Exit search mode / Cancel action
q Quit application

Built with

Ratatui - The TUI library.

Crossterm - Terminal manipulation.

Sysinfo - System handling.

Listeners - Port detection.

Screenshots

Killport TUI Screenshot

Commit count: 0

cargo fmt