portforwarder
TUI for managing SSH port forwarding tunnels, built with Textual.
Install
uvx install portforwarder
or
pipx install portforwarder
Dev Run (no install)
uv run python -m portforwarder
Usage
portforwarder
Keybindings
| Key | Action |
|---|---|
Space / Enter |
Toggle selected tunnel on/off |
a |
Add new tunnel |
e |
Edit selected tunnel |
d |
Delete selected tunnel |
q |
Quit |
Configuration
All tunnels are saved to ~/.port-forward/config.json. Each entry has:
- Name — display label
- Local Port — port on your machine
- Remote Host — SSH destination (
user@host) - Target Host — host to reach from the remote side
- Remote Port — port on the target host
The SSH command run is:
ssh -N -L <local_port>:<target_host>:<remote_port> <remote_host>
Port Collision
Turning on a tunnel with the same local port as an active one will auto-stop the old tunnel and start the new one. All tunnels are stopped when the TUI closes.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
portforwarder-1.1.0.tar.gz
(9.5 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file portforwarder-1.1.0.tar.gz.
File metadata
- Download URL: portforwarder-1.1.0.tar.gz
- Upload date:
- Size: 9.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
067ac2ac8fe6de16ad3cdf8bc6a875d93f05ef5476a9e3c918740711c1352d30
|
|
| MD5 |
53022bdb4dcf6ea828beb5d1641694af
|
|
| BLAKE2b-256 |
a0b02316566b11747b91e73e799bcc2b9cea405c4189def96b5d8028bf180e2a
|
File details
Details for the file portforwarder-1.1.0-py3-none-any.whl.
File metadata
- Download URL: portforwarder-1.1.0-py3-none-any.whl
- Upload date:
- Size: 9.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.12.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
eb7bab0db6a5c4a0f416e7d1fe71f36e9ebe5ee0104ea079c4986d9540b6cf2a
|
|
| MD5 |
b120c354b74c0ebd8105ab208ed5d450
|
|
| BLAKE2b-256 |
c7b7f2a1c24693e714f79f670a9b56a21e659223900eadbdeff65f1687a5cddf
|
