Skip to content
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
91 lines (67 sloc) 1.87 KB


Build Status

The easy way to watch videos with your friends.


Contributions are welcome. The current iteration is named "Flare", and you can see what's currently being worked on under the "projects" tab.

Setting up your dev environment


This project targets the lastest LTS version of node.js.


  1. Fork this repo and clone it.

    If you are planning to deploy this yourself, make sure you are on the master branch.

  2. In a terminal, navigate to the opentogethertube folder and run

npm install
  1. Next you need to set up your configuration. Start by copying the example config in the env folder to a new file called development.env
cp env/example.env env/development.env
  1. Obtain a YouTube API key
  2. Open env/development.env and replace API_KEY_GOES_HERE with the youtube api key.
  3. Initialize your local database.
npx sequelize-cli db:migrate


To run the test suite, run

npm test

How to run

This project has 2 main components: the client and the server. You can run both of them simultaneously using the command

Linux / Mac

npm run dev


npm run dev-windows

Sometimes, you may want to run them seperately so you can use breakpoints to debug. Using VSCode, this is trivial.

To start the server: Debug > Select "Launch Program" > Start

To start the client: npm run serve


  1. Clone this repo.
  2. Install despendencies.
npm install
  1. Build Vue files so they can be served statically.
npm run build
  1. Run the server.
npm start

You can also specify the port the server will listen on by setting the PORT environment variable.

PORT=8080 npm start
You can’t perform that action at this time.