+
About WiTTY
#
-
+
About WiTTY # -
WiTTY is written in the go programming language, using the Gin web framework, gorilla/websocket, pty, and the wonderful xterm.js! The workflow is simple, the client initiates a terminal @@ -97,11 +93,7 @@ window (xterm.js) and creates a websocket with the server, which relays the data diff --git a/docs/docs/hidden/index.html b/docs/docs/hidden/index.html deleted file mode 100644 index 500d285..0000000 --- a/docs/docs/hidden/index.html +++ /dev/null @@ -1,157 +0,0 @@ - -
- - - - - - - - --This page is hidden in menu -# -
--Quondam non pater est dignior ille Eurotas -# -
--Latent te facies -# -
-Lorem markdownum arma ignoscas vocavit quoque ille texit mandata mentis ultimus, -frementes, qui in vel. Hippotades Peleus pennas -conscia cuiquam Caeneus quas.
--
-
- Pater demittere evincitque reddunt -
- Maxime adhuc pressit huc Danaas quid freta -
- Soror ego -
- Luctus linguam saxa ultroque prior Tatiumque inquit -
- Saepe liquitur subita superata dederat Anius sudor -
-Cum honorum Latona -# -
-O fallor in sustinui -iussorum equidem. -Nymphae operi oris alii fronde parens dumque, in auro ait mox ingenti proxima -iamdudum maius?
-reality(burnDocking(apache_nanometer),
- pad.property_data_programming.sectorBrowserPpga(dataMask, 37,
- recycleRup));
-intellectualVaporwareUser += -5 * 4;
-traceroute_key_upnp /= lag_optical(android.smb(thyristorTftp));
-surge_host_golden = mca_compact_device(dual_dpi_opengl, 33,
- commerce_add_ppc);
-if (lun_ipv) {
- verticalExtranet(1, thumbnail_ttl, 3);
- bar_graphics_jpeg(chipset - sector_xmp_beta);
-}
-
--Fronde cetera dextrae sequens pennis voce muneris -# -
-Acta cretus diem restet utque; move integer, oscula non inspirat, noctisque -scelus! Nantemque in suas vobis quamvis, et labori!
-var runtimeDiskCompiler = home - array_ad_software;
-if (internic > disk) {
- emoticonLockCron += 37 + bps - 4;
- wan_ansi_honeypot.cardGigaflops = artificialStorageCgi;
- simplex -= downloadAccess;
-}
-var volumeHardeningAndroid = pixel + tftp + onProcessorUnmount;
-sector(memory(firewire + interlaced, wired));
-
+
Installation
#
-
-Installation # -
WiTTY runs on Linux (ARM and x86), macOS, and WSl (Windows subsystem for Linux, basically Linux). You can install from the pre-built binary or from the source code.
+ +WiTTY runs on Linux (ARM and x86), macOS, and WSL2 (Windows subsystem for Linux, basically Linux). You can install from the pre-built binary or from the source code.
-
@@ -99,7 +93,10 @@ Installation
-
Decompress the binary with the following command at selected location.
-
+tar -xzvf releasevxxx_xxx.tar.gz
+tar -xzvf witty_vx.x.x_xxx.tar.gz
+
For example, use
+tar -xzvf witty_v1.1.1_linux_amd64.tar.gz
to decompress release v1.1.1 for Linux on AMD64.
+
Post-installation Configuration
#
-
+
-
WiTTY uses TLS to protect its traffic. You can request a free Let’s Encrypt cert or use a self-signed cert. Here is how to create a self-signed cert in the
@@ -160,10 +157,10 @@ WiTTY normally listens on port 8080. It can be overridden with thetls
sub-directory:-p/-por
https://<witty_server_ip>:8080
+
Example Use Case
#
-
+
WiTTY doesn’t support Windows because Windows doesn’t have PTY. You can still use WiTTY to access Windows terminal through a proxy.
Here is how to do it. We can run WiTTY on a Raspberry Pi running Raspbian (at address 192.168.1.2
). When a user connects via browser to https://192.168.1.2:9000
, WiTTY will start a new ssh
session to the Windows machine (at address 192.168.1.3
) running a SSH server. The command to run WiTTY on the RPI is as follows:
./witty run -p 9000 ssh 192.168.1.3 -l user_name
runs SSH server ] diff --git a/docs/docs/record/index.html b/docs/docs/record/index.html index c532dd3..2551729 100644 --- a/docs/docs/record/index.html +++ b/docs/docs/record/index.html @@ -17,7 +17,7 @@ WiTTY provides two sub-commands to merge and replay recorded sessions."> - + diff --git a/docs/docs/ui/index.html b/docs/docs/ui/index.html index 8e110b2..9851ed5 100644 --- a/docs/docs/ui/index.html +++ b/docs/docs/ui/index.html @@ -15,7 +15,7 @@ - + @@ -66,19 +66,13 @@ -
+
Sub-commands
#
-
+
Sub-commands # -
Similar to git
and apt
, WiTTY uses sub-commands for its various functions. WiTTY currently supports the following sub-commands: adduser
, deluser
, listusers
, replay
, merge
, run
.