Skip to content

Releases: kagehq/port-kill

Port Kill v0.1.19 - Release

04 Sep 17:55
ea54237
Compare
Choose a tag to compare

🎉 Release v0.1.19

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.18 - Release

04 Sep 17:27
Compare
Choose a tag to compare

🎉 Release v0.1.18

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.17 - Release

04 Sep 17:22
Compare
Choose a tag to compare

🎉 Release v0.1.17

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.16 - Release

04 Sep 16:13
Compare
Choose a tag to compare

🎉 Release v0.1.16

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.15 - Release

02 Sep 16:34
Compare
Choose a tag to compare

🎉 Release v0.1.15

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.14 - Release

02 Sep 15:00
Compare
Choose a tag to compare

🎉 Release v0.1.14

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.13 - Release

02 Sep 14:53
Compare
Choose a tag to compare

🎉 Release v0.1.13

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.12 - Release

02 Sep 12:46
Compare
Choose a tag to compare

🎉 Release v0.1.12

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.10 - Release

02 Sep 11:40
Compare
Choose a tag to compare

🎉 Release v0.1.10

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.

Port Kill v0.1.9 - Release

02 Sep 03:32
Compare
Choose a tag to compare

🎉 Release v0.1.9

Port Kill is now available for all major platforms with full functionality! A lightweight cross-platform status bar app that monitors and manages development processes running on configurable ports.

✨ Key Features

🌍 Cross-Platform Support

  • macOS: Native system tray with dynamic context menu
  • Linux: Native system tray with GTK integration (auto-fallback to console)
  • Windows: Native system tray with full functionality
  • Console Mode: Works on all platforms without GUI dependencies

🔍 Process Monitoring

  • Real-time scanning: Monitors configurable ports every 5 seconds
  • Smart detection: Identifies processes by name, PID, and Docker containers
  • Visual feedback: Status bar icons (Green: 0, Orange: 1-9, Red: 10+ processes)
  • Configurable ranges: Monitor specific ports or port ranges (default: 2000-6000)

🛡️ Safe Process Management

  • Individual killing: Kill specific processes by clicking menu items
  • Bulk operations: Kill all detected processes with one click
  • Safe termination: SIGTERM → SIGKILL strategy with graceful fallback
  • Ignore lists: Exclude system processes (Chromecast, AirDrop, etc.)

🐳 Docker Integration

  • Container detection: Shows Docker container names and IDs
  • Container management: Automatically stops containers when killing processes
  • Graceful handling: Uses docker stop with docker rm -f fallback

⚙️ Advanced Features

  • Log level control: Configurable verbosity (info, warn, error, none)
  • PID display: Optional process ID display for better identification
  • Full-screen support: Console mode recommended for full-screen applications
  • Error handling: Graceful handling of permission errors and process failures

🚀 Quick Installation

Automated Install (Recommended)

# macOS/Linux
curl -fsSL https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.sh | bash

# Windows
# Download install-release.bat and run it, or use:
powershell -Command "Invoke-WebRequest -Uri 'https://raw.githubusercontent.com/kagehq/port-kill/main/install-release.bat' -OutFile 'install-release.bat' && install-release.bat"

Manual Installation

# Clone and build from source
git clone https://github.com/kagehq/port-kill.git
cd port-kill
./install.sh

📦 Included Binaries

System Tray Mode (GUI)

  • macOS: port-kill-macos
  • Linux: port-kill-linux
  • Windows: port-kill-windows.exe

Console Mode (No GUI Dependencies)

  • macOS: port-kill-console-macos
  • Linux: port-kill-console-linux
  • Windows: port-kill-console-windows.exe

🎯 Usage Examples

Basic Usage

# Default monitoring (ports 2000-6000)
./run.sh                    # macOS
./run-linux.sh              # Linux
run-windows.bat             # Windows

# Monitor specific ports
./run.sh --ports 3000,8000,8080

# Console mode (recommended for full-screen)
./run.sh --console --ports 3000,8000

Advanced Usage

# Docker integration
./run.sh --docker --ports 3000,3001,8000

# Ignore system processes
./run.sh --ignore-ports 5353,5000,7000 --ignore-processes Chrome,ControlCe

# Custom log level
./run.sh --log-level warn --ports 3000,8000

🔧 System Requirements

macOS

  • macOS 10.15 or later
  • Rust 1.70+ (for building from source)
  • lsof command (included)

Linux

  • GTK support (auto-fallback to console if missing)
  • Rust 1.70+ (for building from source)
  • lsof command
  • Required packages: libatk1.0-dev libgdk-pixbuf2.0-dev libgtk-3-dev libxdo-dev

Windows

  • Windows 10 or later
  • Rust 1.70+ (for building from source)
  • netstat and tasklist commands (included)

🐛 Known Issues & Solutions

Full-Screen Mode

  • Issue: System tray menu not accessible in full-screen
  • Solution: Use console mode: ./run.sh --console --ports 3000,8000

Linux GTK Issues

  • Issue: GTK initialization errors
  • Solution: Install GTK packages or use console mode

Docker Integration

  • Issue: Docker containers not detected
  • Solution: Ensure Docker Desktop is running and docker command is available

📚 Documentation

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

📄 License

This project is licensed under the FSL-1.1-MIT License. See the LICENSE file for details.


Happy coding! 🚀

Port Kill - Making development process management simple and cross-platform.