Skip to content
Media streaming server - allows multiple clients to watch videos in sync
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
cmd refactor admin picker to background process Nov 30, 2017
data add chunked data handling Jun 15, 2017
vendor/ switch to using libav go-bindings for decoding stream info Mar 5, 2018
.gitignore init commit Mar 11, 2017
.gitmodules update submodule url; bump webclient Jul 2, 2017
Makefile init commit Mar 11, 2017
main.go add symlink to entrypoint Jun 18, 2017

Streaming Server

Working demo at


Multi-client media streaming server. Watch videos with friends, keeping everyone in sync.

Please see the Wiki for a detailed guide on using this project.


Thought it'd be fun.


There are currently no downloads available, links will appear here in the future for binary downloads of this project. Please see the Compiling section to learn how to compile this project for now.


Alternatively, you may choose to compile this project yourself rather than downloading a pre-compiled binary. See the sub-sections below for detailed steps and requirements.


Requires Go and ffmpeg-devel to compile.

  1. Either git clone or go get this repo.
  • cd $GOPATH && go get
  • or (using git clone):
    • mkdir -p $GOPATH/src/
    • cd $GOPATH/src/
    • git clone
    • git submodule update --init (init the webclient submodule)
  1. make


Once you've followed these steps, you should see a newly created bin directory containing a streaming binary.

  1. ./bin/streaming
  • You can optionally specify the port to bind to with ./bin/streaming --port <PORT>

The server will bind to port 8080 by default. Once it is running, you can access the web client at http://localhost:8080. To access a stream room, create a room by going to http://localhost:8080/v/roomname.

Further reading


For up-to-date and comprehensive information about using this project, please read the wiki.

Simple Overview


Rooms represent individual playback objects that allow one or more clients to play media independent from each other.

The default room url is /v/<ROOM>.

A room is created the first time it is accessed. Any subsequent access, retrieves previously created playback information.


Each room contains a chat, which acts as a make-shift command prompt.
Any chat messages entered in the chat beginning with / are interpreted as commands by the server.

A list of available commands is available by typing /help in the chat.


Playback requires a stream to be set, before operations such as play, pause, stop can be performed.
To set a stream, enter the command /stream set <URL> in the chat.

Playback, right now, supports streaming youtube and local videos.

Streaming local videos & "data" directory

Local videos are streamed from local files in the server. These files should be placed in the data directory, in the root of this project.

Example of setting a local video:

/stream set mylocalvideo.mp4

Note that local video files must be of a browser-friendly format in order for them to actually be displayed.

Streaming youtube videos

youtube videos are set using their full YouTube url.

Example of setting a youtube video:

/stream set

Controlling a stream

Once you set a stream, it will be loaded by each client, but will not begin playing.
To begin playback, use the command:

/stream play

Performing this command before setting a stream will result in a playback error.

The queue

Please refer to the wiki for a comprehensive guide and explanation of the queue.

It is also possible to queue media. Queuing differs from the /stream set ... command in that set immediately loads a video, bypassing the queue entirely, while queueing simply pushes a stream object into an internal list.

You can queue a video with:

/queue add <URL>

Note that queuing does not cause clients to also load the video. For the next item in the queue to be loaded by all clients, you must skip the currently set video with:

/stream skip

Note that this command results in an error if there are no items in the queue.
Additionally, by default, clients will automatically load the next item in the queue, if one exists, once the currently playing video ends.


  • Add ui for commonly used commands that control stream playback and queue actions.
  • Add a client config that allows certain features to be turned on or off (such as automatically playing the next item in the queue).
You can’t perform that action at this time.