Live terminal broadcast

curl -sLowget -qO shellshare && python shellshare

What is it?

Shellshare allows you to broadcast your terminal live with a single command.

How to use?

Open a terminal and write:

$ curl -sLowget -qO shellshare
$ python shellshare
Sharing terminal in
$ # Everything you do now will be broadcast live on the URL above.
$ # When you're done, hit CTRL+D
$ exit
End of transmission.

Supported platforms

It has been tested on Ubuntu 20.04, Mac OS X and Windows, but it should work on any platform that has Python and script. If it doesn't work on your system, please let me know.

Frequently asked questions

Can someone control my terminal through shellshare?

No. All communication is just one-way: from your terminal to shellshare. There's no way someone could send commands to your terminal. If you'd like to allow it, try screen or tmux (specially with tmate).

Can I save the broadcast?

No. Shellshare was made only for live broadcasts. If you'd like to save your terminal, try

Can I broadcast to a custom room name?

Yes. You can broadcast to a named room secured with a password by calling shellshare as:

$ curl -sLowget -qO shellshare
$ python shellshare --room MY-ROOM --password MY-PASS
Sharing terminal in
$ # ...
$ exit
End of transmission.
If you don't set a password, shellshare will use your network card's MAC address to uniquely identify your computer. This means you'll be able to transmit to the same room later only if you're using the same computer.

Can I recover the password to a custom room?

No. However, the rooms are deleted after a day of inactivity, so you can recreate it in 24 hours.

Can I install shellshare from my package manager?

We currently have a shellshare package on Homebrew only. If you use Homebrew, you can install shellshare using:

brew install shellshare
If you'd like to contribute, we have an open issue to create a Debian package.

Can I run shellshare on Windows?

Yes. On the first time shellshare runs, it will download the required dependency into .shellshare/script.exe in your user's home folder. This executable will be used in the next times you run shellshare.

I found a problem! What do I do?

Please, open an issue at our issues page describing what the problem was, your shellshare version, and your operating system.

How can I help?

Great! Any help is appreciated. Check out the code on GitHub and the issues page. If you find anything that could be improved, go ahead, create an issue and send me a pull request.