Linux Port Killer

A lightweight system tray application for Linux that helps you find and kill processes using specific network ports.

Inspired by PortKiller for macOS.

Features

• Automatic port discovery - Detects all listening TCP ports instantly
• One-click termination - Kill processes with a single button
• Auto-refresh - Updates every 5 seconds
• Search - Filter by port number or process name
• System tray integration - Quick access from your taskbar
• Modern UI - Dark theme with clean design

Installation

1. Install dependencies

Ubuntu/Debian:

sudo apt install python3-gi python3-gi-cairo gir1.2-gtk-3.0 gir1.2-appindicator3-0.1

Fedora:

sudo dnf install python3-gobject gtk3 libappindicator-gtk3

Arch Linux:

sudo pacman -S python-gobject gtk3 libappindicator-gtk3

2. Clone and install

git clone https://github.com/DGouron/linux-port-killer.git
cd linux-port-killer
./install.sh

The installer will:

• Copy the application to /opt/linux-port-killer/
• Add "Port Killer" to your application menu
• Create a desktop shortcut

3. Launch

You can now launch Port Killer from:

• Your application menu (search "Port Killer")
• The desktop shortcut
• Terminal: /opt/linux-port-killer/run.sh

Uninstallation

cd linux-port-killer
./uninstall.sh

Usage

1. Launch the application - the window opens automatically
2. Browse the list of listening ports
3. Use the search bar to filter by port number or process name
4. Click "Kill" to terminate a process
5. The list auto-refreshes every 5 seconds

The app also runs in your system tray for quick access.

Permissions

Some system processes require root privileges to kill. If you see a permission error, you can:

sudo /opt/linux-port-killer/run.sh

Development

Run directly from source:

cd linux-port-killer
./run.sh

Project Structure

linux-port-killer/
├── src/
│   ├── __init__.py
│   ├── main.py           # GTK UI and system tray
│   └── port_scanner.py   # Port detection via ss command
├── assets/
│   └── linux-port-killer.svg
├── linux-port-killer.desktop
├── install.sh
├── uninstall.sh
├── run.sh
└── README.md

License

MIT