KoalaSync is a lightweight Browser Extension and Relay Server for synchronized video playback on almost any website with a video element—YouTube, Twitch, Netflix, Emby, Jellyfin, and beyond. Built with a focus on Data Sovereignty and Performance.
diff --git a/server/.env.example b/server/.env.example
index 310e833..8f38ee5 100644
--- a/server/.env.example
+++ b/server/.env.example
@@ -6,3 +6,5 @@ MAX_PEERS_PER_ROOM="25"
# Use a long random token, 32+ characters recommended.
ADMIN_METRICS_TOKEN=""
+# Optional: set to "1" to enable verbose connection, room-join/leave, and CORS logs in the console. Default is "0" (disabled).
+DEBUG_LOGGING="0"
diff --git a/server/README.md b/server/README.md
index 42bc0aa..2db50dd 100644
--- a/server/README.md
+++ b/server/README.md
@@ -12,13 +12,16 @@ A Node.js relay server for synchronized video playback.
### Environment
Copy `.env.example` to `.env` and configure your settings.
```bash
-PORT=3000
-MAX_ROOMS=1000
-MAX_PEERS_PER_ROOM=25
-MIN_VERSION=1.0.0
+PORT="3000"
+MAX_ROOMS="1000"
+MAX_PEERS_PER_ROOM="25"
+MIN_VERSION="1.0.0"
# Optional: enables aggregate-only admin metrics on /health with Authorization: Bearer
# Use a long random token, 32+ characters recommended.
-ADMIN_METRICS_TOKEN=
+ADMIN_METRICS_TOKEN=""
+
+# Optional: set to "1" to enable verbose connection, room-join/leave, and CORS logs in the console. Default is "0" (disabled).
+DEBUG_LOGGING="0"
```
### Health & Metrics
diff --git a/server/index.js b/server/index.js
index 6c2f7e0..698969e 100644
--- a/server/index.js
+++ b/server/index.js
@@ -116,6 +116,10 @@ const peerToSocket = new Map(); // peerId -> socketId (Global lookup)
const roomCreationLocks = new Map(); // roomId -> Promise (prevents race on room creation)
function log(type, message, details = '') {
+ const debugLogging = process.env.DEBUG_LOGGING === '1';
+ const isVerbose = type === 'CONN' || type === 'ROOM' || type === 'DEDUPE' || type === 'CORS';
+ if (!debugLogging && isVerbose) return;
+
const timestamp = new Date().toISOString();
console.log(`[${timestamp}] [${type}] ${message}`, details);
}
diff --git a/website/www/de/index.html b/website/www/de/index.html
index f276d19..c48b7b9 100644
--- a/website/www/de/index.html
+++ b/website/www/de/index.html
@@ -256,7 +256,7 @@
