Adding upstream version 1.7.4.upstream/1.7.4

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 105 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e5f7146
--- /dev/null
+++ b/README.md
@@ -0,0 +1,105 @@
+![backend](https://github.com/tsl0922/ttyd/workflows/backend/badge.svg)
+![frontend](https://github.com/tsl0922/ttyd/workflows/frontend/badge.svg)
+[![GitHub Releases](https://img.shields.io/github/downloads/tsl0922/ttyd/total)](https://github.com/tsl0922/ttyd/releases)
+[![Docker Pulls](https://img.shields.io/docker/pulls/tsl0922/ttyd)](https://hub.docker.com/r/tsl0922/ttyd)
+[![Packaging status](https://repology.org/badge/tiny-repos/ttyd.svg)](https://repology.org/project/ttyd/versions)
+![GitHub](https://img.shields.io/github/license/tsl0922/ttyd)
+
+# ttyd - Share your terminal over the web
+
+ttyd is a simple command-line tool for sharing terminal over the web.
+
+![screenshot](https://github.com/tsl0922/ttyd/raw/main/screenshot.gif)
+
+# Features
+
+- Built on top of [libuv](https://libuv.org) and [WebGL2](https://developer.mozilla.org/en-US/docs/Web/API/WebGL_API) for speed
+- Fully-featured terminal with [CJK](https://en.wikipedia.org/wiki/CJK_characters) and IME support
+- [ZMODEM](https://en.wikipedia.org/wiki/ZMODEM) ([lrzsz](https://ohse.de/uwe/software/lrzsz.html)) / [trzsz](https://trzsz.github.io) file transfer support
+- [Sixel](https://en.wikipedia.org/wiki/Sixel) image output support ([img2sixel](https://saitoha.github.io/libsixel) / [lsix](https://github.com/hackerb9/lsix))
+- SSL support based on [OpenSSL](https://www.openssl.org) / [Mbed TLS](https://github.com/Mbed-TLS/mbedtls)
+- Run any custom command with options
+- Basic authentication support and many other custom options
+- Cross platform: macOS, Linux, FreeBSD/OpenBSD, [OpenWrt](https://openwrt.org), Windows
+
+> ❤ Special thanks to [JetBrains](https://www.jetbrains.com/?from=ttyd) for sponsoring the opensource license to this project.
+
+# Installation
+
+## Install on macOS
+
+- Install with [homebrew](http://brew.sh): `brew install ttyd`
+- Install with [MacPorts](https://www.macports.org): `sudo port install ttyd`
+
+## Install on Linux
+
+- Binary version (recommended): download from the [releases](https://github.com/tsl0922/ttyd/releases) page
+- Install the snap: `sudo snap install ttyd --classic`
+- Build from source (debian/ubuntu):
+    ```bash
+    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
+    ```
+    You may also need to compile/install [libwebsockets](https://libwebsockets.org) from source if the `libwebsockets-dev` package is outdated.
+- Install on OpenWrt: `opkg install ttyd`
+- Install on Gentoo: clone the [repo](https://bitbucket.org/mgpagano/ttyd/src/master) and follow the directions [here](https://wiki.gentoo.org/wiki/Custom_repository#Creating_a_local_repository).
+
+## Install on Windows
+
+- Binary version (recommended): download from the [releases](https://github.com/tsl0922/ttyd/releases) page
+- Install with [Scoop](https://scoop.sh/#/apps?q=ttyd&s=2&d=1&o=true): `scoop install ttyd`
+- [Compile on Windows](https://github.com/tsl0922/ttyd/wiki/Compile-on-Windows)
+
+# Usage
+
+## Command-line Options
+
+```
+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
+```
+
+Read the example usage on the [wiki](https://github.com/tsl0922/ttyd/wiki/Example-Usage).
+
+## Browser Support
+
+Modern browsers, See [Browser Support](https://github.com/xtermjs/xterm.js#browser-support).
+
+## Alternatives
+
+* [Wetty](https://github.com/krishnasrinivas/wetty): [Node](https://nodejs.org) based web terminal (SSH/login)
+* [GoTTY](https://github.com/yudai/gotty): [Go](https://golang.org) based web terminal