mirror of https://github.com/Shik3i/KoalaSync.git synced 2026-07-27 20:39:10 +00:00

Files

T

Koala 82c09a5328 fix(popup): use hostname-aware domain matching to prevent false positives

The noise filter used naive String.includes() on the full URL, causing
blacklist entry 'x.com' to match netflix.com (since 'netflix.com'
contains 'x.com' as substring). This made Netflix tabs disappear when
the filter was enabled.

Fixed by extracting the URL hostname and matching at domain boundaries:
- Domain entries (x.com): hostname === domain || endsWith('.' + domain)
- Prefix entries (amazon.): startsWith || includes('.' + domain)
- Keyword entries (jira): substring fallback on full URL

Release v1.7.5

2026-05-25 13:26:01 +02:00

icons

fix(firefox): add gecko data collection permissions and proper icon sizes

2026-05-18 19:24:19 +02:00

background.js

fix: sync FORCE_SYNC_TIMEOUT constant with actual usage, tokenize showError cleanup, fix EVENT_ACK indent

2026-05-25 12:28:22 +02:00

bridge.js

chore: migrate domains from shik3i.net to koalastuff.net

2026-05-16 13:08:53 +02:00

content.js

fix: commandSenderMap race - embed senderId in SERVER_COMMAND/CMD_ACK instead of global Map

2026-05-25 11:52:05 +02:00

manifest.base.json

fix(popup): use hostname-aware domain matching to prevent false positives

2026-05-25 13:26:01 +02:00

popup.html

feat: sprint 2 - empty states, onboarding tour, dev tab optimization, expanded usernames

2026-05-25 10:05:47 +02:00

popup.js

fix(popup): use hostname-aware domain matching to prevent false positives

2026-05-25 13:26:01 +02:00

README.md

Remove exaggerated marketing claims and fix technical inaccuracies across docs and website

2026-05-25 09:37:13 +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.).

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.
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.