Install / Update
Note: If Go is already installed, will use the currently installed version to install
termbacktime. There is now an install script for Linux, Darwin, and Windows 10 using WSL. This will attempt to install the latest version of Go, defaulting back to 1.14. For other distributions please see the releases page. Go will be installed in
$GOPATHis set to
curl -s -L https://termbackti.me/install.sh | bash
To install a different version of Go:
wget https://termbackti.me/install.sh ./install.sh <version>
1.14.12 would be
If you already have Go installed, you can manually install:
go get -u louist.dev/termbacktime cd $GOPATH/src/louist.dev/termbacktime make install
In order to submit recordings to Gist you must first authorize TermBackTime with GitHub.
We request access to the
gist scopes. For more information, please see available scopes.
You can request an auth token from ~/auth or by running the following terminal command:
- GitHub authorization is NOT required for live terminal sharing.
After authorizing TermBackTime with GitHub simply run
termbacktime record to start recording!
termbacktime --help for more options.
Live terminal sharing (BETA)
To start sharing your terminal over the web via WebRTC, simply run
termbacktime live and give the provided link to someone. Please see
termbacktime live --help for more options.
- This uses a broker server via WebSockets to handle signaling. Once the data channel via WebRTC is established the WebSocket connection is closed.
For now TermBackTime uses Google’s STUN servers unless changed at compile time.
STUNServerOne = "stun:stun1.l.google.com:19302" STUNServerTwo = "stun:stun2.l.google.com:19302"
A STUN server is used to detect network addresses. Please see https://en.wikipedia.org/wiki/STUN for more information.
- Use an official TURN server provided by TermBackTime:
- Provide your own TURN server credentials:
termbacktime live --turn <username>:<password>@<server>[:<port>]
termbacktime live --user <username> --password <password> --addr <server>[:<port>]
- Attempt to share without any TURN server:
termbacktime live --no-turn
A TURN server is used to relay WebRTC data between clients. Please see https://webrtc.org/getting-started/turn-server for more information.
You can build your own development builds via
make build-dev or
I provide development server endpoints for playback + live terminal, login, and WebRTC signaling at:
Please note that these endpoints are under active development and may change or be unavailable at any time.