Skip to content


Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time


Live broadcast of terminal sessions.


Ever wanted to quickly show what you're doing to some friends? Maybe you're seeing a weird error and would like some help. Or the other way around: some friend of yours is asking for help on something, then you start to ping-pong: you tell a command, he pastes the output, then you tell another, and so on...

The objective of is to provide an easy way to broadcast your terminal live. No signups, no configurations, anything: simply run a command and you're good to go.


Copy and paste the following line in your terminal:

wget -qO shellshare && python shellshare

If you don't have wget installed (as in Mac OS X), you can use curl as:

curl -sLo shellshare && python shellshare

You'll see a line saying Sharing session in (your link will be different). Anyone that opens this link will be able to see what you're doing in your terminal. When you're done, type exit or hit CTRL+D.


It requires Node 4.2.x (but should work with earlier versions), npm, Gulp and MongoDB. Considering that these dependencies are installed on your local machine, run:

npm install
npm start

This will run the server on localhost:3000. To broadcast to this instance, use the --server option of the client, as following:

./public/bin/shellshare --server localhost:3000


Alternatively, you could run the server using docker compose as follows:

docker-compose up --build

It will build a container with shellshare and all its dependencies, pull the latest mongodb container and connect them as needed. If you want to modify any of the environment variables or properties, check the docker-compose.yml file.


This project is intended for live broadcasts only. If you'd like to record your terminal, check or other terminal recording tools.


Copyright 2015 Vitor Baptista

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.