shellshare: live terminal broadcast


            curl -sLo shellshare https://get.shellshare.net/?os=mac && chmod +x shellshare && ./shellshare
            wget -qO shellshare https://get.shellshare.net/?os=linux && chmod +x shellshare && ./shellshare
            iwr https://get.shellshare.net/?os=windows -OutFile shellshare.exe; .\shellshare.exe

What is it?

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

How to use?

Open a terminal and write:

$ curl -sLo shellshare https://get.shellshare.net/?os=mac
$ chmod +x shellshare
$ ./shellshare$ wget -qO shellshare https://get.shellshare.net/?os=linux
$ chmod +x shellshare
$ ./shellsharePS> iwr https://get.shellshare.net/?os=windows -OutFile shellshare.exe
PS> .\shellshare.exe
Sharing terminal in https://shellshare.net/r/EPbZJ7VZNakS9vwUlS
$ # Everything you do now will be broadcast live on the URL above.
$ # When you're done, hit CTRL+D
$ exitPS> # Everything you do now will be broadcast live on the URL above.
PS> # When you're done, hit CTRL+D
PS> exit
End of transmission.

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 asciinema.org.

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 -sLo shellshare https://get.shellshare.net/?os=mac
$ chmod +x shellshare && ./shellshare --room MY-ROOM --password MY-PASS$ wget -qO shellshare https://get.shellshare.net/?os=linux
$ chmod +x shellshare && ./shellshare --room MY-ROOM --password MY-PASSPS> iwr https://get.shellshare.net/?os=windows -OutFile shellshare.exe
PS> .\shellshare.exe --room MY-ROOM --password MY-PASS
Sharing terminal in https://shellshare.net/r/MY-ROOM
$ # ...
$ exitPS> # ...
PS> 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 run shellshare on Windows?

Yes. We have pre-built binaries for Linux, macOS (Intel and Apple Silicon), and Windows. When you download from https://get.shellshare.net, we automatically detect your operating system and give you the correct binary.

You can also pass the os query parameter to explicitly download a specific binary. The options are linux, windows, mac and mac-arm. For example, if you want to download the Linux binary regardless of your operating system, access https://get.shellshare.net/?os=linux.

Can I self-host shellshare?

Yes. The shellshare binary also includes the server. You can start it by running shellshare server and accessing the server at http://localhost:3000. Open another terminal window and broadcast to it using shellshare --server http://localhost:3000. This way no data leaves your computer. I suggest ngrok as an easy way to allow other people to access your server.

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.