A tool to share the contents of your terminal over the web
Project description
# termcast
termcast exists to make it absolutely trivial to stream the contents of your current terminal session over the web, so that friends/collaborators/students can follow along as you grep logs, configure a webserver, play nethack, whatever :)
![](https://raw.githubusercontent.com/lampholder/termcast/master/termcast.gif)
## How do I get it?
You can either git clone this repo and run the cli/termcast.py script, or (preferably) use pip. [If you don’t have pip, follow the instructions to get it here](https://pip.pypa.io/en/stable/installing/). You’ll also need to install tmux if you don’t have it already:
$ sudo apt-get install tmux $ pip install termcast –user
## How does it work?
It leverages a bunch of existing unix gubbins (script, tmux, named pipes) + python and websockets and a node js server to plug it all together.
Tmux is in the mix because:
It has a status bar that can be configured to show useful things
It supports specifying the dimensions of your terminal (independently of the window size)
## Current state:
The pip termcast only works on python >= 2.7.9 because earlier versions can’t support SNI :(
termcast is in alpha but the happy path is actually working pretty well. There are still some issues, but they mostly pertain to the running of the server.
Relying on my server running at termcast.me for mission critical procedures is… not recommended. The server is currently a Single Point of Failure, and could go down at any time.
## Usages of the installed script
$ termcast will launch a new session identified with a dictionary word randomly selected
$ termcast –width <width_in_columns> –height <height_in_rows> will initiate a session with specified dimensions
$ termcast –session <session_id> –token <session_token> will reconnect to an existing session
Remember - viewers will see your terminal stretched to fit the size of their browser window, so very small/very large terminals could look pretty ugly.
## Can I see it in action?
(Hopefully) an instance is up-and-streaming on: https://termcast.me/store
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for termcast-0.1a13-py2.py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 4206f2346a609a895d8b7fafcaa77083dcd0432202da0fdfb9f26490b2c28275 |
|
MD5 | 6dd59dfd8dcc37bf637568a5e18d4709 |
|
BLAKE2b-256 | 67655c9ff823645eeea047e222d2260fb050eae95e3c37d97478981f1f5f9f04 |