Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


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

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).


Media streaming server - allows multiple clients to watch videos in sync








No packages published