gotty and tmux - Easily share terminal screen in browser

README.md

Share your screen in a browser witih tmux and gotty

Gotty is really nice, allowing you to share your terminal in a browser.

I had never wanted to do that until I realized that the only thing I ever share in a video conference is:

1. terminal
2. browser window.

I don't share my whole screen, because I don't want you seeing the notifications of new cat videos on youtube and you probably would not appreciate the full 4880x2560 screen.

linux screen sharing with wayland is painful, requiring you to click some 8 times in order to change the window your sharing.

So... its nice to just share a browser window and switch in between tabs easily.

How to do it

1. Run a systemd unit (or run gotty somehow)
2. open http://127.1.1.1:9999 in your browser
3. Type right into your browser window, or attach to that tmux session in a terminal with tmux a -t browser-share

See the tmux-in-browser.service file below for my systemd unit.

custom tmux config for browser-share

Also, I have a custom tmux config for that session so I'll notice if I'm attached to it.

My tmux.conf has:

set  -g status-style bg=green,fg=black
setw -g window-status-current-style bg=cyan

set-hook -g after-new-session {
  if-shell '[ "#{session_name}" = "browser-share" ]' {
    set  -g status-style bg=blue,fg=black
    setw -g window-status-current-style bg=lightblue
  }
}

gotty colors

There are some PRs open in gotty to change colors, but I have not tried them. The dark/black is different than my default solarized-dark, and when I run vim inside it it doesnt share well.

To address that I have a vib (vi-black) in my ~/bin/ that just has:

#!/bin/sh
exec vi -c "colorscheme molokai" "$@"

tmux-in-browser.service

# ~/.config/systemd/user/tmux-in-browser.service
[Unit]
Description=Run tmux in browser / gotty
# gotty will run 'tmux new-session -A -s browser-share'
# which attaches or creates 'browser-share'
# so you can attach to same one with: tmux a -t browser-share

[Service]
Type=simple
ExecStart=%h/go/bin/gotty --permit-write --address=127.1.1.1 --port=9999 tmux new-session -A -s browser-share

[Install]
WantedBy=default.target