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

Files

T

KoalaDev 1f48e9df47 fix(popup): polish custom-server, host-control card & co-host UX

- Manual Connect: split the server picker into its own inset panel,
  visually separated from the Room ID / Password fields (they were
  welded together in one flat list).
- Custom server URL: stop auto-prepending ws:// — default to wss://
  for real hosts, ws:// only for localhost/127.0.0.1 (matches what
  the background already enforces; the displayed URL no longer lies).
- Host Control card: replace the raw native checkbox with the proper
  .toggle-switch slider used in Options; move the toggle row from a
  <label> to a <div> to avoid an illegally nested label.
- Co-host discoverability: owner-only hint in the Host Control card
  pointing to the participant list (new NOTICE_COHOST_HINT across all
  15 locales). Shown only when actionable: owner + co-host-capable
  relay + host-only active.
- Peer row: group right-side badges/actions into one container so they
  no longer scatter via space-between or collide with long names;
  restyle the give/revoke button (padding, weight, hover fill, tooltip).
- Gate promote/demote (and role badges) on host-only mode being ON,
  in addition to the existing owner-privilege check — roles are moot
  in 'everyone' mode, so no badge/button noise there.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-06-29 02:43:28 +02:00

_locales

feat(i18n): add Ukrainian & Chinese, fix zh/uk translation quality

2026-06-19 16:26:20 +02:00

assets

chore: release v2.1.1

2026-06-04 15:33:06 +02:00

icons

feat: update icons for extension and website, automate responsive logo sizes in build pipeline

2026-06-04 14:46:55 +02:00

locales

fix(popup): polish custom-server, host-control card & co-host UX

2026-06-29 02:43:28 +02:00

modules

refactor(extension): extract tab management logic into independent module

2026-06-19 14:11:47 -06:00

audio-options.css

v2.2.0 polish: inline pulse dot, coffee theme, remove toggle, GitHub issue link, beautify audio page, locale cleanup

2026-06-08 20:56:41 +02:00

audio-options.html

v2.2.0 polish: inline pulse dot, coffee theme, remove toggle, GitHub issue link, beautify audio page, locale cleanup

2026-06-08 20:56:41 +02:00

audio-options.js

fix(extension): stop storing room/settings in chrome.storage.sync

2026-06-23 17:38:36 +02:00

background.js

perf+fix: debounce seq persistence + role changes, null-clear stale peer state

2026-06-29 01:22:41 +02:00

bridge.js

chore: release v2.1.0 with stabilization and audit fixes

2026-06-04 15:18:57 +02:00

content.js

fix(host-control-mode): adversarial audit — force-sync stall, desync/lobby, gate parity, BC tests

2026-06-28 05:54:50 +02:00

episode-utils.js

refactor(extension): extract episode-utils from background.js + content.js

2026-06-16 12:48:11 +02:00

i18n.js

feat(i18n): add Ukrainian & Chinese, fix zh/uk translation quality

2026-06-19 16:26:20 +02:00

manifest.base.json

fix(ui): Correct false idle state on connection errors

2026-06-23 18:36:05 +02:00

popup.html

fix(popup): polish custom-server, host-control card & co-host UX

2026-06-29 02:43:28 +02:00

popup.js

fix(popup): polish custom-server, host-control card & co-host UX

2026-06-29 02:43:28 +02:00

README.md

docs: audit and update script references, supported languages, and completed milestones

2026-06-19 11:35:49 +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.
On-Demand Connection: The service worker only maintains a WebSocket connection while you're in a room. No persistent background connections — privacy-first architecture. Based on connectIntent flag that gates all reconnect attempts.
Live Diagnostics: Built-in "Dev" tab for real-time video state debugging (ReadyState, CurrentTime, etc.).
Dynamic i18n (Multi-Language): Fully localized in 13 languages (en, de, fr, es, it, pl, tr, nl, ja, ko, pt-BR, pt, 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:
```
npm run build:extension
```
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:

npm run build:extension

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

Module Structure

File	Purpose
`background.js`	Service worker: message routing, tab listeners, startup
`content.js`	Video detection, audio processing, episode transition (IIFE)
`popup.js`	Popup UI: join/create, tabs, status, settings
`bridge.js`	Landing page bridge (injected into sync.koalastuff.net)
`episode-utils.js`	Shared `extractEpisodeId()` / `sameEpisode()` — used by background.js, injected into content.js at build time
`i18n.js`	Translation loader
`shared/`	Constants, blacklist, name generator