You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Erik Hollensbe 1bb018ba99 README.md: link to video 5 years ago
Godeps Godeps: introducing godeps to this project 5 years ago
dockerterm update dockerterm to keep in sync with the latest master 5 years ago
server server,winch.go: fix a resizing bug which would happen if the client grows the window then shrinks it 5 years ago
termproxy termproxy: do not wait to clear the screen, just spit our message out and bail 5 years ago
.gitignore Makefile,.gitignore,dist.sh: distribute naked .bz2 files instead of tarballs of a single binary 5 years ago
Dockerfile Dockerfile: ensure go 1.5, use host key properly with the new changes 5 years ago
Makefile Makefile,.gitignore,dist.sh: distribute naked .bz2 files instead of tarballs of a single binary 5 years ago
README.md README.md: link to video 5 years ago
VERSION Version 0.1.1 5 years ago
dist.sh Makefile,.gitignore,dist.sh: distribute naked .bz2 files instead of tarballs of a single binary 5 years ago
handlers.go go-gettable again 5 years ago
main.go main.go: make the listen directive optional via the --listen/-l flags. 5 years ago
winch.go server,winch.go: fix a resizing bug which would happen if the client grows the window then shrinks it 5 years ago

README.md

termproxy: share a program with others (for pairing!)

termproxy is a shared program tool. It allows you to start the program of your choice (a shell, vim/emacs, etc) and allows others to connect and interact with it via SSH. The intended use case is pairing.

See it in action

Features

  • Share a terminal with your friends or collagues over SSH.
    • start any program -- when it exits, it will terminate the SSH server too.
    • Terminals are resized to fit everyone's terminal on a new connection.
  • Notifications on connection (set -n=false to disable).
  • Read-only mode for connectors: -r
    • present a terminal to others instead of sharing it with them.

Try quickly with Docker

$ docker run -p 1234:1234 -it erikh/termproxy

(in another window)

$ ssh -p 1234 scott@localhost

Note that the standard SSH connection termination sequence is ~.. You can enter this on the SSH side to disconnect from termproxy without stopping the shared program.

Installation

See our releases.

Usage

Server (presumes default settings):

termproxy <program>

Client:

ssh -p <port> scott@host
# password is 'tiger'

There are also options to change the default username -u and password -p, the default of which is scott/tiger.

Author

Erik Hollensbe erik@hollensbe.org

This code also uses a vendored copy of docker/docker's pkg/term to provide the termios support. It is located in the dockerterm directory. This was done to ensure stability of the package.