Skip to content
Shuanglei Tao edited this page Oct 30, 2022 · 12 revisions

ttyd has a mechanism to pass server side command-line arguments to the browser page which is called client options:

-t, --client-option     Send option to client (format: key=value), repeat to add more options

Basic usage

  • -t rendererType=canvas: use the canvas renderer for xterm.js (default: webgl)
  • -t disableLeaveAlert=true: disable the leave page alert (#294)
  • -t disableResizeOverlay=true: disable the terminal resize overlay (#446)
  • -t disableReconnect=true: prevent the terminal from reconnecting on connection error/close (#478)
  • -t enableZmodem=true: enable ZMODEM integration with lrzsz support
  • -t enableSixel=true: enable Sixel image output support (Usage)
  • -t titleFixed=hello: set a fixed title for the browser window (#133)
  • -t fontSize=20: change the font size of the terminal

Advanced usage

You can use the client option to change all the settings of xterm defined in ITerminalOptions, examples:

  • -t cursorStyle=bar: set cursor style to bar
  • -t lineHeight=1.5: set line-height to 1.5
  • -t 'theme={"background": "green"}': set background color to green

to try the example options above, run:

ttyd -t cursorStyle=bar -t lineHeight=1.5 -t 'theme={"background": "green"}' bash
Clone this wiki locally