ttyd - terminal emulator for the web

ttyd is a simple command line tool for sharing terminal over the web, inspired by GoTTY.

WARNING: ttyd is still under heavily development, so features may be incomplete or expected to have bugs.

Requirements

• CMake
• OpenSSL
• JSON-C
• Libwebsockets

Installation

For Mac OS X users

brew install cmake openssl json-c libwebsockets
git clone https://github.com/tsl0922/ttyd.git
cd ttyd && mkdir build && cd build
cmake -DOPENSSL_ROOT_DIR=/usr/local/opt/openssl ..
make

For Linux users

Ubuntu as example:

sudo apt-get install cmake libwebsockets-dev libjson-c-dev libssl-dev
git clone https://github.com/tsl0922/ttyd.git
cd ttyd && mkdir build && cd build
cmake ..
make

The ttyd executable file will be in the build directory.

Usage

Usage: ttyd command [options]

ttyd will start a web server at port 7681. When you open http://localhost:7681, the command will be started with options as arguments and now you can see the running command on the web! 🎉

Credits

• GoTTY: ttyd is a port of GoTTY to C language.
• hterm: ttyd uses hterm to run a terminal emulator on the web.