mirror of https://github.com/Shik3i/KoalaSync.git synced 2026-08-03 16:07:42 +00:00

Files

T

Timo 8cc622bda0 Fix custom server reconnection and reconnect strategy

- Fix: CONNECT/RETRY_CONNECT always force-disconnect before reconnecting
  (prevents JOIN_ROOM going to official server when custom is selected)
- Add forceDisconnect() helper: clears socket, eventQueue, episodeLobby,
  expectedAcksCount, broadcast status, persists cleanup to storage
- Fix: save useCustomServer to storage on Join Room click (no race condition)
- Fix: trigger RETRY_CONNECT on server mode toggle and custom URL change
- Fix: show error when Custom selected but no URL entered (no silent fallback)
- Fix: button label changed to 'Join / Create Room' in all 6 locales
- Rewrite scheduleReconnect() for two-phase strategy:
  Phase 1 (aggressive): 500ms-5s backoff, max 20 attempts or 5 minutes
  Phase 2 (slow): retry every 5 minutes indefinitely, never give up
- Persist reconnectAttempts/reconnectStartTime/reconnectFailed to session storage
- Remove 'reconnect_failed' status; slow mode shows as 'reconnecting' with retry button
- Add scheduleReconnect() call on offline path to continue retry cycle

2026-06-01 13:06:40 +02:00

icons

feat(website,extension): integrate NewLogoIcon as WebP favicon/header logo and convert to PNG extension icons

2026-05-30 20:14:59 +02:00

locales

Fix custom server reconnection and reconnect strategy

2026-06-01 13:06:40 +02:00

background.js

Fix custom server reconnection and reconnect strategy

2026-06-01 13:06:40 +02:00

bridge.js

Fix critical sync lockouts, zombie disconnects, play-seek debounces, active lobbies, SW keep-alives, branding matches and ESLint warnings

2026-05-30 00:02:19 +02:00

content.js

Refactor: Behebung Force-Sync ACK-Zaehler-Inflation, SHA-256 Hashing, Room-ID-Desinfizierung, Reduzierung MIN_SEEK_DELTA auf 2s und seekDebounce auf 300ms

2026-05-30 02:00:17 +02:00

i18n.js

feat(extension): implement full dynamic i18n support and automated consistency checks

2026-06-01 01:05:46 +02:00

manifest.base.json

chore(release): update versions to v1.9.3 [skip ci]

2026-05-30 00:01:24 +00:00

popup.html

feat(extension): implement full dynamic i18n support and automated consistency checks

2026-06-01 01:05:46 +02:00

popup.js

Fix custom server reconnection and reconnect strategy

2026-06-01 13:06:40 +02:00

README.md

docs: update documentations to reflect browser extension i18n features

2026-06-01 01:07:41 +02:00

README.md

KoalaSync Browser Extension

A Manifest V3 Browser Extension (Chrome & Firefox) for synchronized video playback across any website.

Key Features

Manifest V3: Optimized Service Worker architecture with session persistence.
Pure Vanilla JS: No external dependencies or heavy libraries.
Smart Peer IDs: Hexadecimal IDs combined with customizable Usernames for easy identification.
Dual Heartbeat: Advanced session tracking (Background) and video synchronization (Content) to prevent ghost sessions.
Live Diagnostics: Built-in "Dev" tab for real-time video state debugging (ReadyState, CurrentTime, etc.).
Dynamic i18n (Multi-Language): Fully localized in 6 languages (en, de, fr, es, pt-BR, ru) with auto-detected fallback and dynamic on-the-fly language selectors.

Tab Overview

Room: Manage connections, view active peers, and share invitation links.
Sync: Control video playback (Play/Pause/Force Sync) and view recent activity.
Settings: Customize your Username, toggle domain-based Noise Filtering, and switch the App Language.
Dev: Monitor connection status and view real-time video element metadata for debugging.

Privacy & Permissions

KoalaSync requires <all_urls> permission to detect and interact with video elements (<video>) on websites.

No Browsing History: We do not track or store your browsing history.
State Management: Sensitive data (Room Passwords) is stored locally using chrome.storage.
Zero Telemetry: No analytics or external tracking scripts.
Zero Runtime Dependencies: The extension is built with pure Vanilla JS and contains no external libraries or tracking scripts, ensuring performance and privacy.

Installation

Prepare Extension: From the repository root, run:
```
node scripts/build-extension.js
```
Open Chrome and go to chrome://extensions/.
Enable Developer mode (top right).
Click Load unpacked and select the dist/chrome folder.

Development

If you modify shared/constants.js, you must synchronize the changes by running the build script from the root:

node scripts/build-extension.js

This ensures that the extension/shared folder is updated with the latest protocol constants.