Skip to content

WinPortKill - A lightweight, powerful Go-based tool for Windows to identify and terminate processes occupying specific ports. Easily free up ports with a simple command-line interface. Perfect for developers, system administrators, and anyone troubleshooting port conflicts.

License

Notifications You must be signed in to change notification settings

imrostami/winportkill

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WinPortKill

Go License Platform

WinPortKill is a simple and powerful tool written in Go that helps you identify and free up occupied ports on Windows. When a port you need is in use, this program lists the processes using it and allows you to terminate them easily.

Features

  • Quick Detection: Displays a list of all processes using the specified port.
  • Easy Termination: Terminate related processes with a single command.
  • Lightweight & Fast: Built with Go, no complex dependencies required.
  • User-Friendly: Suitable for both advanced users and beginners.

image

Installation

Prerequisites

  • Go version 1.18 or higher
  • Windows operating system

Installation Steps

  1. Clone the repository:
    git clone https://github.com/yourusername/winportkill.git
  2. Navigate to the project directory:
    cd winportkill
  3. Build the program:
    go build
  4. The executable winportkill.exe is ready to use!

Install via Binary

You can download the pre-built executable from the Releases section.

Usage

  1. Run the program:
    ./winportkill.exe
  2. Enter the port number (e.g., 8080).
  3. A list of processes using the port will be displayed (including PID and process name).
  4. To terminate a process, enter its PID or use the interactive options provided.

Example

$ ./winportkill.exe
Port Kill CLI - Enter port number to scan (or 'q' to quit):
> 1234
Scanning Port ...

Open ports for 1234:
         Address    PID   Process Name
         -------    ---   ------------
  127.0.0.1:1234  12412  LM Studio.exe

Options: Enter PID or process name to kill, 'all' to kill all, 'skip' to continue, or process name (e.g., node):
> 12412
Process with PID 12412 (LM Studio.exe) terminated successfully.

Important Notes

  • Run as Administrator: Terminating some processes may require running the program with Administrator privileges.
  • Caution: Terminating system processes may cause system instability. Proceed with care.

Contributing

If you have ideas for improvements or encounter issues, please open an Issue or submit a Pull Request.

  1. Fork the project.
  2. Create your feature branch (git checkout -b feature/YourFeature).
  3. Commit your changes (git commit -m 'Add YourFeature').
  4. Push to the branch (git push origin feature/YourFeature).
  5. Open a Pull Request.

License

This project is licensed under the GNU General Public License v3.0 License - see the LICENSE file for details.

About

WinPortKill - A lightweight, powerful Go-based tool for Windows to identify and terminate processes occupying specific ports. Easily free up ports with a simple command-line interface. Perfect for developers, system administrators, and anyone troubleshooting port conflicts.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages