Run bridge.py locally to launch a browser-based file manager, editor, and terminal for any remote server.
bridge.py is a lightweight local HTTP bridge. It starts a server on your machine, serves the web interface, and proxies all SFTP and SSH commands through your system's OpenSSH client. No Python packages required.
app.html is the web interface. Connect to remote servers with a private key or password, then browse files, edit code with syntax highlighting, change permissions, rename, delete, upload, download, and run shell commands via an embedded terminal.
Place both files in the same folder. bridge.py will automatically locate and serve app.html.
Place bridge.py and app.html in the same folder. Open Terminal and run:
The script picks a free port, starts the server, and opens your browser automatically. The terminal window must stay open while you use the tool.
Do not open app.html directly. It is served automatically by bridge.py. Once the bridge is running, the interface loads at http://127.0.0.1:PORT/.
Enter your remote host, username, port (default 22), and private key or password to connect. The first connection is normal speed; all subsequent operations reuse the SSH master connection for near-instant response.
Place both files in the same folder. Open Command Prompt or PowerShell and run:
The server starts and opens your default browser automatically. Keep the window open.
Served automatically by bridge.py. Once running, use the web UI to connect to your remote server with a key file or password. Connection multiplexing is disabled on Windows, so each operation opens a fresh SSH session.
Place both files in the same directory. Run from a terminal:
The server binds to 127.0.0.1 on a random high port and auto-opens your browser. Leave the terminal running.
Served by bridge.py. Connect via the web UI using your SSH credentials. The bridge uses SSH connection multiplexing on Linux and macOS for fast repeated operations.
Verify the remote host is reachable and port 22 (or your custom port) is open. Check that your private key is in OpenSSH format and that the remote server accepts key authentication. If using a password, ensure password auth is enabled on the server.
Install the OpenSSH client for your platform. On Windows, enable it in Settings / Apps / Optional Features. On Linux, install openssh-client.
bridge.py automatically scans for a free port in the 49152-65535 range. If it cannot find one, close other local servers and try again.
Check the terminal output for the local URL (e.g., http://127.0.0.1:54231/) and open it manually.