pytu

---

Python tunneler. A simple Python-based application to manage existing SSH tunnels using PyQt5.

📝 Table of Contents

• About
• Getting Started
• Usage
• Deployment
• Built Using
• Authors

🚀 About

Tunnel Manager is a Python application that provides a user interface for Windows to manage SSH tunnels conveniently. It allows users to start, stop, and monitor SSH tunnels easily.

🏁 Getting Started

To get a copy of the project up and running on your local machine, follow these steps:

Prerequisites

Windows 10+ (just tested it on 11 so far).
Ensure you have Python 3.x installed on your system.
Have the SSH connections already set up and configured.

💻 Installation

Clone the repository:

git clone https://github.com/tf4482/pytu.git

Navigate to the project directory:

cd pytu

Install the required dependencies:

pip install -r requirements.txt

🔧 Configuration

Define your connections in pytu.json

{
    "tunnels": [
      {
        "name": "Tunnel to Ubuntu on Homeserver",
        "ssh": {
          "port": 22,
          "options": ["-f", "-N"],
          "forwardings": [
            {
              "local_port": 81,
              "remote_host": "localhost",
              "remote_port": 80
            },
            {
              "local_port": 8081,
              "remote_host": "localhost",
              "remote_port": 8080
            },
            {
              "local_port": 8096,
              "remote_host": "localhost",
              "remote_port": 8096
            }
          ],
          "user": "username",
          "host": "192.168.0.1"
        }
      },
      
      […]

🎈 Usage

To use the application, simply run the Python script pytu.py. This will launch the Tunnel Manager user interface, where you can start, stop, and monitor SSH tunnels.

🏗️ Deployment

For deploying this application on a live system, you can follow standard Python deployment procedures.

⛏️ Built Using

• Python - Programming Language
• PyQt5 - GUI Framework
• psutil - Process Utilities
• subprocess - Subprocess Management

📸 Screenshots

✍️ Authors

• @tf4482 - Developer

📜 License

Distributed under the MIT License. See LICENSE for more information.

Project Link: https://github.com/tf482/pytu Project Link: https://github.com/tf482/pytu