https://github.com/imrostami/winportkill
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.
https://github.com/imrostami/winportkill
cli cli-tool cli-tools developer-tools go golang network-tools port-management port-scanner process-killer system-administration windows
Last synced: 9 months ago
JSON representation
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.
- Host: GitHub
- URL: https://github.com/imrostami/winportkill
- Owner: imrostami
- License: gpl-3.0
- Created: 2025-06-10T13:03:31.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-10T13:27:40.000Z (10 months ago)
- Last Synced: 2025-06-19T22:11:26.836Z (10 months ago)
- Topics: cli, cli-tool, cli-tools, developer-tools, go, golang, network-tools, port-management, port-scanner, process-killer, system-administration, windows
- Language: Go
- Homepage:
- Size: 26.4 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WinPortKill
  
**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.
## Installation
### Prerequisites
- Go version 1.18 or higher
- Windows operating system
### Installation Steps
1. Clone the repository:
```bash
git clone https://github.com/yourusername/winportkill.git
```
2. Navigate to the project directory:
```bash
cd winportkill
```
3. Build the program:
```bash
go build
```
4. The executable `winportkill.exe` is ready to use!
### Install via Binary
You can download the pre-built executable from the [Releases](https://github.com/imrostami/winportkill/releases) section.
## Usage
1. Run the program:
```bash
./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
```bash
$ ./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](https://github.com/yourusername/winportkill/issues) 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](LICENSE) file for details.