+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.
+
+
+
+| Sub-command |
+Description |
+
+
+
+
+adduser |
+Add/update an authenticated user with their password |
+
+
+deluser |
+Delete an authenticated user |
+
+
+listusers |
+List all the authenticated users |
+
+
+replay |
+Replay a recorded session (set your terminal to 120x36 first) |
+
+
+merge |
+Merge several recorded sessions into one session |
+
+
+run |
+Run a specified CLI program when user connects with browser |
+
+
+
+Some sub-commands have options. Use -h to find out more. e.g.,
+$ ./witty run -h
+Usage of run:
+ -n Run WiTTY without user authentication
+ -naked
+ Run WiTTY without user authentication
+ -p uint
+ Port number to listen on (default 8080)
+ -port uint
+ Port number to listen on (default 8080)
+ -w uint
+ Max wait time between outputs (default 1000)
+ -wait uint
+ Max wait time between outputs (default 1000)
+
+User Authentication
+#
+
+WiTTY uses username/password based authentication. The user database is stored in user.db under the main directory of WiTTY. The passwords are salted with 64 bytes of random characters and then hashed using SHA256. In addition, passwords must be 12 bytes or longer. WiTTY provides three sub-commands to manage user.db.
+
+witty adduser <username>witty deluser <username>witty listusers
+They are pretty self-explanatory. Just follow the instructions on screen.
+
+Web Interface (witty run)
+#
+
+The web interface of WiTTY is mostly self-explanatory. After login, the user is presented with the main interface, as shown in this screenshot:
+
+There are two tabs that list live and recorded sessions, respectively. You can click New Session to create a new interactive session, which opens in a new browser tab. The main window will list the newly created interactive session similar to the follows:
+
+WiTTY randomly names an interactive session as its unique ID. You can click the 
icon of an interactive session to open a read-only view of that session.
+On the interactive terminal window, you can record an ongoing session by clicking the record button.
+
+After a session has been recorded, the main window’s Recorded Sessions will list the records, as shown below. You can replay 
, download 
, rename 
, and delete 
recorded sessions.
+
+Here is a screencast where we replay a recorded session that updates the pi-hole system. You can fully control the playback using the progress bar. Clicking on the progress bar stops the replay and fast-forwards (or fast-backwards) the screen to that location. You can scroll the screen to view the history when replay is stopped or resume the replay.
+
+
+
