mirror of https://github.com/Shik3i/KoalaSync.git synced 2026-07-26 12:08:15 +00:00

Files

T

Timo 65ad4b5c6b chore: Bump version to 1.2.1

Patch release for:
- fix: Seek relay filtering (HLS/DASH buffering micro-seeks no longer relayed)
- feat: Seek diagnostic logging in Dev tab (Filtered/Relayed with delta)
- feat: Log buffer increased from 50 to 200 entries

2026-04-25 17:47:59 +02:00

icons

UI: Update extension icons to use new 128px high-res asset

2026-04-22 09:06:25 +02:00

shared

docs(shared): add strict warning headers and README to prevent out-of-sync edits

2026-04-23 22:01:35 +02:00

background.js

feat: Improve seek logging and increase log buffer to 200 entries

2026-04-25 17:45:06 +02:00

bridge.js

feat: add username support and fix invitation link server parsing

2026-04-22 11:22:31 +02:00

content.js

feat: Improve seek logging and increase log buffer to 200 entries

2026-04-25 17:45:06 +02:00

manifest.json

chore: Bump version to 1.2.1

2026-04-25 17:47:59 +02:00

popup.html

feat: Auto-Sync Next Episode v1.2.0

2026-04-25 16:43:10 +02:00

popup.js

feat: Auto-Sync Next Episode v1.2.0

2026-04-25 16:43:10 +02:00

README.md

fix: integrate protocol sync into CI/CD and update documentation

2026-04-22 17:01:00 +02:00

README.md

KoalaSync Chrome Extension

A Manifest V3 Chrome Extension 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.).

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 and toggle domain-based Noise Filtering.
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.

Installation

Sync Protocol: Run ./scripts/sync-constants.sh (macOS/Linux) or scripts\sync-constants.bat (Windows) from the root.
Open Chrome and go to chrome://extensions/.
Enable Developer mode (top right).
Click Load unpacked and select the extension folder.

Development

If you modify shared/constants.js, you must synchronize the changes across the extension and server:

Windows: Run scripts\sync-constants.bat
Linux/macOS: Run scripts/sync-constants.sh