synclounge/syncloungeserver repository overview

⁠SyncLounge Socket Server

This is the socket server that goes along with the SyncLounge webapp⁠. You probably want to check that out unless you just want to run this socket server, since the webapp also includes this.

This socket server can be used as just a binary or can be included as a library, like it is with the webapp⁠

⁠Installation

npm install -g syncloungeserver

⁠Usage

syncloungeserver

If you want to also serve the webapp:

syncloungeserver --static_path /path/to/syncloungewebapp/dist
# OR
STATIC_PATH='/path/to/syncloungewebapp/dist' syncloungeserver

⁠Options

All options can be provided as either environmental variables or arguments.

⁠Port

Default is 8088

syncloungeserver --port 1234
# OR
PORT=1234 syncloungeserver

⁠Static Path

No default. If the option isn't provided the server will not serve static files from anywhere. If it is provided, it will serve assets from the specified directory. This option is useful for users who want to run both the SyncLounge socket server and the webapp. Since the webapp is static, you can just point the static path to the dist directory of the webapp and have both apps served by this.

syncloungeserver --static_path /apps/synclounge/dist
# OR
STATIC_PATH='/apps/synclounge/dist' syncloungeserver

⁠Base URL

Default is '/'

syncloungeserver --base_url '/somebase'
# OR
BASE_URL='/somebase' syncloungeserver

⁠Ping Interval

Default is 10000 ms

syncloungeserver --ping_interval 10000
# OR
PING_INTERVAL=10000 syncloungeserver

⁠Manual Building

You can also clone the repository to build it yourself or

git clone https://github.com/synclounge/syncloungeserver.git
cd syncloungeserver
npm install
npm run build

Then you can run it

npm run start