# butlerx/wetty

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/butlerx-wetty).**

_How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._

5,321 stars · 758 forks · TypeScript · MIT

## Links

- GitHub: https://github.com/butlerx/wetty
- Homepage: https://butlerx.github.io/wetty
- awesome-repositories: https://awesome-repositories.com/repository/butlerx-wetty.md

## Description

Wetty is an HTTP browser terminal emulator that provides shell access over HTTP and HTTPS connections. It functions as a web-based remote shell and SSH browser gateway, allowing users to execute shell commands on remote hosts directly within a web browser.

The project integrates SAML2 identity propagation to authenticate users through external providers and map those web identities to system accounts. It also supports embedding the terminal interface within iframes for integration into other web applications or dashboards.

The system covers remote server administration and secure terminal proxying, with capabilities for automating user logins, managing server networking, and downloading files from the terminal via escape sequence detection.

The application can be configured to run as a service daemon and supports routing traffic through reverse proxies using custom base paths.

## Tags

### System Administration & Monitoring

- [Browser-Based Remote Shell Access](https://awesome-repositories.com/f/system-administration-monitoring/browser-based-remote-shell-access.md) — Provides a web-based terminal emulator allowing users to access remote server shells via HTTP or HTTPS.
- [Web-Based Terminal Emulators](https://awesome-repositories.com/f/system-administration-monitoring/web-based-terminal-emulators.md) — Provides a complete HTTP browser terminal emulator for executing shell commands on remote hosts. ([source](https://github.com/butlerx/wetty/tree/main/docs))
- [Remote Administration Interfaces](https://awesome-repositories.com/f/system-administration-monitoring/remote-administration-interfaces.md) — Provides a web-based interface for executing administrative commands and managing distant hosts.

### Part of an Awesome List

- [Browser-Based SSH Gateways](https://awesome-repositories.com/f/awesome-lists/devops/reverse-proxies/ssh-gateway-proxies/browser-based-ssh-gateways.md) — Provides a gateway that enables secure SSH connections to remote servers through a web-based interface.
- [Infrastructure and Tools](https://awesome-repositories.com/f/awesome-lists/devops/infrastructure-and-tools.md) — Terminal access via web browser over HTTP.
- [Developer Tools](https://awesome-repositories.com/f/awesome-lists/devtools/developer-tools.md) — Terminal access via web browser over HTTP/HTTPS.

### Graphics & Multimedia

- [Terminal Canvas Renderers](https://awesome-repositories.com/f/graphics-multimedia/html5-canvas-libraries/terminal-canvas-renderers.md) — Renders terminal sequences in the browser using a high-performance canvas-based emulator.

### Networking & Communication

- [HTTP-to-SSH Proxies](https://awesome-repositories.com/f/networking-communication/http-to-ssh-proxies.md) — Provides the fundamental bridge that routes web requests to a backend SSH client for remote host access.
- [Stream Multiplexing](https://awesome-repositories.com/f/networking-communication/peer-to-peer-streaming/stream-multiplexing.md) — Uses a persistent WebSocket connection to multiplex bidirectional terminal input and output streams.
- [Remote Server Connectivity](https://awesome-repositories.com/f/networking-communication/remote-server-connectivity.md) — Enables the establishment of secure shell connections to distant servers using specified credentials and ports. ([source](https://cdn.jsdelivr.net/gh/butlerx/wetty@main/README.md))
- [SSH Client Connections](https://awesome-repositories.com/f/networking-communication/ssh-client-connections.md) — Provides the ability to start SSH sessions with local or remote machines via hostname and user identity. ([source](https://butlerx.github.io/wetty/flags))
- [URL-Based Session Parameters](https://awesome-repositories.com/f/networking-communication/remote-access-control/url-based-session-parameters.md) — Allows specifying destination hosts, ports, and working directories directly through URL parameters for streamlined access. ([source](https://butlerx.github.io/wetty/flags))
- [Remote File Downloads](https://awesome-repositories.com/f/networking-communication/remote-file-downloads.md) — Triggers browser-side file downloads by detecting specific escape sequences in the terminal data stream. ([source](https://butlerx.github.io/wetty/downloading-files))
- [Proxy Traffic Management](https://awesome-repositories.com/f/networking-communication/traffic-proxying/proxy-traffic-management.md) — Supports routing traffic through reverse proxies to ensure secure access and custom base paths. ([source](https://butlerx.github.io/wetty/nginx))

### Security & Cryptography

- [SAML2 Identity Propagation](https://awesome-repositories.com/f/security-cryptography/identity-provider-integrations/saml2-identity-propagation.md) — Integrates SAML2 identity propagation to authenticate users via external providers and map them to system accounts.
- [SSL/TLS Connection Security](https://awesome-repositories.com/f/security-cryptography/ssl-tls-connection-security.md) — Implements SSL/TLS encryption for the transport layer between the browser and the server to protect terminal data. ([source](https://butlerx.github.io/wetty/https))
- [Web-to-System](https://awesome-repositories.com/f/security-cryptography/user-authentication-strategies/identity-mapping/web-to-system.md) — Authenticates users through SAML2 providers to map web identities directly to system accounts.
- [Identity Authentication](https://awesome-repositories.com/f/security-cryptography/identity-authentication.md) — Integrates SAML2 for single sign-on and session-based authentication through external identity providers. ([source](https://butlerx.github.io/wetty/apache))
- [Identity Header Injections](https://awesome-repositories.com/f/security-cryptography/user-identity-management/identity-header-injections.md) — Injects SAML2-validated user identities into HTTP headers to map web identities to system usernames.

### Web Development

- [PTY Bridges](https://awesome-repositories.com/f/web-development/terminal-layout-engines/node-js-terminal-frameworks/pty-bridges.md) — Uses a PTY bridge to spawn pseudo-terminal processes on the server and capture their output for the browser.
- [Web-Based Terminal Emulators](https://awesome-repositories.com/f/web-development/web-based-terminal-emulators.md) — Serves a fully interactive terminal emulator directly to web browsers over HTTP and HTTPS. ([source](https://cdn.jsdelivr.net/gh/butlerx/wetty@main/README.md))
- [Iframe Integration](https://awesome-repositories.com/f/web-development/embedded-terminal-environments/iframe-integration.md) — Supports embedding the terminal interface within iframes for integration into other web applications or dashboards.

### DevOps & Infrastructure

- [Reverse Proxies with Integrated Security](https://awesome-repositories.com/f/devops-infrastructure/reverse-proxies/reverse-proxies-with-integrated-security.md) — Acts as a secure gateway that routes encrypted terminal traffic through a reverse proxy.