ttyd is a simple command-line tool for sharing terminal over the web.
- Built on top of libuv and WebGL2 for speed
- Fully-featured terminal with CJK and IME support
- ZMODEM (lrzsz) / trzsz file transfer support
- Sixel image output support (img2sixel / lsix)
- SSL support based on OpenSSL / Mbed TLS
- Run any custom command with options
- Basic authentication support and many other custom options
- Cross platform: macOS, Linux, FreeBSD/OpenBSD, OpenWrt, Windows
❤ Special thanks to JetBrains for sponsoring the opensource license to this project.
- Binary version (recommended): download from the releases page
- Install the snap:
sudo snap install ttyd --classic - Build from source (debian/ubuntu):
You may also need to compile/install libwebsockets from source if the
sudo apt-get update sudo apt-get install -y build-essential cmake git libjson-c-dev libwebsockets-dev git clone https://github.com/tsl0922/ttyd.git cd ttyd && mkdir build && cd build cmake .. make && sudo make install
libwebsockets-devpackage is outdated. - Install on OpenWrt:
opkg install ttyd - Install on Gentoo: clone the repo and follow the directions here.
- Binary version (recommended): download from the releases page
- Install with Scoop:
scoop install ttyd - Compile on Windows
USAGE:
ttyd [options] <command> [<arguments...>]
OPTIONS:
-p, --port Port to listen (default: 7681, use `0` for random port)
-i, --interface Network interface to bind (eg: eth0), or UNIX domain socket path (eg: /var/run/ttyd.sock)
-U, --socket-owner User owner of the UNIX domain socket file, when enabled (eg: user:group)
-c, --credential Credential for basic authentication (format: username:password)
-H, --auth-header HTTP Header name for auth proxy, this will configure ttyd to let a HTTP reverse proxy handle authentication
-u, --uid User id to run with
-g, --gid Group id to run with
-s, --signal Signal to send to the command when exit it (default: 1, SIGHUP)
-w, --cwd Working directory to be set for the child program
-a, --url-arg Allow client to send command line arguments in URL (eg: http://localhost:7681?arg=foo&arg=bar)
-W, --writable Allow clients to write to the TTY (readonly by default)
-t, --client-option Send option to client (format: key=value), repeat to add more options
-T, --terminal-type Terminal type to report, default: xterm-256color
-O, --check-origin Do not allow websocket connection from different origin
-m, --max-clients Maximum clients to support (default: 0, no limit)
-o, --once Accept only one client and exit on disconnection
-B, --browser Open terminal with the default system browser
-I, --index Custom index.html path
-b, --base-path Expected base path for requests coming from a reverse proxy (eg: /mounted/here, max length: 128)
-P, --ping-interval Websocket ping interval(sec) (default: 5)
-6, --ipv6 Enable IPv6 support
-S, --ssl Enable SSL
-C, --ssl-cert SSL certificate file path
-K, --ssl-key SSL key file path
-A, --ssl-ca SSL CA file path for client certificate verification
-d, --debug Set log level (default: 7)
-v, --version Print the version and exit
-h, --help Print this text and exit
-x, --hexdump Enable hex+ascii dump of input/output
Read the example usage on the wiki.
Modern browsers, See Browser Support.
A debug flag -x is added for showing data traffic through ttyd. The data is shown as hex and ASCII.
Used to understand why ZMODEM file transfer did not work when ttyd is used together with a serial device. Based on this I developed a simple serial tty device to STDIO connector. hansake/serport: Connects serial tty device to STDIO. To be used with ttyd.
ttyd --hexdump --writable -t enableZmodem=true -p 7680 -t fontSize=16 -w /home/hal serport -b 9600 /dev/ttyUSB0
When using this debug command I discovered that the ZMODEM protocol sent data byte by byte which did not work very well with the zmodem.js implementation used in ttyd.