Port Manager

Port Manager is a sophisticated real-time port monitoring application that offers a distinctly Wes Anderson-inspired aesthetic. This project enhances the experience of monitoring network ports on systems, combining elegant vintage design with cutting-edge features.

Features

• Wes Anderson Aesthetic: Delight in beautiful pastel colors, vintage typography, and symmetrical layouts that evoke nostalgia.
• Real-time Port Scanning: Experience fast and efficient monitoring across multiple platforms including macOS, Linux, and Windows.
• Smart Sorting: Easily identify and prioritize project-related ports with golden badges that highlight them above the rest.
• Working Directory Display: Gain visibility on the operational locations of each process to streamline troubleshooting.
• Animated Scanning Feedback: Interact with animated binocular visuals and flowing logs that provide ongoing feedback during scans.
• Comprehensive Details: Access in-depth information for each port, including process names, process IDs (PIDs), CPU usage, memory consumption, and file paths.
• Search & Filter Functionality: Quickly locate ports by filtering through numbers, process names, protocols, states, or directories.
• WebSocket Updates: Enjoy live updates on port status without the need for page refreshes.
• Responsive Design: The interface is optimized for any device — desktop, tablet, or mobile — ensuring accessibility at all times.
• Accessibility Compliance: Built to adhere to WCAG 2.1 AA standards, featuring keyboard navigation capabilities.

Screenshot

Experience a dashboard that mirrors the charming essence of Wes Anderson while efficiently managing network ports.

Architecture

Port Manager employs a modern client-server architecture, allowing seamless communication and efficient port scanning through its streamlined components:

┌─────────────────┐      WebSocket/HTTP      ┌─────────────────┐
│                 │ ◄─────────────────────── │                 │
│  Frontend       │                          │  Backend        │
│  (HTML/CSS/JS)  │ ──────────────────────► │  (FastAPI)      │
│                 │                          │                 │
└─────────────────┘                          └─────────────────┘
                                                      │
                                                      │ Port Scanning
                                                      ▼
                                             ┌─────────────────┐
                                             │  System Ports   │
                                             │  & Services     │
                                             └─────────────────┘

API Endpoints

HTTP Endpoints

GET /

Returns the main dashboard HTML page.

GET /api/ports

Retrieves the current list of active ports with details, enabling users to stay informed of their network status effectively.

{
  "ports": [
    {
      "port": 8000,
      "protocol": "tcp",
      "service": "http-alt",
      "process": "python",
      "pid": 12345,
      "status": "LISTEN"
    }
  ]
}

GET /health

Monitors the health status of the application with a simple check.

{
  "status": "healthy",
  "timestamp": "2025-10-18T12:00:00Z"
}

WebSocket Endpoint

WS /ws

Create a WebSocket connection for real-time notifications about port updates. The client maintains an ongoing connection and receives updates every few seconds.

Platform Compatibility

Port Manager is designed to operate across various platforms: macOS, Linux, and Windows, ensuring versatility and broad applicability.

Security Considerations

Port Manager prioritizes security by binding to localhost by default, limiting access to local environments unless configured otherwise. This feature aims to protect sensitive networking data and ensure safe usage.

Contributing

Contributions to the project are encouraged, and potential contributors can easily participate through a structured process. This includes forking the repository, developing features, and submitting pull requests.

Acknowledgments

Port Manager leverages technologies such as FastAPI for backend services and psutil for effective port detection, combining classic network monitoring concepts with a fresh and engaging interface.