How can we help?
Start with the symptom you see. These checks cover browser access, missing tabs, video detection, playback synchronization, and the information needed for a useful bug report.
Choose your problem
KoalaSync cannot access the video site
Restore “read and change site data” access in Chrome, Edge, Brave, Opera, or Vivaldi.
Open access guide → Tab listThe video tab is missing
Test the clutter filter, reload the page, and identify domains that KoalaSync hides by mistake.
Check missing tabs → Video detectionThe tab appears, but no video is found
Check the selected tab, player state, Shadow DOM diagnostics, and conflicting extensions.
Diagnose the player → SynchronizationPlay, pause, or seeking does not sync
Compare versions, selected tabs, room state, and debug reports from every participant.
Check synchronization →Why does the browser show such a broad warning?
Browsers may say that KoalaSync can “read and change all your data on all websites.” The wording is broad because KoalaSync is designed to work with video players across many different websites instead of a short fixed list.
KoalaSync injects its synchronization script into the video tab you actively select. On that tab it needs to find and control the video element, synchronize play, pause, and seeking, and display the optional room chat overlay. Open tab titles are read to populate the tab selector. KoalaSync does not create a general browsing or watch history.
The video tab does not appear
- Keep the video page open and reload it once.
- Close and reopen the KoalaSync popup, then check Select Video again.
- Open KoalaSync Settings and turn off Hide Clutter Tabs.
- Return to the tab selector. If the tab now appears, the site was filtered as clutter by mistake.
- If the tab is still missing, verify website access using the site-access guide.
For a false clutter match, report the domain, whether the tab appears with the filter disabled, and whether the page contains a visible HTML5 video. A domain such as video.example.com is usually enough; do not publish a private URL containing account or session details.
The tab appears, but KoalaSync finds no usable video
- Select the exact tab containing the visible player, not a login, search, or media-library tab.
- Start the video once. Some websites create their video element only after playback begins.
- Open the KoalaSync Status tab and inspect Video Debug Info.
- If the report says NO VIDEO ELEMENT, note the video count and whether Shadow DOM was detected.
- Temporarily disable other extensions that modify the player, then reload and test again.
- Protected, heavily customized, or non-HTML5 players may require site-specific support.
Everyone is connected, but playback does not sync
- Update KoalaSync in every browser and confirm everyone uses the same extension version.
- Make sure each participant selected the correct local video tab.
- Reload the video page after changing website access, then select the tab again.
- Test play, pause, and seeking separately and note which action fails.
- Before anyone leaves the room, collect a debug report from every affected participant.
Create a useful GitHub issue
- Open KoalaSync, switch to Status, and click Copy Logs while the problem is still visible.
- Open the KoalaSync GitHub bug-report form and sign in to GitHub if requested.
- Describe the exact steps that reproduce the problem, what you expected, and what happened instead.
- Add your browser, operating system, KoalaSync version, and the affected website or domain.
- Paste the debug report, add a screenshot if useful, and review everything before publishing.
The copied report can include page titles and URLs, peer and room identifiers, participant names, and a custom server URL. Remove anything private. Never publish an invite link, room password, chat secret, account token, or a URL containing private session parameters.