The server component for the YTSync Plugin.
The server manages the syncing process of the different rooms and the clients for the YTSync Plugin. It also supplies some resources like images for the clients.
Required Dependencies:
After you installed all the needed decpendencies you can get the source code by cloning the git repository:
# SSH
git clone [email protected]:Tandashi/YTSync-Server.git
# HTTPS
git clone https://github.com/Tandashi/YTSync-Server.gitTo install the server dependencies run the following command:
# Using npm
npm install
# Using yarn
yarn installThe last step left is to start the server. This can be done as follows:
# Using npm
npm start
# Using yarn
yarn startThe above commands would start the server with the default configuration. This behaviour can be changed by creating a .env file in the root directory of the project. The following .env file would start the server on port 9000.
YTSYNC_SERVER_PORT=9000Here is a list of all available enviroment variables:
| Variable | Description | Value | Default |
|---|---|---|---|
| YTSYNC_SERVER_PORT | The port the server should listen to | int | 8080 |
To run the server using docker you can have to build the Docker Image yourself as of right now. This might change in the future though. To do this you first need to clone this repository using git:
# SSH
git clone [email protected]:Tandashi/YTSync-Server.git
# HTTPS
git clone https://github.com/Tandashi/YTSync-Server.gitAfter that you can build the Docker Image as follows:
docker build . -t tandashi/ytsync-serverFinally you can run the Docker Image:
docker run tandashi/ytsync-serverThe Docker Image exposes the server on port 8080. But you probably want to use port mapping to make the server accessible for the outside world / host system. You can do this as follows:
docker run -p9000:8080 tandashi/ytsync-server
This would make the server accessible on port 9000 on your host system. You can change another port of course just replace the 9000 with the port of your choice. You can also use docker-compose which is also recommended.
If you want to host this server on your own for what ever reason (because there is no real point todo so) you might need to consider a few things:
- The plugins are configured to connect to the default/main server. If you want to host your own server for e.g. for your friends you would need to change the server connection in the plugin and compile the plugin yourself. After that you can distribute the modified version to your friends. If you or your friends want to watch with someone else that doesn't have your modified version this will not work. They either need your modified version or you need to reinstall the official plugin.
- The server and plugin use socket.io to communicate with each other. You might need to configure your reverse-proxy, etc. to support this. They use the default path (
/socket.io) for communication.
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.