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.
go getthis repo.
cd $GOPATH && go get github.com/juanvallejo/streaming-server
- or (using
mkdir -p $GOPATH/src/github.com/juanvallejo
git clone https://github.com/juanvallejo/streaming-server
git submodule update --init(init the webclient submodule)
Once you've followed these steps, you should see a newly created
bin directory containing a
- 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
To access a stream room, create a room by going to
For up-to-date and comprehensive information about using this project, please read the wiki.
Rooms represent individual playback objects that allow one or more clients to play media independent from each other.
The default room url is
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
stop can be performed.
To set a
stream, enter the command
/stream set <URL> in the chat.
Playback, right now, supports streaming
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
/stream set https://www.youtube.com/watch?v=...
Controlling a stream
set a stream, it will be loaded by each client, but will not begin playing.
To begin playback, use the command:
Performing this command before setting a stream will result in a playback error.
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,
queueing simply pushes a stream object into an internal list.
You can queue a video with:
/queue add <URL>
queuing does not cause clients to also load the video. For the next item in the queue to be
loaded by all clients,
skip the currently set video with:
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
configthat allows certain features to be turned on or off (such as automatically playing the next item in the queue).