feat: optimize extension uninstall URL registration with anonymous token and startup hardening

docs: revert completed milestones in ROADMAP.md
docs: audit and update script references, supported languages, and completed milestones
2026-07-26 20:18:14 +00:00 · 2026-06-19 11:54:07 +02:00 · 2026-06-19 11:39:50 +02:00 · 2026-06-19 11:35:49 +02:00 · 2026-06-19 11:12:48 +02:00 · 2026-06-19 10:59:30 +02:00
200 changed files with 3801 additions and 19108 deletions
@@ -37,7 +37,7 @@ Closes #
 - [ ] I have performed a self-review of my code
 - [ ] I have added/updated tests if needed
 - [ ] I have updated documentation if needed (`docs/`, README, etc.)
- [ ] Protocol changes: I ran `node scripts/build-extension.js` and updated relevant docs
+- [ ] Protocol changes: I ran `node scripts/build-extension.cjs` and updated relevant docs
 - [ ] No new warnings, secrets, or hardcoded credentials introduced

 ### Additional Context
@@ -5,21 +5,29 @@ on:
    tags:
      - 'v*'

+# A release run must never be interrupted (it commits back to main and publishes
+# artifacts). Only dedupe accidental re-pushes of the same tag.
+concurrency:
+  group: release-${{ github.ref_name }}
+  cancel-in-progress: false
+
 jobs:
  release-server:
    runs-on: ubuntu-latest
    permissions:
-      contents: write
+      contents: read
      packages: write
+      id-token: write
+      attestations: write
    steps:
      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7

      - name: Set up Docker Buildx
-        uses: docker/setup-buildx-action@v3
+        uses: docker/setup-buildx-action@v4

      - name: Log in to GitHub Container Registry
-        uses: docker/login-action@v3
+        uses: docker/login-action@v4
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
@@ -27,7 +35,7 @@ jobs:

      - name: Extract Docker metadata
        id: meta
-        uses: docker/metadata-action@v5
+        uses: docker/metadata-action@v6
        with:
          images: ghcr.io/${{ github.repository }}
          tags: |
@@ -35,7 +43,8 @@ jobs:
            type=ref,event=tag

      - name: Build and push Docker image
-        uses: docker/build-push-action@v5
+        id: build
+        uses: docker/build-push-action@v7
        with:
          context: .
          file: server/Dockerfile
@@ -43,14 +52,32 @@ jobs:
          platforms: linux/amd64,linux/arm64
          tags: ${{ steps.meta.outputs.tags }}
          labels: ${{ steps.meta.outputs.labels }}
+          # Reuse layers across releases to speed up the multi-arch build.
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+      - name: Generate artifact attestation
+        uses: actions/attest@v4
+        with:
+          subject-name: ghcr.io/${{ github.repository }}
+          subject-digest: ${{ steps.build.outputs.digest }}
+          push-to-registry: true

  release-extension:
    runs-on: ubuntu-latest
    permissions:
      contents: write
+      id-token: write
+      attestations: write
    steps:
      - name: Checkout code
-        uses: actions/checkout@v4
+        uses: actions/checkout@v7
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '24'
+          cache: 'npm'

      - name: Extract version from tag
        id: version
@@ -67,7 +94,7 @@ jobs:
          echo "  ✓ manifest.base.json -> $VERSION"

          # 2. shared/constants.js — APP_VERSION
-          sed -i "s/export const APP_VERSION = '.*'/export const APP_VERSION = '$VERSION'/" shared/constants.js
+          sed -i "s/export const APP_VERSION = [\"'].*[\"']/export const APP_VERSION = \"$VERSION\"/" shared/constants.js
          echo "  ✓ shared/constants.js -> $VERSION"

          # 3. package.json
@@ -78,13 +105,26 @@ jobs:
          jq -n --arg v "$VERSION" --arg d "$DATE" '{version: $v, date: $d}' > website/version.json
          echo "  ✓ website/version.json -> version $VERSION, date $DATE"

+          # 5. website/template.html — SoftwareApplication schema
+          sed -i "s/\"softwareVersion\": \".*\"/\"softwareVersion\": \"$VERSION\"/" website/template.html
+          echo "  ✓ website/template.html -> softwareVersion $VERSION"
+
+          # 6. README.md — version badge & banner
+          sed -i "s|Release-v[0-9]\+\.[0-9]\+\.[0-9]\+-blue|Release-v$VERSION-blue|g" README.md
+          sed -i "s/New v[0-9]\+\.[0-9]\+\.[0-9]\+ Release/New v$VERSION Release/g" README.md
+          echo "  ✓ README.md -> v$VERSION"
+
+          # 7. website/sitemap.xml — lastmod dates
+          sed -i "s/<lastmod>[0-9-]*<\/lastmod>/<lastmod>$(date +%Y-%m-%d)<\/lastmod>/g" website/sitemap.xml
+          echo "  ✓ website/sitemap.xml -> lastmod $(date +%Y-%m-%d)"
+
          echo "Version injection complete."

      - name: Commit and push version updates back to main
        run: |
          git config --local user.email "action@github.com"
          git config --local user.name "GitHub Action"
-          git add extension/manifest.base.json shared/constants.js package.json website/version.json
+          git add extension/manifest.base.json shared/constants.js package.json website/version.json website/template.html README.md website/sitemap.xml
          git commit -m "chore(release): update versions to $GITHUB_REF_NAME [skip ci]" || echo "No changes to commit"
          git push origin HEAD:main
        env:
@@ -95,8 +135,23 @@ jobs:
          npm install
          npm run build:extension

+      - name: Generate artifact attestation for extensions
+        uses: actions/attest@v4
+        with:
+          subject-path: dist/koalasync-*.zip
+
+      - name: Build Website
+        run: node website/build.cjs
+
+      - name: Upload Website Artifacts
+        uses: actions/upload-artifact@v7
+        with:
+          name: website-www
+          path: website/www/
+          if-no-files-found: error
+
      - name: Create GitHub Release
-        uses: softprops/action-gh-release@v1
+        uses: softprops/action-gh-release@v3
        with:
          files: |
            dist/koalasync-chrome.zip
@@ -40,5 +40,8 @@ coverage/
 # the root 'shared/' remains the Single Source of Truth.
 extension/shared/

+# Auto-generated website build output
+website/www/
+
 # Temporary scratch files
 scratch/
@@ -12,7 +12,7 @@ Please note that by participating in this project, you agree to abide by our [Co
 |------|-------------|
 | **Bug Reports** | Found a bug? Open an issue with repro steps (see template below). |
 | **Code** | Fix bugs, add features, or improve the extension / server / website. |
-| **Translations** | Help localize the extension and website into more languages. See [TRANSLATION.md](website/TRANSLATION.md). |
+| **Translations** | Help localize the extension and website into more languages. See [TRANSLATION.md](docs/TRANSLATION.md). |
 | **Documentation** | Improve docs, fix typos, or add missing examples. |
 | **Security** | Found a vulnerability? See [SECURITY.md](SECURITY.md) — do NOT open a public issue. |

@@ -31,7 +31,7 @@ Please note that by participating in this project, you agree to abide by our [Co
 git clone https://github.com/Shik3i/KoalaSync.git
 cd KoalaSync
 npm install
-node scripts/build-extension.js
+node scripts/build-extension.cjs
 ```

 ---
@@ -62,7 +62,7 @@ node scripts/build-extension.js
 ### Website

 ```bash
-node website/build.js           # Compile static site → www/
+node website/build.cjs           # Compile static site → www/
 python3 -m http.server 8080 -d website/www  # Serve locally
 ```

@@ -77,7 +77,7 @@ KoalaSync uses a **single source of truth** for all protocol constants in `share
 > [!IMPORTANT]
 > After modifying `shared/constants.js`, you **must** run the build script to sync changes to the extension:
 > ```bash
-> node scripts/build-extension.js
+> node scripts/build-extension.cjs
 > ```
 > This automatically injects constants into `content.js` and regenerates browser bundles in `dist/`.

@@ -100,15 +100,23 @@ KoalaSync uses a **single source of truth** for all protocol constants in `share

 ---

-## Pull Request Process
+## Open Source Workflow & Pull Requests

-1. **Branch** from `main` for your feature or fix.
-2. **Test locally** on both Chrome and Firefox.
-3. **Website changes**: Run `node website/build.js` and verify the compiled output in `www/`.
-4. **Lint**: Ensure `npm run lint` passes with zero errors and zero warnings.
-5. **Syntax**: Run `node -c` on every modified `.js` file.
-6. **Protocol changes**: Update relevant documentation in `docs/`.
-7. **Submit your PR** with a clear description and linked issue (if applicable).
+If you are new to open-source contributions, follow these steps to propose your changes:
+
+1. **Fork the Repository**: Click the "Fork" button at the top right of this repository to create your own copy of KoalaSync.
+2. **Clone your Fork**: `git clone https://github.com/YOUR-USERNAME/KoalaSync.git`
+3. **Create a Branch**: `git checkout -b my-new-feature` (e.g. `feature/dark-mode` or `fix/translation-de`)
+4. **Make your Changes**: Edit the files, then verify them locally.
+   - *Extension/Server changes*: Test on Chrome/Firefox and check `npm run lint`.
+   - *Website/Translation changes*: Run `node website/build.cjs` and check the output in `www/`.
+5. **Commit and Push**: `git commit -m "Add my feature"` and `git push origin my-new-feature`
+6. **Open a Pull Request (PR)**: Go to the original KoalaSync repository on GitHub and click "New Pull Request".
+
+### PR Code Requirements
+- **Lint**: Ensure `npm run lint` passes with zero errors and warnings.
+- **Syntax**: Run `node -c` on every modified `.js` file.
+- **Protocol changes**: Update relevant documentation in `docs/`.

 ---

@@ -140,14 +148,18 @@ If you cannot access the Status tab, include as much of the following manually:

 ---

-## Translation Contributions
+## Translation Contributions (Translators Welcome!)

-KoalaSync supports 6 languages: English, German, French, Spanish, Portuguese (Brazilian), and Russian.
+We welcome native speakers to help translate KoalaSync! You **do not** need deep programming knowledge to contribute translations.

-To add or improve translations:
-1. Edit the locale files in `website/locales/` (for the website).
-2. For extension translations, see [TRANSLATION.md](website/TRANSLATION.md).
-3. Run `node website/build.js` to regenerate the static site.
+KoalaSync supports multiple languages. To add or improve translations:
+1. Read the **[Translation Guide](docs/TRANSLATION.md)** first. It explains how our localization system works.
+2. Edit the `.json` files in `website/locales/` (for the website) and `extension/locales/` (for the extension).
+3. Test your translations locally by running:
+   - `node scripts/test-locales.cjs` (for extension)
+   - `node scripts/test-website-locales.mjs` (for website)
+   - `node website/build.cjs` (to build the site)
+4. Follow the **Open Source Workflow** above (Fork -> Branch -> Edit -> PR) to submit your translations.

 ---

@@ -6,15 +6,15 @@

 <p align="center">
  <a href="https://github.com/Shik3i/KoalaSync/actions/workflows/release.yml"><img src="https://github.com/Shik3i/KoalaSync/actions/workflows/release.yml/badge.svg" alt="Release Status"></a>
-  <a href="https://github.com/Shik3i/KoalaSync/releases"><img src="https://img.shields.io/github/v/release/Shik3i/KoalaSync" alt="GitHub release"></a>
-  <a href="LICENSE"><img src="https://img.shields.io/github/license/Shik3i/KoalaSync?color=blue" alt="License"></a>
+  <a href="https://github.com/Shik3i/KoalaSync/releases"><img src="https://img.shields.io/badge/Release-v2.4.1-blue?logo=github" alt="GitHub release"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-blue" alt="License"></a>
  <a href="https://addons.mozilla.org/de/firefox/addon/koalasync/"><img src="https://img.shields.io/badge/Firefox-Download-orange?logo=firefoxbrowser&logoColor=white" alt="Firefox Add-on"></a>
  <a href="https://chromewebstore.google.com/detail/koalasync/obbnmkmlaaddodakcbdljknjpagklifc"><img src="https://img.shields.io/badge/Chrome-Download-blue?logo=googlechrome&logoColor=white" alt="Chrome Extension"></a>
 </p>

 <p align="center"><i>KoalaSync is a lightweight Browser Extension and Relay Server for synchronized video playback on almost any website with a video element—YouTube, Twitch, Netflix, Emby, Jellyfin, and beyond. Built with a focus on <b>Data Sovereignty</b> and <b>Performance</b>.</i></p>

-<p align="center"><a href="docs/CHANGELOG.md"><b>New v2.2.0 Release!</b> — See what's changed</a></p>
+<p align="center"><a href="docs/CHANGELOG.md"><b>New v2.4.1 Release!</b> — See what's changed</a></p>

 ### 🌟 Why KoalaSync?

@@ -33,7 +33,7 @@
 - **Dual Heartbeat Architecture**: Robust session tracking that prevents ghost rooms and stale connections.
 - **Efficient Relay**: Minimal overhead WebSocket message forwarding.
 - **Seamless Invitations**: Smart links that automatically configure server and room credentials for your friends.
- **Audio Compressor**: Built-in Web Audio API dynamic range compression with presets (Recommended, Dynamic Range, Vocal Enhancement, Smooth) and fully customizable controls.
+- **Smart Audio Compressor**: Tired of constantly riding the volume? Automatically balance out whispering dialogue and deafening explosions with simple presets, or fully customize the audio to your liking.

 ---

@@ -54,6 +54,16 @@ The easiest and safest way to install KoalaSync is directly through the official
 2. **Invite Friends:** Share the auto-copied invite link. Once they click it, they automatically join.
 3. **Pick a Video:** Navigate to the Sync Tab, select the tab playing your video, and grab some popcorn! 🍿

+---
+
+### 🌐 Localization & Translations
+
+Both the official KoalaSync website and the **v2.0 Browser Extension** feature full dynamic localization:
+- **Available Languages**: Support is included for 13 languages: English (`en`), German (`de`), French (`fr`), Spanish (`es`), Portuguese (Brazil) (`pt-BR`), Russian (`ru`), Italian (`it`), Polish (`pl`), Turkish (`tr`), Dutch (`nl`), Japanese (`ja`), Korean (`ko`), and European Portuguese (`pt`).
+- **Real-Time Extension Localization**: Inside the extension Settings panel, users can swap languages instantly. The entire interface, notifications, Empty States, and onboarding guides re-translate dynamically in real-time.
+- **Contributing**: We welcome community translations for both the website and the extension! Please refer directly to the [TRANSLATION.md](docs/TRANSLATION.md) guide for step-by-step instructions on how to audit, refine, or add new languages.
+
+
 ---

 ### 🛠️ For Developers & Self-Hosters
@@ -71,7 +81,7 @@ The easiest and safest way to install KoalaSync is directly through the official
 To build the extension from source and synchronize protocol constants:
 ```bash
 npm install
-node scripts/build-extension.js
+npm run build:extension
 ```
 The compiled artifacts will be available in the `dist/` directory.

@@ -93,15 +103,21 @@ To connect your extension to a self-hosted server, open the popup → **Room** t

 To verify your relay is reachable from outside, visit `https://your-domain.com` in a browser — it should return `{"status":"online","service":"KoalaSync Relay"}`.

---
+#### Supply Chain Security (v2.2.2+)

-### 🌐 Localization & Translations
+All official release artifacts (Docker images and extension binaries) are published with signed [artifact attestations](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations) to prove they were built from this repository's source code.

-Both the official KoalaSync website and the **v2.0 Browser Extension** feature full dynamic localization:
- **Available Languages**: Support is included for 13 languages: English (`en`), German (`de`), French (`fr`), Spanish (`es`), Portuguese (Brazil) (`pt-BR`), Russian (`ru`), Italian (`it`), Polish (`pl`), Turkish (`tr`), Dutch (`nl`), Japanese (`ja`), Korean (`ko`), and European Portuguese (`pt`).
- **Real-Time Extension Localization**: Inside the extension Settings panel, users can swap languages instantly. The entire interface, notifications, Empty States, and onboarding guides re-translate dynamically in real-time.
- **Contributing**: We welcome community translations for both the website and the extension! Please refer directly to the [TRANSLATION.md](website/TRANSLATION.md) guide for step-by-step instructions on how to audit, refine, or add new languages.
+**Verify a Docker image:**
+```bash
+gh attestation verify oci://ghcr.io/shik3i/koalasync:latest \
+  -R Shik3i/KoalaSync
+```

+**Verify an extension binary:**
+```bash
+gh attestation verify dist/koalasync-chrome.zip \
+  -R Shik3i/KoalaSync
+```

 ---

@@ -109,19 +125,21 @@ Both the official KoalaSync website and the **v2.0 Browser Extension** feature f

 - **[CHANGELOG.md](docs/CHANGELOG.md)**: Full version history for the extension and relay server.
 - **[TESTED_SERVICES.md](docs/TESTED_SERVICES.md)**: Detailed compatibility matrix of tested streaming platforms and known limitations.
- **[TRANSLATION.md](website/TRANSLATION.md)**: Translation and localization guide for contributors.
+- **[TRANSLATION.md](docs/TRANSLATION.md)**: Translation and localization guide for contributors.
 - **[PRIVACY.md](docs/PRIVACY.md)**: Data Handling and Privacy Policy.
 - **[CONTRIBUTING.md](CONTRIBUTING.md)**: How to help make KoalaSync better.
 - **[CODE_OF_CONDUCT.md](CODE_OF_CONDUCT.md)**: Our community standards and expectations.
 - **[HOW_IT_WORKS.md](docs/HOW_IT_WORKS.md)**: Step-by-step walkthrough of the complete user flow.
 - **[ARCHITECTURE.md](docs/ARCHITECTURE.md)**: Deep-dive into the two-phase sync and heartbeat logic.
+- **[ROADMAP.md](docs/ROADMAP.md)**: Planned features, backlog, and rejected ideas.
 - **[SECURITY.md](SECURITY.md)**: Disclosure policy and security practices.
 - **[Caddyfile.example](examples/Caddyfile.example)**: Production Caddy configuration for website and relay.

 ---

 <div align="center">
-  <sub>Built with ❤️ by <a href="https://github.com/Shik3i">Shik3i</a>. KoalaSync is Open Source under the <a href="LICENSE">MIT License</a>.</sub>
  <sub><a href="https://ko-fi.com/koaladev"><img src="https://img.shields.io/badge/Ko--Fi-Support-FF5E5B?logo=ko-fi&logoColor=white" alt="Ko-Fi"></a></sub>
  <sub><a href="https://gitgem.org/github/Shik3i/KoalaSync"><img src="https://gitgem.org/api/badge/github/Shik3i/KoalaSync.svg" alt="GitGem Badge" /></a></sub>
+
+  <sub>Built with ❤️ by <a href="https://github.com/Shik3i">Shik3i</a>. KoalaSync is Open Source under the <a href="LICENSE">MIT License</a>.</sub>
 </div>
@@ -1,37 +1,57 @@
-KoalaSync: The Privacy-First Watch Party Extension
+KoalaSync: Private Watch Parties for Emby, Jellyfin, Plex, Netflix & YouTube

-Private watch parties for Emby, Jellyfin, Plex, Netflix, YouTube & more. No account needed. Real-time sync. Supports 13 languages. 100% free.
+Tired of counting down "3, 2, 1, Play" over voice chat? KoalaSync keeps you and your friends perfectly in sync. Whether you are streaming from your own self-hosted media server like Emby, Jellyfin or Plex, or watching on a major platform like Netflix, Prime Video or YouTube — KoalaSync is designed for smooth, browser-based watch parties.

-Whether you're binge-watching Netflix, streaming from your own self-hosted Emby, Jellyfin, or Plex servers, or watching on virtually any other website with a video player — KoalaSync keeps everyone perfectly in sync.
-Lightweight, open-source, and built for absolute data sovereignty with a clean, minimalist UI.

-✨ CORE FEATURES 
+✨ CORE FEATURES
+No account required. No tracking. Just create a room, invite your friends, and start watching together.

- • No Account Needed: Just create a room and share the link. No emails, no passwords, no hassle. A random nickname is assigned automatically, or pick your own.
- • Universal HTML5 Sync: Flawlessly synchronizes play, pause, and seeking on Netflix, Jellyfin, Emby, YouTube, and almost any website hosting a standard HTML5 <video> tag.
- • Smart Binge-Watching (Auto-Sync): When a new episode loads, KoalaSync automatically pauses playback in a smart lobby until everyone's video is ready. No spoilers, no one left behind.
- • Fully Localized: Enjoy a native experience with a user interface fully translated into 13 different languages.
- • One-Click Invitations: Generate a smart invite link. Once clicked, the extension instantly configures room credentials and server settings for your guests.
- • Zero-Latency Protocol: Powered by a custom WebSocket architecture designed for real-time coordination without buffering loops.
+• Real-Time Video Sync: Play, pause, seek, and watch together with fast synchronized playback across everyone in your room.
+• No Account Needed: Create a room and share the invite link. No emails, no passwords, no sign-ups. Pick a nickname or let KoalaSync generate one for you.
+• Works Almost Everywhere: If the website uses a standard HTML5 video player, KoalaSync can usually sync it. Perfect for streaming sites, self-hosted media servers, and other websites.
+• Smart Binge-Watching: When a new episode loads, KoalaSync automatically pauses the lobby until everyone is ready. No spoilers, no one left behind.
+• Smart Audio Compressor: Tired of quiet dialogue and suddenly loud action scenes? Balance whispering, explosions, and music with a single click while you watch.
+• One-Click Invites: Send a smart invite link to your friends. When they open it, KoalaSync automatically configures the room so they can join instantly.
+• 13 Languages: Enjoy a native experience with a fully translated user interface.

-🛡️ UNCOMPROMISING PRIVACY & SECURITY 

- No data collection. No compromises.
- • 100% Anonymous: Zero tracking, zero analytics, zero telemetry.
- • Ready Out-Of-The-Box: No technical knowledge needed. Install and start watching immediately using the official public server.
- • RAM-Only Public Server: The official relay server operates entirely in volatile RAM. No databases, no logs, no watch history — nothing persists. It also features built-in rate-limiting and brute-force protection to prevent room-id spamming.
- • Self-Hostable: Take total control by deploying a private relay server in seconds via Docker. Optional, never required.

-🚀 HOW IT WORKS 
+🛡️ PRIVACY & SECURITY
+KoalaSync is built for private watch parties without unnecessary data collection.

- 1. Install KoalaSync and click "Create Room" to spin up a secure lobby.
- 2. Copy the invite link and send it to your friends.
- 3. Open your favorite streaming site and set the video tab as the active target.
- 4. Press play — everyone stays perfectly in sync.
+• No Tracking: Zero analytics, zero telemetry, and absolutely no behavior profiling.
+• Anonymous by Design: No accounts needed. Rooms can be joined with a simple nickname.
+• Ready Out of the Box: Install KoalaSync and start watching immediately using the official public relay server. No technical setup required.
+• RAM-Only Public Server: The official relay server operates entirely in volatile RAM. No databases, no stored watch history, no persistent room data. Room data exists only temporarily and disappears when the room closes.
+• Self-Hostable: Want full control? You can run your own private KoalaSync relay server via Docker in seconds. Self-hosting is optional and never required.

-💻 OPEN SOURCE 

- KoalaSync was built by a solo developer who needed a fast, secure way to watch movies with friends — and builds tools worth using. The code is fully transparent under the MIT license: audit it, fork it, improve it. Found a bug or have a feature idea? Open an issue on GitHub. Contributions and code reviews are always welcome.

- • Website: https://sync.koalastuff.net
- • GitHub: https://github.com/Shik3i/KoalaSync
+🚀 HOW IT WORKS
+1. Install KoalaSync.
+2. Click "Create Room" to start a private watch party.
+3. Share the invite link with your friends.
+4. Open your favorite streaming site or media server.
+5. Select the active video tab.
+6. Press play — everyone stays perfectly in sync.
+
+
+
+⚙️ UNDER THE HOOD
+KoalaSync is lightweight, transparent, and built with privacy in mind.
+
+• On-Demand Relay: Playback state is synchronized through a custom WebSocket-based relay server. No persistent connection — the relay is only active while you're in a room. No background traffic, no idle connections.
+• No Media Streaming: KoalaSync does not stream, proxy, upload, download, or redistribute any video content. Everyone watches from their own browser on the original website.
+• Temporary Room State Only: The relay server only coordinates room state such as play, pause, seek position, active target, nickname, and readiness status.
+• Docker Self-Hosting: The relay server can be self-hosted with Docker if you prefer to run your own private instance.
+• Open Architecture: The project is designed to be inspectable, forkable, and easy to review.
+
+
+
+💻 OPEN SOURCE
+KoalaSync was built by a solo developer who needed a fast, secure way to watch movies with friends. The code is fully transparent under the MIT license: audit it, fork it, improve it, or self-host your own relay server.
+
+Found a bug or have a feature idea? Open an issue on GitHub. Contributions and code reviews are always welcome.
+
+• Website: https://sync.koalastuff.net
+• GitHub: https://github.com/Shik3i/KoalaSync
@@ -21,14 +21,14 @@ KoalaSync is a specialized tool for **synchronized video playback** across multi
 - `extension/`: Browser Extension (Chrome & Firefox, Manifest V3). Contains background service worker, content scripts, and popup UI.
 - `server/`: Node.js Relay Server using Socket.IO (WebSocket-only).
 - `website/`: **Landing Page** & Invitation Bridge (Marketing, Tutorials, and Downloads).
-  - **`build.js`**: Zero-dependency static site compiler. Translates `template.html` + `locales/*.json` → `www/`. Also minifies CSS/JS automatically.
-  - **`www/` is auto-generated**: Never edit files in `www/` directly. Always edit source files (`template.html`, `style.css`, `app.js`, `lang-init.js`, `locales/*.json`) and run `node website/build.js` to regenerate. CSS/JS are output as `.min.*` files — a built-in cleanup step removes stale artifacts on each build.
+  - **`build.cjs`**: Zero-dependency static site compiler. Translates `template.html` + `locales/*.json` → `www/`. Also minifies CSS/JS automatically.
+  - **`www/` is auto-generated**: Never edit files in `www/` directly. Always edit source files (`template.html`, `style.css`, `app.js`, `lang-init.js`, `locales/*.json`) and run `node website/build.cjs` to regenerate. CSS/JS are output as `.min.*` files — a built-in cleanup step removes stale artifacts on each build.
 - `shared/`: **Single Source of Truth** for protocol constants and event names.
- `scripts/`: Development utilities (e.g., `build-extension.js`).
+- `scripts/`: Development utilities (e.g., `build-extension.cjs`).
 - `docker-compose.yml`: Root-level orchestration for the relay server.

 > [!IMPORTANT]
-> **Single Source of Truth**: `shared/constants.js` and `shared/blacklist.js` are the master files. They must be synchronized to the `extension/shared/` directory using `node scripts/build-extension.js`. 
+> **Single Source of Truth**: `shared/constants.js` and `shared/blacklist.js` are the master files. They must be synchronized to the `extension/shared/` directory using `node scripts/build-extension.cjs`. 
 > - **Extension Modules** (`background.js`, `popup.js`) import directly from `./shared/constants.js`.
 > - **Content Scripts** (`content.js`) use a **marker-injected synchronous copy** of the constants. The build script automatically replaces the marked blocks — no manual mirroring needed.

@@ -41,7 +41,7 @@ Before touching any code, you MUST read the following documents in order:
 ## 4. The "Vanilla JS Mirror" Pattern
 To avoid boot-time race conditions in Manifest V3 without a bundler, the following architectural trade-off is enforced:
 - **Synchronous Execution**: `content.js` MUST execute synchronously to catch early media events. 
- **Automated Injection**: The build script (`node scripts/build-extension.js`) automatically injects `EVENTS` and `HEARTBEAT_INTERVAL` into `content.js` using marker-based replacement (see `../scripts/README.md` for marker details).
+- **Automated Injection**: The build script (`node scripts/build-extension.cjs`) automatically injects `EVENTS` and `HEARTBEAT_INTERVAL` into `content.js` using marker-based replacement (see `../scripts/README.md` for marker details).
 - **Maintenance**: After modifying `shared/constants.js`, simply run the build script. No manual mirroring is required.

 ## 5. File Responsibility Map
@@ -137,18 +137,18 @@ Before starting any task, committing, or pushing, you **MUST** run `git pull --r

 ### Adding a Protocol Event
 1. Add the event name to `shared/constants.js`.
-2. Run the build script (`node scripts/build-extension.js`).
+2. Run the build script (`node scripts/build-extension.cjs`).
 3. Implement the handler in `server/index.js` and `background.js`.

 ### Making Website Changes
 1. Edit source files in `website/` (`template.html`, `style.css`, `app.js`, `lang-init.js`, or `locales/*.json`).
-2. Run the compiler: `node website/build.js`. This generates the multilingual pages in `www/` and minifies CSS/JS.
+2. Run the compiler: `node website/build.cjs`. This generates the multilingual pages in `www/` and minifies CSS/JS.
 3. Verify the output: `node --check website/www/app.js && node --check website/www/lang-init.js`.
 4. Test locally: `npx serve website/www` or `python3 -m http.server 8080 -d website/www`.
 5. Commit both source changes and the updated `www/` output.

 ### Testing Locally
-1. Run the build script: `node scripts/build-extension.js`.
+1. Run the build script: `node scripts/build-extension.cjs`.
 2. Load `dist/chrome/` as an "Unpacked Extension" in Chrome (or `dist/firefox/` in Firefox).
 3. Start the server from the root: `docker-compose up --build`.
 4. Use **different browser profiles** or vendors to test multi-peer logic.
@@ -2,9 +2,10 @@

 This document describes the communication flows and internal logic of the KoalaSync system.

-## 1. Extension Startup & Connection
- **Initialization**: On startup, `background.js` reads settings (Server URL, Username, Last Room) from `chrome.storage.sync`.
- **WebSocket Handshake**:
+## 1. Extension Connection (Lazy Connect)
+- **Initialization**: On startup, `background.js` reads settings (Server URL, Username, Last Room) from `chrome.storage.sync`. No WebSocket connection is established at this point.
+- **On-Demand Connection**: The extension only connects when needed — either the user opens the popup with saved room credentials, or when actively in a room. When not in a room, no connection exists. This improves privacy (IP not exposed while idle) and reduces battery/network usage.
+- **WebSocket Handshake (when connecting)**:
  1. Background creates a `new WebSocket` to `/socket.io/?EIO=4&transport=websocket&version=1.0.0`.
  2. Server performs security checks:
     - **IP Rate Limit**: Checks if the IP has exceeded connection limits.
@@ -45,7 +46,7 @@ To maintain a clean room state and eliminate "Ghost Peers":
 - **Video Heartbeat (Content)**: Every 15 seconds, `content.js` sends current playback metadata (time, title, state) if a video is found.
 - **Server Pruning**: The server runs a "Reaper" every 2 minutes. If a peer has sent **zero** activity (no events and no heartbeats) for 5 minutes, they are forcefully disconnected.
 - **Immediate Cleanup**: Rooms are deleted instantly when the last peer leaves or disconnects.
- **Reconnect Strategy**: Aggressive backoff — 500ms base, 1.5x multiplier, capped at 5s. Max 20 attempts before marking as failed. Events are queued during disconnect and flushed after namespace rejoin.
+- **Reconnect Strategy (while in room)**: Aggressive backoff — 500ms base, 1.5x multiplier, capped at 5s. Max 20 attempts before marking as failed. Events are queued during disconnect and flushed after namespace rejoin. When not in a room, no reconnection occurs.

 > [!CAUTION]
 > **Identity Rule**: Differentiate between `peerId` and `socket.id`. Use `socket.id` exclusively for ephemeral transport routing on the server. Use `peerId` exclusively for identity, state management, and room tracking across the stack.
@@ -70,5 +71,5 @@ KoalaSync uses a megaphone routing approach to minimize server logic:
 To maintain a "Single Source of Truth" across the server and extension without using a bundler:
 - **Relay Server & Extension Modules**: `background.js` and `popup.js` import constants directly from `shared/constants.js`.
 - **Content Scripts**: To ensure zero-latency execution, `content.js` uses a synchronized copy of `EVENTS` and constants.
- **Automation**: The `node scripts/build-extension.js` script automatically injects these constants into `content.js` during the build process, eliminating the risk of manual mirror mismatch.
+- **Automation**: The `npm run build:extension` script automatically injects `EVENTS`, `HEARTBEAT_INTERVAL`, and `episode-utils.js` functions into `content.js` during the build process, eliminating the risk of manual mirror mismatch.
 - **Verification**: Any protocol change is automatically propagated across the stack by running the build script.
@@ -4,10 +4,142 @@ All notable changes to the KoalaSync browser extension and relay server.

 ---

+## [v2.4.1] — 2026-06-19
+
+### Added
+- **Extension: Onboarding tour now has a closing step** — The first-run tour ends on a dedicated "You're all set!" card (the `ONBOARDING_5` copy that already existed in all 13 locales but was never shown). The tour no longer stops abruptly on the username step.
+- **Extension: One-click invite from the empty peer list** — The "No peers yet" state now shows a **📋 Invite Link** button that copies the invite link to the clipboard, so users can share it without hunting for the field.
+
+### Changed
+- **Extension: Cleaner onboarding welcome** — Step 1 is now a centered welcome card instead of spotlighting the logo title. Added a guard so target-less tour steps center cleanly.
+- **Website: Mobile comparison table** — The KoalaSync vs Teleparty table stacks into per-feature cards on phones instead of forcing horizontal scrolling; feature descriptions are shown again on mobile.
+
+### Fixed
+- **Extension: Onboarding step counter/progress placeholders** — Static `Step 1 of 3` / 33% fallbacks in `popup.html` corrected to match the actual 5-step tour (`Step 1 of 5` / 20%).
+- **Website: Mobile navigation restored** — The header hamburger menu was hidden by a `display:none !important` rule, leaving the nav links unreachable on phones. Re-enabled, with spacing kept comfortable down to ~320px.
+- **Website: Hero alignment on mobile** — A fixed-width extension mockup forced the hero grid column wider than the container, shifting all hero content off-center (larger left margin than right). The mockup is now responsive (`width:100%/max-width` + `minmax(0,1fr)` grid track).
+- **Website: Reveal-animation fallback** — Added a `<noscript>` style fallback and `IntersectionObserver` feature guards so scroll-revealed content can never stay invisible if JavaScript is disabled or unsupported.
+
+## [v2.4.0] — 2026-06-16
+
+### Added
+- **Extension: Lazy WebSocket connection** — The extension no longer maintains a permanent WebSocket connection to the relay server. Instead, the connection is established only when actively in a room or when the popup is opened with a saved room configuration. This improves privacy (IP is not exposed while idle), reduces battery/network usage, and prevents the server from tracking online status of inactive users. Automatic reconnect is guaranteed while in a room — zero behavior change during active sync sessions. See `connectIntent` flag in `background.js`.
+- **Extension: Episode title regex unification** — `extractEpisodeId()` had inconsistent regex patterns between `background.js` and `content.js`. The content script correctly matched Crunchyroll-style separators (`S01/E01`) while the service worker's stricter pattern (`[\s\-\.]*`) silently rejected them, causing episode lobby sync failures. Now unified to `[^a-zA-Z0-9]*` via shared `episode-utils.js`.
+- **Unit tests: `rate-limiter` and `episode-utils`** — 12 test groups for rate-limit functions and 30+ assertions for episode title parsing, covering all 6 separator types (dash, dot, slash, colon, comma, space). Run automatically via `npm run verify`.
+
+### Changed
+- **Server: Rate limiter extracted to `rate-limiter.js`** — 6 rate-limit functions, all rate-limit Maps, and cleanup intervals moved from `index.js` (149 lines). `index.js` now imports via facade pattern with re-exports for backward compatibility.
+- **Extension: Episode utilities extracted to `episode-utils.js`** — `extractEpisodeId()` and `sameEpisode()` deduplicated from `background.js` and `content.js`. The shared module is imported as an ES module by the service worker and injected into the content script IIFE by the build script.
+- **Build: `"type": "module"` in root `package.json`** — All scripts standardized to ESM (`.mjs`) or explicitly CommonJS (`.cjs`). Eliminated Node.js `MODULE_TYPELESS_PACKAGE_JSON` warnings.
+- **Build: 4 CJS scripts renamed to `.cjs`** — `build-extension.js`, `test-content-video-finder.js`, `test-locales.js`, `website/build.js`.
+
+### Fixed
+- **Server: npm audit resolved** — `ws` package vulnerability (CVE-2024-37890) fixed. Zero vulnerabilities in production dependencies.
+- **Pop-up: Connection status flicker fixed** — Removed hardcoded `disconnected` state on every pop-up open. Status now reflects actual background state from the first frame.
+- **Pop-up: Join button timeout improved** — No longer blindly re-enables after 15s. Polls connection status and extends window if still connecting.
+- **Pop-up: Validation failure state cleanup** — Custom server URL validation errors now properly reset `isProcessingConnection` and `joinBtnTimeout`.
+- **Extension: `WEB_JOIN_REQUEST` channel leak fixed** — Missing `sendResponse()` call when already in the target room.
+- **Extension: `LEAVE_ROOM` now clears `roomId` from storage** — Prevents phantom auto-reconnect on browser restart after explicit leave.
+- **Extension: Reconnect attempt counters reset on leave** — Prevents stale `reconnecting` status display after intentional disconnect.
+
+## [v2.3.2] — 2026-06-16
+
+### Changed
+- **Extension: Refined Spanish, Italian, and Portuguese translations**: Complete manual review and improvement of all Spanish (`es`), Italian (`it`), Portuguese — Brazil (`pt-BR`), and Portuguese — Portugal (`pt`) locale files for both the extension UI and the landing website. Thanks to [@Kaia-Alenia](https://github.com/Kaia-Alenia) for the native-quality translations.
+
+### Fixed
+- **Extension: Locale typos and corrupted characters fixed**: Repaired a Korean refresh button label (`Refreschi` → `새로고침`), a corrupted Korean connection status string (`연kel` → `연결`), a Korean character contaminating a Japanese string (`의` → `の`), and a Dutch typo (`cmmuniceren` → `communiceren`).
+- **Server: Admin token length leak fixed (timing side-channel)**: `isAdminMetricsAuthorized()` returned early when the provided buffer had a different length than the expected token, leaking the token length via response timing. Now `crypto.timingSafeEqual` runs in constant time on every attempt regardless of length match. Reported by [@Kaia-Alenia](https://github.com/Kaia-Alenia).
+
+---
+
+## [v2.3.1] — 2026-06-15
+
+### Fixed
+- **Server: Concurrent peer join race condition and teardown error handling**
+
+### Changed
+- **Server: Smart unhandled rejection handling (exits after 5/min instead of 1)**
+- **Server: Optimized admin health metrics allocation**
+
+---
+
+## [v2.3.0] — 2026-06-14
+
+### Added
+- **Extension: New Interactive Onboarding Tour**: A fully redesigned, interactive step-by-step onboarding experience.
+- **Extension: Auto-Switch to Sync Tab**: The UI now intelligently switches to the Sync tab when you join a room to guide video selection.
+- **Extension: Uninstall URL Integration**: Prepared an uninstall URL setup that works natively across Chrome and Firefox, cleanly attaching browser context for analytics.
+
+### Fixed
+- **Extension: Infinite Seek Loop Prevention**: Replaced the fragile time-based seek suppression with an exact target-time verification mechanism, entirely eliminating infinite seek loops on slow buffers.
+- **Extension: Zombie Connections Resolved**: Implemented a forced disconnect upon ping timeouts, ensuring the extension reliably auto-reconnects when the WebSocket hangs in a half-open state.
+- **Extension: Room Switching Architecture**: Joining a new room while already connected now explicitly severs the old connection first, preventing state cross-contamination. 
+- **Extension: Join/Leave Race Conditions**: Added UI locks to prevent users from accidentally sending conflicting connection commands via rapid double-clicking.
+- **Extension: Same-Room Invite Bypass**: Clicking an invite link for the room you are currently in no longer triggers a redundant reconnect, instead instantly confirming the join.
+- **Extension: Audio settings now propagate immediately to video tabs**: Changes made in the audio options page are now instantly applied to the active video tab. Previously, settings saved to `chrome.storage.local` were not picked up by the background listener, which only watched `chrome.storage.sync`.
+- **Extension: Audio compressor now logs enable/disable state and resume failures**: The compressor reports when it is activated or bypassed, and warns if the `AudioContext` cannot be resumed (e.g. browser autoplay policy requires a user gesture on the page first).
+- **Extension: Video heartbeat no longer sent when alone in a room**: The full media metadata `PEER_STATUS` is now only emitted when other peers are present. The session keepalive (background heartbeat) continues to run unaffected, preventing the server reaper from disconnecting idle peers.
+- **Server: Increased `failedAuthAttempts` eviction threshold from 50k to 200k**: Reduces frequency of expensive batch evictions under high auth-failure volumes, smoothing heap usage.
+
+---
+
+## [v2.2.4] — 2026-06-10
+
+### Fixed
+- **Extension: Error notifications now respect `browserNotifications` setting**: Server error events (e.g. "Server is restarting") no longer trigger a browser notification when the user has disabled notifications in the extension settings.
+- **Server: Misleading reconnect message corrected**: The graceful shutdown message no longer tells users to manually reconnect — the extension handles this automatically.
+
+---
+
+## [v2.2.3] — 2026-06-10
+
+### Added
+- **Artifact Attestations (Supply Chain Security)**: All release artifacts (Docker images, extension ZIPs) are now published with signed [SLSA provenance attestations](https://docs.github.com/en/actions/how-tos/secure-your-work/use-artifact-attestations) via `actions/attest@v4`. Anyone can verify that an artifact was built from this repository using `gh attestation verify`.
+- **Admin health: `rateLimits.denied` counters**: New rolling counters track actual rate-limit denials (429 responses), separate from `rateLimits.trackedClients` which reports unique IPs in the tracking window.
+- **Docker HEALTHCHECK**: Container health is now checked every 30s via `GET /health`.
+- **`npm start` script**: Server can now be started with `npm start`.
+
+### Fixed
+- **Server: `activeLobby` no longer silently overwritten**: If a second peer sends `EPISODE_LOBBY` while a lobby is already active, the request is now ignored instead of destroying the first peer's lobby.
+- **CORS log sanitization**: Rejected origin headers are sanitized (`\r\n` stripped) to prevent log injection.
+- **Extension: pagehide resource leak**: `keepAlivePort`, `lobbyPollTimer`, heartbeats, and `MutationObserver` are now properly cleaned up when a tab is hidden or enters bfcache.
+- **Extension: unhandled storage rejections**: `chrome.storage.session.set()` calls in the disconnect handler now have `.catch(() => {})`.
+- **`'Pixel'` duplicate in name generator**: Second occurrence replaced with `'Nitro'` for better name diversity.
+- **`'opposum'` typo**: Corrected to `'opossum'` in the emoji map and added `'Opossum'` to `USERNAME_NOUNS`.
+- **Test reliability**: `test-server-routes.mjs` now sets `ADMIN_METRICS_TOKEN` before importing the server module, fixing standalone test execution.
+- **`MAX_PEERS_PER_ROOM` konsistent**: `.env` auf 25 gesetzt (wie `.env.example`).
+- **pt-BR.json duplicate removed**: Duplicate `FOOTER_DISCLAIMER` key removed from website locale.
+
+### Changed
+- **Admin health: `rateLimitEntries` renamed to `rateLimits.trackedClients`**: The field now accurately describes that it tracks unique clients in the rate-limit window, not denial counts. Update your json_exporter/Grafana config accordingly.
+- **README restructured**: Sections reordered by progressive technical depth. New "Supply Chain Security" subsection under "For Developers & Self-Hosters" with verification commands.
+
+---
+
+## [v2.2.2] — 2026-06-09
+
+### Added
+- **Chrome Web Store i18n Support**: Added `default_locale: "en"` to manifest and created `_locales/*/messages.json` for all 13 supported languages. This unlocks the language selection dropdown in the Chrome Web Store dashboard, allowing translated store listings (title, description) per locale. The extension's own UI translations (`locales/*.json` + `i18n.js`) remain unchanged.
+- **Locale test coverage**: Extended `scripts/test-locales.js` to validate all `_locales/*/messages.json` files (correct format, required keys, no duplicates) and verify `default_locale` is set in the manifest.
+
+### Fixed
+- **Copy Logs button alignment**: Removed stray `margin-top: 8px` inherited from `.secondary` class that pushed the button 8px down in the connection status row.
+
+---
+
+## [v2.2.1] — 2026-06-09
+
+### Added
+- **Server Ping Display**: Measures round-trip latency to the relay server via application-level ping/pong events. The extension sends `PING { t }` every 15 seconds; the server responds with `PONG { t }`. Round-trip time is calculated client-side and displayed in the Status tab, color-coded (<50ms green, 50–150ms yellow, >150ms red). No ping value is shown when disconnected or if the server does not respond within 5 seconds.
+- **Peer Ping Response (Future-Proof)**: The extension can now respond to incoming `PING { t, sender }` events from other peers by sending back `PONG { t, target: sender }`. The relay server forwards `PING` to the target peer and routes `PONG` back to the original sender. Both client and server validate that peers are in the same room before forwarding/routing. Peer-to-peer ping initiation will be activated in a future extension update without requiring a server restart.
+
+---
+
 ## [v2.2.0] — 2026-06-08

 ### Added
- **Web Audio API Compressor**: Built-in audio dynamic range compression with four presets (Recommended, Dynamic Range, Vocal Enhancement, Smooth) and fully customizable sliders (threshold, ratio, knee, attack, release, makeup gain). Uses dry/wet crossfade (40ms linear ramp) to avoid clicks. Configured via the new Audio Options page accessible from the Settings tab.
+- **Web Audio API Compressor**: Built-in audio dynamic range compression with four presets (Recommended, Dynamic Range, Vocal Enhancement, Smooth) and fully customizable sliders (threshold, ratio, knee, attack, release). Uses dry/wet crossfade (40ms linear ramp) to avoid clicks. Configured via the new Audio Options page accessible from the Settings tab.
 - **Audio Options Page** (`audio-options.html`): Dedicated settings page with master toggle, compressor preset selector, real-time custom sliders, and equalizer placeholder. Dark theme matching the popup design.
 - **Feature Hint System**: Generic `dismissedHints` array in sync storage for announcing new features. First hint highlights the Audio Options entry in Settings. Extensible for future features.

@@ -16,9 +16,9 @@ This guide walks through the complete user flow of KoalaSync, from creating a ro

 ## Step 2: Connecting to the Relay Server

-When you open the extension popup, the background service worker connects to the relay server:
+When you open the extension popup (with saved room credentials) or when a saved room configuration exists from a previous session, the background service worker connects to the relay server:

-1. **WebSocket Handshake**: `background.js` opens a WebSocket to `wss://syncserver.koalastuff.net/socket.io/?EIO=4&transport=websocket`.
+1. **WebSocket Handshake** (on demand): `background.js` opens a WebSocket to `wss://syncserver.koalastuff.net/socket.io/?EIO=4&transport=websocket` only when needed (popup opened or active room).
 2. **Security Checks** (server-side):
   - The server checks the client's **IP rate limit** (max 10 connections per 60 seconds).
   - The server validates the **authentication token** (hardcoded in `shared/constants.js`) to verify this is a legitimate KoalaSync client.
@@ -155,7 +155,7 @@ While in a room, two heartbeats keep the session alive:

 | Heartbeat | Interval | Source | Purpose |
 |:----------|:---------|:-------|:--------|
-| **Background** | 30 seconds | `background.js` | Signals "I'm still connected" and triggers aggressive reconnect (500ms base, max 5s) |
+| **Background** | 30 seconds | `background.js` | While connected, signals "I'm still connected" and triggers automatic reconnect (500ms base, max 5s). No heartbeats fire when idle (lazy connect). |
 | **Content** | 15 seconds | `content.js` | Sends video metadata: `currentTime`, `mediaTitle`, `playbackState`, `volume`, `muted` |

 - **Server Reaper**: Every 2 minutes, the server checks for peers with no activity for 5+ minutes and disconnects them ("dead peer pruning").
@@ -33,7 +33,7 @@ The browser extension requires the following permissions:
 - `storage`: To remember your local preferences (username, server URL, room settings).
 - `tabs` & `scripting`: To detect and control video elements on the pages you choose to sync.
 - `<all_urls>` (host permission): Required to detect `<video>` elements on any website the user chooses to synchronize. The extension only activates on the specific tab the user has actively selected — it does not scan, monitor, or interact with any other tabs or pages.
- `alarms`: To keep the background service worker alive during active sync sessions.
+- `alarms`: To keep the background service worker alive during active sync sessions (the extension only stays connected while you are in a room).
 - `notifications`: To display sync status updates (e.g., "Peer joined", "Force Sync initiated").
 - **No History Access**: We do not read, store, or transmit your browsing history. We only interact with the specific tab you have actively selected for synchronization.

@@ -5,3 +5,4 @@ This directory contains deep-dives into the KoalaSync protocol and architecture.
 - [HOW_IT_WORKS.md](HOW_IT_WORKS.md): Step-by-step walkthrough of every user flow, from room creation to synchronized playback. Ideal for store reviewers and manual testers.
 - [ARCHITECTURE.md](ARCHITECTURE.md): Communication flows, Dual Heartbeat, and Sync logic.
 - [SYNC_GUIDE.md](SYNC_GUIDE.md): Protocol constants and sync requirements.
+- [TRANSLATION.md](TRANSLATION.md): Translation and localization guide for the extension and website.
@@ -1,14 +1,82 @@
 # KoalaSync Roadmap

-This document tracks future technical plans and optimizations for the KoalaSync system.
+> Feature priorities, planned work, backlog, and rejected ideas for KoalaSync.

 ---

-## Planned Optimizations & Technical Roadmap
+## Status Legend

-### 1. Split large JavaScript files (> 800 lines) into smaller modules
-* **Category**: Maintainability / AI Context Optimization
-* **Background**: Core files like `background.js` and `popup.js` have grown large and exceed 800 lines. This makes manual debugging harder and wastes context window space for AI models.
-* **Planned solution**:
+| Badge | Meaning |
+|---|---|
+| 🚧 In Progress | Currently being developed |
+| 📋 Planned | Prioritized for an upcoming phase |
+| 💡 Backlog | Under evaluation, not yet prioritized |
+| ❌ Rejected | Declined (with rationale) |
+| ✅ Completed | Shipped |
+
+---
+
+## 🚧 In Progress
+
+*Currently being worked on.*
+
+| Feature | Priority | Area |
+|---|---|---|
+| *(none yet)* | | |
+
+---
+
+## 📋 Planned
+
+*Prioritized for upcoming phases.*
+
+### 1. Split large JavaScript files into smaller modules
+
+- **Priority:** P1
+- **Category:** Maintainability / AI Context Optimization
+- **Background:** Core files like `background.js` and `popup.js` have grown large and exceed 800 lines. This makes manual debugging harder and wastes context window space for AI models.
+- **Planned solution:**
  - Structurally split logic into separate focused modules (e.g., UI Renderer, Message Router, Storage Manager, Socket Client).
  - Use ES modules for clean separation and better reusability.
+
+### 2. Invite link with target URL for auto-redirect
+
+- **Priority:** P2
+- **Category:** UX / Ease of Sharing
+- **Background:** The invite link currently only contains the room ID. The invited person has to manually open the page. Ideally, the link would include the shared tab's URL so the invitee gets redirected to the right page and the tab is auto-selected (auto-matching via tab title already exists).
+- **Known challenges:**
+  - Many streaming sites (e.g., Emby, Jellyfin) don't have unique URLs per content — once inside the player, the URL stays the same.
+  - Dozens of such edge cases exist; a generic solution is difficult.
+  - Would likely need site-specific extractor logic (similar to the existing sync service adapters).
+- **Possible approaches:**
+  - Fallback: if no unique URL can be determined, only pass the tab title.
+  - Site-specific URL extraction for known services.
+
+---
+
+## 💡 Backlog
+
+*Ideas and feature requests under evaluation.*
+
+### In-room chat overlay (like TeleParty)
+
+- **Priority:** P3
+- **Category:** Social / Communication
+- **Background:** A collapsible chat panel to the right of the video (or as an overlay) allowing text-based communication with everyone in the room.
+- **Why backlog (still uncertain):**
+  - **Use case:** No strong personal need — with chat, latency matters less than with voice; async communication tolerates a few seconds of delay.
+  - **Complexity:** Relatively large feature (UI + message persistence + possibly history).
+  - **Legal/moderation:** Unclear what moderation requirements would apply if users can exchange chat messages. Could be relevant depending on jurisdiction.
+- **Status:** Under evaluation, may come later.
+
+---
+
+## ❌ Rejected
+
+*Declined features with rationale — keeps decisions documented so they don't get re-debated.*
+
+| Feature | Reason |
+|---|---|
+| *(none yet)* | |
+
+
@@ -17,13 +17,15 @@ You MUST run the build script in any of the following scenarios:

 Run the Node.js build script from the repository root:
 ```bash
-node scripts/build-extension.js
+node scripts/build-extension.cjs
+# or simply:
+npm run build:extension
 ```

 ## What does it do?
 The build script performs the following actions:
 1. Synchronizes protocol constants by copying `shared/constants.js`, `shared/blacklist.js`, and `shared/README.md` into `extension/shared/`.
-2. Injects `EVENTS` and `HEARTBEAT_INTERVAL` into `content.js` via marker-based replacement.
+2. Injects `EVENTS`, `HEARTBEAT_INTERVAL`, and `episode-utils.js` functions (`extractEpisodeId`, `sameEpisode`) into `content.js` via marker-based replacement.
 3. Compiles browser-specific manifest files.
 4. Packages the final ready-to-publish extension artifacts for Chrome and Firefox into the `dist/` directory.

@@ -4,19 +4,19 @@ This document tracks which streaming platforms and media servers have been teste

 | Service | Sync Works | Media Title | Episode Auto-Sync | Notes |
 |---------|:----------:|:-----------:|:-----------------:|-------|
-| **YouTube** | ✅ Full | ✅ Full | ❌ | Best-in-class support. Native player API, reliable title detection. |
-| **Twitch** | ✅ Full | ✅ Full | ❌ | Live-only platform. Tested on regular streams. |
-| **Netflix** | ✅ Full | ⚠️ Hidden | ⚠️ Manual | Sync works perfectly, but DRM prevents media title detection. Episode transitions may require manual lobby. |
-| **Emby** | ✅ Full | ✅ Full | ✅ Full | Self-hosted. Full HTML5 player access. |
-| **Jellyfin** | ✅ Full | ✅ Full | ✅ Full | Self-hosted. Full HTML5 player access. |
-| **Plex** | Not tested | Not tested | Not tested | Community reports indicate compatibility via HTML5 player mode. |
-| **Disney+** | Not tested | Not tested | Not tested | Widevine DRM may restrict title detection similar to Netflix. |
-| **Prime Video** | ⚠️ Partial | ⚠️ Partial | ❌ | Video elements detected (2 on page, picks larger one). Playback state + time readable. However, the preview/trailer video may be selected instead of the main content. Play/Pause commands may not reach the correct player. Title detection from MediaSession API may work for some content. |
+| **YouTube** | ✅ Full | ✅ Full | ❌ | Individual videos, not episodes — no episode auto-sync. |
+| **Twitch** | ✅ Full | ✅ Full | ❌ | Individual streams/VODs, not episodes — no episode auto-sync. |
+| **Netflix** | ✅ Full | ❌ | ❌ | No media title exposed. |
+| **Emby** | ✅ Full | ✅ Full | ✅ Full | Best-in-class support. |
+| **Jellyfin** | ✅ Full | ✅ Full | ✅ Full | — |
+| **Plex** | Not tested | Not tested | Not tested | — |
+| **Disney+** | ✅ Full | ⚠️ Partial | ❌ | Series title only (e.g. "The Simpsons"), no episode info. |
+| **Prime Video** | ✅ Full  | ✅ Full  | ❌ | — |
 | **HBO Max / Max** | Not tested | Not tested | Not tested | — |
 | **Crunchyroll** | Not tested | Not tested | Not tested | — |
 | **Vimeo** | Not tested | Not tested | Not tested | — |
 | **Dailymotion** | Not tested | Not tested | Not tested | — |
-| **ARD / ZDF Mediathek** | Not tested | Not tested | Not tested | German public broadcasters. HTML5 players expected to work. |
+| **ARD / ZDF Mediathek** | Not tested | Not tested | Not tested | — |

 ## Legend

@@ -39,7 +39,7 @@ Tested a service that's not listed? Found different behavior than documented?
 KoalaSync works on any website with a **standard HTML5 `<video>` element** that allows script injection. 

 Limited functionality on certain platforms is typically caused by:
- **DRM/Copy Protection** (e.g., Widevine on Netflix, Disney+) which restricts access to media metadata like title and playback state
+- **DRM/Copy Protection** (e.g., Widevine on Netflix) which restricts access to media metadata like title and playback state
 - **Shadow DOM encapsulation** that hides video elements from content scripts
 - **Strict Content Security Policies** (CSP) that block script injection

@@ -0,0 +1,105 @@
+# KoalaSync Translation & Localization Guide
+
+Welcome to the **KoalaSync** translation guide! We rely on the open-source community to make KoalaSync accessible to users worldwide.
+
+KoalaSync is split into two independent translation areas. You can translate either one, or both:
+1. **The Browser Extension** (`extension/locales/`): The core product that users interact with daily.
+2. **The Website** (`website/locales/`): The landing page and invitation bridge.
+
+---
+
+## 📊 Supported Languages Dashboard
+
+We divide supported languages into two tiers: **Core Languages** (fully hand-crafted and audited by native speakers) and **Extended Languages** (auto-generated using translation models to expand initial coverage).
+
+> [!TIP]
+> **Help Us Improve!**
+> We welcome community contributions to audit "Auto-Generated" translations and elevate them to "Verified" status.
+
+| Language Code | Language Name | Verification Status | Rationale / Context |
+| :--- | :--- | :--- | :--- |
+| `en` | 🇬🇧 **English** | `100% Manually Verified` | Global default language (Verified by developer) |
+| `de` | 🇩🇪 **German** | `100% Manually Verified` | Developer's native language |
+| `fr` | 🇫🇷 **French** | `Auto-Generated` | Needs manual native review and polishing |
+| `es` | 🇪🇸 **Spanish** | `100% Manually Verified` | Manual native review by Alenia Studios |
+| `pt-BR` | 🇧🇷 **Portuguese (Brasil)** | `100% Manually Verified` | Manual native review by Alenia Studios |
+| `ru` | 🇷🇺 **Russian** | `Auto-Generated` | Needs manual native review and polishing |
+| `it` | 🇮🇹 **Italian** | `100% Manually Verified` | Manual native review by Alenia Studios |
+| `pl` | 🇵🇱 **Polish** | `Auto-Generated` | Needs manual native review and polishing |
+| `tr` | 🇹🇷 **Turkish** | `Auto-Generated` | Needs manual native review and polishing |
+| `nl` | 🇳🇱 **Dutch** | `Auto-Generated` | Needs manual native review and polishing |
+| `ja` | 🇯🇵 **Japanese** | `Auto-Generated` | Needs manual native review and polishing |
+| `ko` | 🇰🇷 **Korean** | `Auto-Generated` | Needs manual native review and polishing |
+| `pt` | 🇵🇹 **European Portuguese** | `100% Manually Verified` | Manual native review by Alenia Studios |
+
+> [!WARNING]
+> **Autogeneration Quality Rule**
+> Any newly contributed languages must be marked as `"Auto-Generated"` in this table until fully reviewed and signed off by a native speaker in a pull request.
+
+---
+
+## 🛠️ How to Translate KoalaSync
+
+Here is the exact step-by-step process for contributing translations.
+
+### Step 1: Fork and Clone the Repository
+If you are an external contributor, start with the standard Open Source workflow:
+1. Click the "Fork" button on GitHub to create your own copy of the repository.
+2. Clone your fork locally: `git clone https://github.com/YOUR-USERNAME/KoalaSync.git`
+3. Create a branch: `git checkout -b translation/my-language`
+
+### Step 2: Translate the Extension
+The browser extension handles real-time syncing, settings, and popups.
+1. Navigate to [`extension/locales/`](file:///Users/koala/Documents/Workspaces/KoalaSync/extension/locales/).
+2. Edit an existing `[lang].json` or copy `en.json` to create a new one (e.g., `it.json`).
+3. Translate all the string values. **Do not change the JSON keys.**
+
+### Step 3: Translate the Website
+The website hosts the landing page and invitation bridge.
+1. Navigate to [`website/locales/`](file:///Users/koala/Documents/Workspaces/KoalaSync/website/locales/).
+2. Edit an existing `[lang].json` or copy `en.json` to create a new one.
+3. Translate all the string values. **Do not change the JSON keys.**
+4. If creating a **brand new language**, configure the metadata at the top of your JSON file:
+   ```json
+   {
+     "LANG_CODE": "it",
+     "HTML_CLASS": "lang-it",
+     "CANONICAL_PATH": "it/",
+     "LANG_TOGGLE_URL": "../",
+     "LANG_TOGGLE_TEXT": "EN"
+   }
+   ```
+5. If creating a **brand new language**, register it in `website/build.cjs` by adding it to the `languages` array.
+
+### Step 4: Verify Locally
+Ensure your JSON files are valid and all keys match the English baseline. Open your terminal in the KoalaSync root folder and run:
+```bash
+# Tests the extension locales for missing keys or syntax errors
+node scripts/test-locales.cjs
+
+# Tests the website locales for missing keys or syntax errors
+node scripts/test-website-locales.mjs
+
+# Builds the website with your new translations
+node website/build.cjs
+```
+*Note: If you receive any errors about missing keys or `TODO` placeholders, please fix them before submitting.*
+
+### Step 5: Commit and Pull Request
+1. Open this `TRANSLATION.md` file and add/update your language in the **Supported Languages Dashboard** above. Mark it as `100% Manually Verified` if you are a native speaker.
+2. Commit your changes: `git commit -m "Update Italian translations"`
+3. Push to your fork: `git push origin translation/my-language`
+4. Open a **Pull Request** on the main KoalaSync repository on GitHub.
+
+---
+
+## ⚖️ Strict Legal Exclusion Rule
+
+Our legal pages have strict constraints to protect user privacy and avoid regulatory liabilities.
+
+> [!IMPORTANT]
+> **DO NOT TRANSLATE LEGAL DOCUMENTS**
+> The legal notice ([impressum.html](file:///Users/koala/Documents/Workspaces/KoalaSync/website/impressum.html)) and privacy policy ([datenschutz.html](file:///Users/koala/Documents/Workspaces/KoalaSync/website/datenschutz.html)) **MUST remain exclusively in English and German**.
+> 
+> *   **Rationale:** Legal compliance under the European Union General Data Protection Regulation (GDPR) and the German Digital Services Act (DDG). Offering automated translations of legally binding notices introduces compliance risks due to potential mistranslations of liability limits.
+> *   **Technical Fallback:** Our system automatically falls back to **English** for legal pages if a user visits them in an unsupported language, so you do not need to worry about this.
@@ -8,6 +8,7 @@ export default [
      sourceType: "module",
      globals: {
        chrome: "readonly",
+        browser: "readonly",
        window: "readonly",
        document: "readonly",
        navigator: "readonly",
@@ -36,8 +37,10 @@ export default [
        URL: "readonly",
        URLSearchParams: "readonly",
        WebSocket: "readonly",
+        history: "readonly",
+        location: "readonly",
        self: "readonly",
-        process: "readonly"
+        process: "readonly",
      }
    },
    rules: {
@@ -55,7 +58,7 @@ export default [
    }
  },
  {
-    files: ["server/**/*.js", "scripts/**/*.js", "website/build.js"],
+    files: ["server/**/*.js", "scripts/**/*.js", "scripts/**/*.cjs", "website/build.cjs"],
    languageOptions: {
      globals: {
        require: "readonly",
@@ -54,26 +54,51 @@ modules:
        path: '{.memory.heapTotal}'
        help: "V8 engine heap total in bytes"

+      # Rate limiter tracking — unique clients currently in each tracking window
+      # (not rate-limit denials; these include legitimate traffic too)
+
      - name: koalasync_rate_limit_connections
-        path: '{.rateLimitEntries.connections}'
-        help: "Number of entries tracked in the connection rate limiter"
+        path: '{.rateLimits.trackedClients.connections}'
+        help: "Unique clients tracked in the connection rate limiter window"

      - name: koalasync_rate_limit_events
-        path: '{.rateLimitEntries.events}'
-        help: "Number of entries in the event rate limiter"
+        path: '{.rateLimits.trackedClients.events}'
+        help: "Unique sockets tracked in the event rate limiter window"

      - name: koalasync_rate_limit_health
-        path: '{.rateLimitEntries.health}'
-        help: "Number of entries in the health rate limiter"
+        path: '{.rateLimits.trackedClients.health}'
+        help: "Unique IPs tracked in the health endpoint rate limiter window"

      - name: koalasync_rate_limit_admin_metrics_auth
-        path: '{.rateLimitEntries.adminMetricsAuth}'
-        help: "Number of entries in the admin metrics auth rate limiter"
+        path: '{.rateLimits.trackedClients.adminMetricsAuth}'
+        help: "Unique IPs tracked in the admin metrics auth rate limiter window"

      - name: koalasync_rate_limit_auth_failures
-        path: '{.rateLimitEntries.authFailures}'
-        help: "Number of entries in the authentication failures cache"
+        path: '{.rateLimits.trackedClients.authFailures}'
+        help: "Unique IPs tracked in the authentication failures cache"

      - name: koalasync_rate_limit_room_list
-        path: '{.rateLimitEntries.roomList}'
-        help: "Number of entries in the room list cooldown cache"
+        path: '{.rateLimits.trackedClients.roomList}'
+        help: "Unique sockets in the room list cooldown cache"
+
+      # Actual rate-limit denials — incremented only when a 429 is served
+
+      - name: koalasync_rate_limit_denied_connections
+        path: '{.rateLimits.denied.connections}'
+        help: "Total connection attempts denied by rate limiter"
+
+      - name: koalasync_rate_limit_denied_events
+        path: '{.rateLimits.denied.events}'
+        help: "Total socket events denied by rate limiter"
+
+      - name: koalasync_rate_limit_denied_health
+        path: '{.rateLimits.denied.health}'
+        help: "Total health endpoint requests denied by rate limiter"
+
+      - name: koalasync_rate_limit_denied_admin_metrics_auth
+        path: '{.rateLimits.denied.adminMetricsAuth}'
+        help: "Total admin metrics auth attempts denied by rate limiter"
+
+      - name: koalasync_rate_limit_denied_room_list
+        path: '{.rateLimits.denied.roomList}'
+        help: "Total room list refresh requests denied by rate limiter"
@@ -6,9 +6,9 @@ A Manifest V3 Browser Extension (Chrome & Firefox) for synchronized video playba
 - **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.
+- **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 6 languages (`en`, `de`, `fr`, `es`, `pt-BR`, `ru`) with auto-detected fallback and dynamic on-the-fly language selectors.
+- **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
 1. **Room**: Manage connections, view active peers, and share invitation links.
@@ -26,7 +26,7 @@ KoalaSync requires `<all_urls>` permission to detect and interact with video ele
 ## Installation
 1. **Prepare Extension**: From the repository root, run:
   ```bash
-   node scripts/build-extension.js
+   npm run build:extension
   ```
 2. Open Chrome and go to `chrome://extensions/`.
 3. Enable **Developer mode** (top right).
@@ -35,6 +35,18 @@ KoalaSync requires `<all_urls>` permission to detect and interact with video ele
 ## Development
 If you modify `shared/constants.js`, you must synchronize the changes by running the build script from the root:
 ```bash
-node scripts/build-extension.js
+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 |
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Synchronisiere die Videowiedergabe auf YouTube, Netflix, Emby, Jellyfin und jeder HTML5-Seite in Echtzeit mit Freunden."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Synchronize video playback on YouTube, Netflix, Emby, Jellyfin, and any HTML5 site in real-time with friends."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Mira videos junto a tus amigos en perfecta sincronización. Compatible con Netflix, YouTube, Twitch, Prime Video, Disney+ y cualquier reproductor HTML5."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Synchronisez la lecture vidéo sur YouTube, Netflix, Emby, Jellyfin et tout site HTML5 en temps réel avec vos amis."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Sincronizza la riproduzione video su YouTube, Netflix, Emby, Jellyfin e qualsiasi sito HTML5 in tempo reale con gli amici."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "YouTube、Netflix、Emby、Jellyfin、その他HTML5サイトでの動画再生を友達とリアルタイムで同期します。"
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "YouTube, Netflix, Emby, Jellyfin 및 모든 HTML5 사이트에서 친구들과 실시간으로 비디오 재생을 동기화하세요."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Synchroniseer video-afspelen op YouTube, Netflix, Emby, Jellyfin en elke HTML5-site in realtime met vrienden."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Synchronizuj odtwarzanie wideo na YouTube, Netflix, Emby, Jellyfin i dowolnej stronie HTML5 w czasie rzeczywistym ze znajomymi."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Assista a vídeos junto com seus amigos em sincronia perfeita. Compatível com Netflix, YouTube, Twitch, Prime Video, Disney+ e qualquer player HTML5."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Veja vídeos em conjunto com os seus amigos em sincronia perfeita. Compatível com Netflix, YouTube, Twitch, Prime Video, Disney+ e qualquer leitor HTML5."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "Синхронизируйте воспроизведение видео на YouTube, Netflix, Emby, Jellyfin и любых HTML5-сайтах в реальном времени с друзьями."
+  }
+}
@@ -0,0 +1,8 @@
+{
+  "appName": {
+    "message": "KoalaSync"
+  },
+  "appDesc": {
+    "message": "YouTube, Netflix, Emby, Jellyfin ve herhangi bir HTML5 sitesinde video oynatmayı arkadaşlarınızla gerçek zamanlı olarak senkronize edin."
+  }
+}
@@ -1,7 +1,69 @@
 import { EVENTS, PROTOCOL_VERSION, OFFICIAL_SERVER_URL, OFFICIAL_SERVER_TOKEN, EPISODE_LOBBY_TIMEOUT, FORCE_SYNC_TIMEOUT } from './shared/constants.js';
 import { generateUsername } from './shared/names.js';
 import { loadLocale, getMessage, getSystemLanguage } from './i18n.js';
+import { sameEpisode } from './episode-utils.js';

+// --- Uninstall URL Initialization ---
+let uninstallURLInitPromise = null;
+
+async function initUninstallURL() {
+    if (uninstallURLInitPromise) {
+        return uninstallURLInitPromise;
+    }
+    
+    uninstallURLInitPromise = (async () => {
+        // --- UNINSTALL_URL_INJECT_START ---
+        const UNINSTALL_URL = ""; // Populated during build
+        const BROWSER_TYPE = "unknown";
+        // --- UNINSTALL_URL_INJECT_END ---
+        
+        if (UNINSTALL_URL && UNINSTALL_URL.trim() !== '') {
+            try {
+                if (typeof chrome === 'undefined' || !chrome.storage || !chrome.storage.local) {
+                    console.warn("Storage API not available, skipping uninstall URL token generation");
+                    return;
+                }
+
+                const data = await chrome.storage.local.get("koalaByeToken");
+                let token = data?.koalaByeToken;
+                
+                if (!token) {
+                    token = (typeof self.crypto !== 'undefined' && typeof self.crypto.randomUUID === 'function')
+                        ? self.crypto.randomUUID()
+                        : Math.random().toString(36).substring(2, 15) + Math.random().toString(36).substring(2, 15);
+                    await chrome.storage.local.set({ koalaByeToken: token });
+                }
+
+                const url = new URL(UNINSTALL_URL);
+                url.searchParams.set("browser", BROWSER_TYPE);
+                url.searchParams.set("t", token);
+                
+                const runtimeAPI = typeof browser !== 'undefined' ? browser.runtime : chrome.runtime;
+                if (runtimeAPI && runtimeAPI.setUninstallURL) {
+                    const result = runtimeAPI.setUninstallURL(url.href);
+                    // browser.runtime.setUninstallURL returns a Promise, handle rejection silently
+                    if (result && typeof result.catch === 'function') {
+                        result.catch(err => console.warn('Failed to set uninstall URL:', err));
+                    }
+                }
+            } catch (err) {
+                console.error("Failed to initialize uninstall URL:", err);
+            }
+        }
+    })();
+
+    return uninstallURLInitPromise;
+}
+
+chrome.runtime.onInstalled.addListener((details) => {
+    if (details.reason === 'install' || details.reason === 'update') {
+        initUninstallURL();
+    }
+});
+
+chrome.runtime.onStartup.addListener(() => {
+    initUninstallURL();
+});

 // --- State Management ---
 let socket = null;
@@ -23,6 +85,12 @@ const lastSeqBySender = {};               // senderId → last received seq (sta
 const activePorts = new Set();            // New: track active content ports for keep-alive
 let expectedAcksCount = 0;                // Snapshot of peerCount when initiating Force Sync

+// --- Ping / Latency ---
+let pingInterval = null;
+let pingTimeout = null;
+let pendingPingT = null;
+let currentPingMs = null;
+
 // --- Keep-Alive Port Listener ---
 chrome.runtime.onConnect.addListener((port) => {
    if (port.name === 'keepAlive') {
@@ -143,6 +211,7 @@ let reconnectAttempts = 0;
 let currentServerUrl = null;
 let roomIdleSince = null;
 let lastContentHeartbeatAt = null;
+let connectIntent = false;
 const MAX_RECONNECT_ATTEMPTS = 20;
 const _RECONNECT_BASE_DELAY = 500;
 const _RECONNECT_MAX_DELAY = 5000;
@@ -157,26 +226,6 @@ let forceSyncTimeout = null;
 let episodeLobby = null; // { expectedTitle, initiatorPeerId, readyPeers: [], createdAt }
 let episodeLobbyTimeout = null;

-// --- Episode Title Extraction (synced with content.js) ---
-function extractEpisodeId(title) {
-    if (!title || typeof title !== 'string') return null;
-    const se = title.match(/S(?:eason\s*)?(\d+)[\s\-\.]*E(?:pisode\s*)?(\d+)/i);
-    if (se) return `S${String(se[1]).padStart(2, '0')}E${String(se[2]).padStart(2, '0')}`;
-    const ep = title.match(/(?:Episode|Folge|Ep\.?|#)\s*(\d+)/i);
-    if (ep) return `EP${String(ep[1]).padStart(3, '0')}`;
-    return null;
-}
-
-function sameEpisode(titleA, titleB) {
-    if (!titleA && !titleB) return true; // Both unknown → assume same (backward compat)
-    if (!titleA || !titleB) return false; // One unknown, one known → different
-    const idA = extractEpisodeId(titleA);
-    const idB = extractEpisodeId(titleB);
-    if (idA && idB) return idA === idB; // Both have parseable IDs → compare IDs
-    if (idA || idB) return false;       // One has ID, other doesn't → different
-    return titleA === titleB;            // Neither has ID → exact string match
-}
-
 // --- Storage Utils ---

 /**
@@ -299,6 +348,7 @@ function forceDisconnect() {
        clearTimeout(forceSyncTimeout);
        forceSyncTimeout = null;
    }
+    stopPing();
    if (socket) {
        socket.onopen = null;
        socket.onmessage = null;
@@ -370,7 +420,12 @@ function clearTargetTabForIdle() {

 async function leaveRoomAfterIdleGrace(reason) {
    if (!currentRoom) return;
+    connectIntent = false;
+    reconnectFailed = false;
+    reconnectAttempts = 0;
+    chrome.storage.session.set({ reconnectFailed: false, reconnectAttempts: 0, reconnectStartTime: null });
    emit(EVENTS.LEAVE_ROOM, { peerId });
+    forceDisconnect();
    currentRoom = null;
    currentTabId = null;
    currentTabTitle = null;
@@ -423,7 +478,9 @@ async function connect() {
            addLog('Browser is offline. Waiting...', 'warn');
            broadcastConnectionStatus('offline');
            isConnecting = false;
-            scheduleReconnect();
+            if (currentRoom || connectIntent) {
+                scheduleReconnect();
+            }
            return;
        }

@@ -492,6 +549,7 @@ async function connect() {
                isConnecting = false;
                isNamespaceJoined = true;
                broadcastConnectionStatus('connected');
+                startPing();
                addLog('Joined Namespace /', 'success');
                const settings = await getSettings();
                if (settings.roomId) {
@@ -527,26 +585,34 @@ async function connect() {
        socket.onclose = () => {
            isConnecting = false;
            isNamespaceJoined = false;
+            stopPing();
            
-            isForceSyncInitiator = false;
-            forceSyncAcks.clear();
-            if (forceSyncTimeout) clearTimeout(forceSyncTimeout);
-            chrome.storage.session.set({ 
-                isForceSyncInitiator: false, 
-                forceSyncAcks: [], 
-                forceSyncDeadline: null 
-            });
+            if (!connectIntent && !currentRoom) {
+                isForceSyncInitiator = false;
+                forceSyncAcks.clear();
+                if (forceSyncTimeout) clearTimeout(forceSyncTimeout);
+                chrome.storage.session.set({ 
+                    isForceSyncInitiator: false, 
+                    forceSyncAcks: [], 
+                    forceSyncDeadline: null 
+                }).catch(() => {});
+            }

            
-            if (currentRoom) {
+            if (currentRoom && !connectIntent) {
                currentRoom.peers = [];
-                if (storageInitialized) chrome.storage.session.set({ currentRoom });
+                if (storageInitialized) chrome.storage.session.set({ currentRoom }).catch(() => {});
                chrome.runtime.sendMessage({ type: 'PEER_UPDATE', peers: [] }).catch(() => {});
            }
            broadcastConnectionStatus('disconnected');
-            addLog('Disconnected. Scheduling reconnect...', 'warn');
-            socket = null;
-            scheduleReconnect();
+            if (currentRoom || connectIntent) {
+                addLog('Disconnected. Scheduling reconnect...', 'warn');
+                socket = null;
+                scheduleReconnect();
+            } else {
+                addLog('Disconnected. No active session — staying disconnected.', 'info');
+                socket = null;
+            }
        };

        socket.onerror = () => {
@@ -561,7 +627,9 @@ async function connect() {
        const errMsg = (e && e.message) ? e.message : String(e || 'Unknown connection error');
        addLog(errMsg, logType);
        broadcastConnectionStatus('disconnected');
-        scheduleReconnect();
+        if (currentRoom || connectIntent) {
+            scheduleReconnect();
+        }
    }
 }

@@ -691,6 +759,47 @@ function addToHistory(action, senderId) {
    chrome.runtime.sendMessage({ type: 'HISTORY_UPDATE', history }).catch(() => {});
 }

+// --- Ping / Latency ---
+function sendPing() {
+    const t = Date.now();
+    pendingPingT = t;
+    emit(EVENTS.PING, { t });
+    if (pingTimeout) clearTimeout(pingTimeout);
+    pingTimeout = setTimeout(() => {
+        if (pendingPingT === t) {
+            addLog('Ping timeout reached, force disconnecting to trigger reconnect', 'warn');
+            pendingPingT = null;
+            forceDisconnect();
+            if (currentRoom || connectIntent) {
+                scheduleReconnect();
+            }
+        }
+        pingTimeout = null;
+    }, 5000);
+}
+
+function startPing() {
+    if (pingInterval) clearInterval(pingInterval);
+    if (pingTimeout) { clearTimeout(pingTimeout); pingTimeout = null; }
+    currentPingMs = null;
+    pendingPingT = null;
+    pingInterval = setInterval(sendPing, 15000);
+    sendPing();
+}
+
+function stopPing() {
+    if (pingInterval) {
+        clearInterval(pingInterval);
+        pingInterval = null;
+    }
+    if (pingTimeout) {
+        clearTimeout(pingTimeout);
+        pingTimeout = null;
+    }
+    currentPingMs = null;
+    pendingPingT = null;
+}
+
 // --- Event Handlers ---
 function handleServerEvent(event, data) {
    if (!data) {
@@ -762,9 +871,18 @@ function handleServerEvent(event, data) {
            break;
        case EVENTS.ERROR:
            isConnecting = false;
+            // If we get a server error before successfully joining a room,
+            // clear connectIntent to prevent an infinite reconnect loop.
+            if (!currentRoom) {
+                connectIntent = false;
+                if (reconnectTimer) { clearTimeout(reconnectTimer); reconnectTimer = null; }
+                reconnectAttempts = 0;
+                reconnectFailed = false;
+            }
            broadcastConnectionStatus('disconnected');
            addLog(`Server Error: ${data.message}`, 'error');
-            chrome.storage.local.get(['locale'], async (settings) => {
+            chrome.storage.local.get(['browserNotifications', 'locale'], async (settings) => {
+                if (!settings.browserNotifications) return;
                const lang = settings.locale || getSystemLanguage();
                await loadLocale(lang);
                chrome.notifications.create(`error_${Date.now()}`, {
@@ -875,6 +993,11 @@ function handleServerEvent(event, data) {

            routeToContent(event, data);
            break;
+        case EVENTS.PING:
+            if (data && typeof data.t === 'number' && Number.isFinite(data.t) && data.sender) {
+                emit(EVENTS.PONG, { t: data.t, target: data.sender });
+            }
+            break;
        case EVENTS.EVENT_ACK:
            if (lastActionState && lastActionState.action && data?.senderId) {
                // Correlation Check: Only accept ACK if it matches our current action's timestamp
@@ -1011,6 +1134,20 @@ function handleServerEvent(event, data) {
                addLog(`Episode lobby for "${title}" cancelled by ${data.senderId || 'peer'}`, 'warn');
            }
            break;
+        case EVENTS.PONG:
+            if (data && typeof data.t === 'number' && Number.isFinite(data.t)) {
+                if (pendingPingT === data.t) {
+                    pendingPingT = null;
+                    if (pingTimeout) {
+                        clearTimeout(pingTimeout);
+                        pingTimeout = null;
+                    }
+                    const rtt = Date.now() - data.t;
+                    currentPingMs = (rtt >= 0 && rtt < 30000) ? rtt : null;
+                    chrome.runtime.sendMessage({ type: 'PING_UPDATE', ping: currentPingMs }).catch(() => {});
+                }
+            }
+            break;
        default:
            addLog(`Received unknown event from server: ${event}`, 'warn');
            break;
@@ -1240,7 +1377,7 @@ chrome.alarms.onAlarm.addListener(async (alarm) => {
    if (alarm.name === 'keepAlive') {
        chrome.storage.session.get('keepAlive', () => {});
        if (!socket || socket.readyState !== WebSocket.OPEN) {
-            if (!reconnectFailed) {
+            if (!reconnectFailed && (currentRoom || connectIntent)) {
                connect();
            }
        } else if (currentRoom) {
@@ -1268,9 +1405,7 @@ chrome.alarms.onAlarm.addListener(async (alarm) => {
 function leaveOldRoomIfSwitching(newRoomId) {
    if (currentRoom && currentRoom.roomId !== newRoomId) {
        addLog(`Switching rooms: leaving ${currentRoom.roomId} to join ${newRoomId}`, 'info');
-        if (socket && socket.readyState === WebSocket.OPEN && isNamespaceJoined) {
-            emit(EVENTS.LEAVE_ROOM, { peerId });
-        }
+        forceDisconnect();
        currentRoom = null;
        if (storageInitialized) chrome.storage.session.set({ currentRoom: null });
        chrome.runtime.sendMessage({ type: 'PEER_UPDATE', peers: [] }).catch(() => {});
@@ -1324,18 +1459,31 @@ async function handleAsyncMessage(message, sender, sendResponse) {
    await ensureState();

    if (message.type === 'CONNECT') {
+        const settings = await getSettings();
+        connectIntent = !!settings.roomId;
+        const desiredUrl = resolveServerUrl(settings);
+
+        if (settings.roomId && currentRoom && currentRoom.roomId === settings.roomId && socket && socket.readyState === WebSocket.OPEN && isNamespaceJoined && desiredUrl === currentServerUrl) {
+            broadcastConnectionStatus('connected');
+            const tabs = await new Promise(resolve => chrome.tabs.query({}, resolve));
+            for (const tab of tabs) {
+                chrome.tabs.sendMessage(tab.id, { type: 'JOIN_STATUS', success: true, message: 'Already in room' }).catch(() => {});
+            }
+            if (typeof sendResponse === 'function') sendResponse({ status: 'ok' });
+            return;
+        }
+
        reconnectFailed = false;
        reconnectStartTime = null;
        reconnectAttempts = 0;
        chrome.storage.session.set({ reconnectFailed: false, reconnectAttempts: 0, reconnectStartTime: null });
-        const settings = await getSettings();
+
        if (settings.roomId) {
            leaveOldRoomIfSwitching(settings.roomId);
        }
-        const desiredUrl = resolveServerUrl(settings);
        if (desiredUrl !== currentServerUrl || !socket || socket.readyState !== WebSocket.OPEN || !isNamespaceJoined) {
            if (desiredUrl !== currentServerUrl) forceDisconnect();
-            connect();
+            if (settings.roomId) connect();
        } else if (settings.roomId) {
            emit(EVENTS.JOIN_ROOM, { 
                roomId: settings.roomId, 
@@ -1348,6 +1496,7 @@ async function handleAsyncMessage(message, sender, sendResponse) {
        }
        sendResponse({ status: 'ok' });
    } else if (message.type === 'RETRY_CONNECT') {
+        connectIntent = true;
        reconnectFailed = false;
        reconnectStartTime = null;
        reconnectAttempts = 0;
@@ -1372,9 +1521,14 @@ async function handleAsyncMessage(message, sender, sendResponse) {
            serverUrl: currentServerUrl,
            version: chrome.runtime.getManifest().version,
            protocolVersion: PROTOCOL_VERSION,
-            roomPassword: currentRoom ? currentRoom.password : null
+            roomPassword: currentRoom ? currentRoom.password : null,
+            ping: currentPingMs
        });
    } else if (message.type === 'LEAVE_ROOM') {
+        connectIntent = false;
+        reconnectFailed = false;
+        reconnectAttempts = 0;
+        chrome.storage.session.set({ reconnectFailed: false, reconnectAttempts: 0, reconnectStartTime: null });
        resetAudioProcessingInTab(currentTabId);
        emit(EVENTS.LEAVE_ROOM, { peerId });
        currentRoom = null;
@@ -1405,8 +1559,10 @@ async function handleAsyncMessage(message, sender, sendResponse) {
            episodeLobby: null,
            expectedAcksCount: 0
        });
+        chrome.storage.local.set({ roomId: '', password: '' }).catch(() => {});
        addLog('Left Room', 'info');
        chrome.runtime.sendMessage({ type: 'PEER_UPDATE', peers: [] }).catch(() => {});
+        forceDisconnect();
        sendResponse({ status: 'ok' });
    } else if (message.type === 'CLEAR_LOGS') {
        logs = [];
@@ -1421,24 +1577,46 @@ async function handleAsyncMessage(message, sender, sendResponse) {
    } else if (message.type === 'WEB_JOIN_REQUEST') {
        const { roomId: rawRoomId, password, useCustomServer, serverUrl } = message;
        const roomId = typeof rawRoomId === 'string' ? rawRoomId.replace(/[^a-zA-Z0-9\-]/g, '') : '';
+        if (!roomId) {
+            const errMsg = { type: 'JOIN_STATUS', success: false, message: 'Invalid room ID' };
+            chrome.runtime.sendMessage(errMsg).catch(() => {});
+            chrome.tabs.query({}, (tabs) => {
+                tabs.forEach(tab => chrome.tabs.sendMessage(tab.id, errMsg).catch(() => {}));
+            });
+            sendResponse({ status: 'invalid_room_id' });
+            return;
+        }
+        connectIntent = true;
        chrome.storage.local.set({ 
            roomId, 
            password,
            useCustomServer: !!useCustomServer,
            serverUrl: serverUrl || ''
        }, async () => {
+            const settings = await getSettings();
+            const desiredUrl = resolveServerUrl(settings);
+
+            if (roomId && currentRoom && currentRoom.roomId === roomId && socket && socket.readyState === WebSocket.OPEN && isNamespaceJoined && desiredUrl === currentServerUrl) {
+                broadcastConnectionStatus('connected');
+                const tabs = await new Promise(resolve => chrome.tabs.query({}, resolve));
+                for (const tab of tabs) {
+                    chrome.tabs.sendMessage(tab.id, { type: 'JOIN_STATUS', success: true, message: 'Already in room' }).catch(() => {});
+                }
+                sendResponse({ status: 'already_joined' });
+                return;
+            }
+
            reconnectFailed = false;
            reconnectStartTime = null;
            reconnectAttempts = 0;
            chrome.storage.session.set({ reconnectFailed: false, reconnectAttempts: 0, reconnectStartTime: null });
            broadcastConnectionStatus('connecting');
            leaveOldRoomIfSwitching(roomId);
-            const settings = await getSettings();
-            const desiredUrl = resolveServerUrl(settings);
+
            if (desiredUrl !== currentServerUrl || !socket || socket.readyState !== WebSocket.OPEN || !isNamespaceJoined) {
                if (desiredUrl !== currentServerUrl) forceDisconnect();
                connect();
-            } else {
+            } else if (roomId) {
                emit(EVENTS.JOIN_ROOM, { 
                    roomId, 
                    password,
@@ -1598,7 +1776,8 @@ async function handleAsyncMessage(message, sender, sendResponse) {
        markRoomUseful();
        getSettings().then(settings => {
            const statusPayload = { ...message.payload, peerId, username: settings.username, tabTitle: currentTabTitle };
-            emit(EVENTS.PEER_STATUS, statusPayload);
+            const otherCount = currentRoom && Array.isArray(currentRoom.peers) ? currentRoom.peers.filter(p => (typeof p === 'object' ? p.peerId : p) !== peerId).length : 0;
+            if (otherCount > 0) emit(EVENTS.PEER_STATUS, statusPayload);

            if (currentRoom && Array.isArray(currentRoom.peers)) {
                const me = currentRoom.peers.find(p => (p.peerId || p) === peerId);
@@ -1755,7 +1934,7 @@ async function handleAsyncMessage(message, sender, sendResponse) {
 }

 chrome.storage.onChanged.addListener(async (changes, area) => {
-    if (area !== 'sync' || !changes.audioSettings) return;
+    if (area !== 'local' || !changes.audioSettings) return;
    await ensureState();
    if (!currentTabId) return;

@@ -1822,5 +2001,8 @@ chrome.tabs.onUpdated.addListener(async (tabId, changeInfo, _tab) => {
    }
 });

-// Initial Connect
-connect();
+// Initial Connect — only if user has an active room configuration
+getSettings().then(settings => {
+    connectIntent = !!settings.roomId;
+    if (connectIntent) connect();
+}).catch(() => connectIntent = false);
@@ -55,6 +55,7 @@
    const MIN_SEEK_DELTA = 2.0;
    let lastReportedSeekTime = null;  // last currentTime we relayed as a SEEK
    let seekDebounceTimer = null;     // debounce timer for rapid seek events
+    let expectedSeekTime = null;      // strictly track programmatic seeks

    // --- Episode Auto-Sync State ---
    let lastKnownMediaTitle = null;
@@ -184,7 +185,7 @@
            }
        }
        if (audioCtx.state === 'suspended') {
-            audioCtx.resume().catch(() => {});
+            audioCtx.resume().catch(() => { reportLog('AudioContext resume failed - browser may need page interaction first', 'warn'); });
        }
        return audioCtx;
    }
@@ -242,6 +243,7 @@
        rampGain(chain.dryGain, 1, t);
        rampGain(chain.compGain, 0, t);
        chain.active = false;
+        reportLog('Audio compressor disabled', 'info');
    }

    function bypassCurrentAudioProcessing() {
@@ -274,6 +276,7 @@
            rampGain(chain.dryGain, 0, t);
            rampGain(chain.compGain, 1, t);
            chain.active = true;
+            reportLog('Audio compressor enabled', 'info');
        }
    }

@@ -287,28 +290,27 @@
    // Extract a canonical episode identifier from a title string.
    // Handles: S01E01, S1E1, S01 - E01, Season 1 Episode 1, "Folge 5", "Episode 5", "Ep. 5", "#5"
    // Returns null if no episode pattern found.
+    // --- SHARED_EPISODE_UTILS_INJECT_START ---
+    // This block is automatically replaced by /scripts/build-extension.js
    function extractEpisodeId(title) {
        if (!title || typeof title !== 'string') return null;
-        // S01E01 patterns (with any non-alphanumeric separator between season and E)
        const se = title.match(/S(?:eason\s*)?(\d+)[^a-zA-Z0-9]*E(?:pisode\s*)?(\d+)/i);
        if (se) return `S${String(se[1]).padStart(2, '0')}E${String(se[2]).padStart(2, '0')}`;
-        // "Episode X", "Folge X", "Ep. X", "#X"
        const ep = title.match(/(?:Episode|Folge|Ep\.?|#)\s*(\d+)/i);
        if (ep) return `EP${String(ep[1]).padStart(3, '0')}`;
        return null;
    }

-    // Returns true if two titles likely refer to the same episode.
-    // Strict: both must have IDs and match, OR neither has IDs and exact match.
    function sameEpisode(titleA, titleB) {
-        if (!titleA && !titleB) return true; // Both unknown → assume same (backward compat)
-        if (!titleA || !titleB) return false; // One unknown, one known → different
+        if (!titleA && !titleB) return true;
+        if (!titleA || !titleB) return false;
        const idA = extractEpisodeId(titleA);
        const idB = extractEpisodeId(titleB);
-        if (idA && idB) return idA === idB; // Both have parseable IDs → compare IDs
-        if (idA || idB) return false;       // One has ID, other doesn't → different
-        return titleA === titleB;            // Neither has ID → exact string match
+        if (idA && idB) return idA === idB;
+        if (idA || idB) return false;
+        return titleA === titleB;
    }
+    // --- SHARED_EPISODE_UTILS_INJECT_END ---

    // Returns true only when we are CERTAIN the episodes differ.
    // Permissive: only blocks if BOTH titles have parseable IDs AND they differ.
@@ -436,7 +438,7 @@
                        ytButton.click();
                    }
                    if (action === EVENTS.SEEK) {
-                        _setSuppress('seek');
+                        expectedSeekTime = data.targetTime;
                        video.currentTime = data.targetTime;
                    }
                    return;
@@ -452,7 +454,7 @@
                        twitchButton.click();
                    }
                    if (action === EVENTS.SEEK) {
-                        _setSuppress('seek');
+                        expectedSeekTime = data.targetTime;
                        video.currentTime = data.targetTime;
                    }
                    return;
@@ -470,7 +472,7 @@
                _setSuppress('paused');
                video.pause();
            } else if (action === EVENTS.SEEK) {
-                _setSuppress('seek');
+                expectedSeekTime = data.targetTime;
                video.currentTime = data.targetTime;
            }
    } catch (e) {
@@ -573,7 +575,7 @@
                        return;
                    }
                    _setSuppress('paused');
-                    _setSuppress('seek');
+                    expectedSeekTime = payload.targetTime;
                    video.pause();
                    try {
                        video.currentTime = payload.targetTime;
@@ -837,6 +839,11 @@
    window.addEventListener('pagehide', () => {
        pageVisible = false;
        closeAudioContext();
+        if (keepAlivePort) { try { keepAlivePort.disconnect(); } catch (_e) { /* ignore */ } keepAlivePort = null; }
+        if (lobbyPollTimer) { clearInterval(lobbyPollTimer); lobbyPollTimer = null; }
+        if (heartbeatTimeout) { clearTimeout(heartbeatTimeout); heartbeatTimeout = null; }
+        if (proactiveHeartbeatTimeout) { clearTimeout(proactiveHeartbeatTimeout); proactiveHeartbeatTimeout = null; }
+        observer.disconnect();
    });
    window.addEventListener('pageshow', (event) => {
        // event.persisted is true ONLY when restored from bfcache, not on initial load
@@ -858,11 +865,17 @@
        const current = video.currentTime;
        if (!Number.isFinite(current)) return;

-        // Step 1: Check _suppressTimers (programmatic seek from remote peer)
-        if (_suppressTimers['seek']) {
-            _clearSuppress('seek');
-            lastReportedSeekTime = current;
-            return;
+        // Step 1: Check expectedSeekTime (programmatic seek from remote peer)
+        if (expectedSeekTime !== null) {
+            if (Math.abs(current - expectedSeekTime) < 1.0) {
+                // Video arrived at expected time. Safely clear and ignore.
+                expectedSeekTime = null;
+                lastReportedSeekTime = current;
+                return;
+            } else {
+                // User manually scrubbed to a DIFFERENT time while we were buffering
+                expectedSeekTime = null;
+            }
        }

        // Step 2: Suppress during visibility grace period (tab re-focus ghost events)
@@ -0,0 +1,24 @@
+/**
+ * KoalaSync Episode Title Utilities
+ * Single source of truth — synced to content.js by build-extension.js.
+ * Keep in sync with the injection block in content.js!
+ */
+
+export function extractEpisodeId(title) {
+    if (!title || typeof title !== 'string') return null;
+    const se = title.match(/S(?:eason\s*)?(\d+)[^a-zA-Z0-9]*E(?:pisode\s*)?(\d+)/i);
+    if (se) return `S${String(se[1]).padStart(2, '0')}E${String(se[2]).padStart(2, '0')}`;
+    const ep = title.match(/(?:Episode|Folge|Ep\.?|#)\s*(\d+)/i);
+    if (ep) return `EP${String(ep[1]).padStart(3, '0')}`;
+    return null;
+}
+
+export function sameEpisode(titleA, titleB) {
+    if (!titleA && !titleB) return true;
+    if (!titleA || !titleB) return false;
+    const idA = extractEpisodeId(titleA);
+    const idB = extractEpisodeId(titleB);
+    if (idA && idB) return idA === idB;
+    if (idA || idB) return false;
+    return titleA === titleB;
+}
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Equalizer",
-  "AUDIO_COMING_SOON": "Demnächst"
+  "AUDIO_COMING_SOON": "Demnächst",
+  "BTN_RESTART_TOUR": "Einführung neu starten",
+  "BTN_RESTART_TOUR_TOOLTIP": "Startet die Einführung für neue Benutzer erneut",
+  "HINT_SELECT_VIDEO": "Wähle hier dein Video aus!"
 }
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Equalizer",
-  "AUDIO_COMING_SOON": "Coming soon"
+  "AUDIO_COMING_SOON": "Coming soon",
+  "BTN_RESTART_TOUR": "Restart Tutorial",
+  "BTN_RESTART_TOUR_TOOLTIP": "Restart the onboarding tutorial",
+  "HINT_SELECT_VIDEO": "Select your video here!"
 }
@@ -6,7 +6,7 @@
  "TAB_ROOM_TOOLTIP": "Configuración de sala y conexión",
  "TAB_SYNC": "Sincro",
  "TAB_SYNC_TOOLTIP": "Controles de sincronización de video y acciones",
-  "TAB_SETTINGS": "Opciones",
+  "TAB_SETTINGS": "Configuración",
  "TAB_SETTINGS_TOOLTIP": "Preferencias de la extensión",
  "TAB_STATUS": "Estado",
  "TAB_STATUS_TOOLTIP": "Diagnósticos avanzados y registros",
@@ -15,7 +15,7 @@
  "LABEL_SERVER": "Servidor",
  "BTN_SERVER_OFFICIAL": "Oficial",
  "BTN_SERVER_OFFICIAL_TOOLTIP": "Usar el servidor oficial confiable",
-  "BTN_SERVER_CUSTOM": "Perso",
+  "BTN_SERVER_CUSTOM": "Personalizado",
  "BTN_SERVER_CUSTOM_TOOLTIP": "Conectarse a su propio servidor auto-alojado",
  "PLACEHOLDER_SERVER_URL": "wss://tu-servidor:3000",
  "LABEL_ROOM_ID": "ID de sala",
@@ -58,16 +58,16 @@
  "BTN_PAUSE_TOOLTIP": "Enviar un comando de pausa a todos",
  "BTN_SYNC": "⚡ SYNC",
  "BTN_SYNC_TOOLTIP": "Forzar la sincronización de todos los usuarios",
-  "OPTION_JUMP_TO_OTHERS": "Unirse a otros",
-  "OPTION_JUMP_TO_ME": "Traerlos a mí",
+  "OPTION_JUMP_TO_OTHERS": "Ir a la posición de otros",
+  "OPTION_JUMP_TO_ME": "Traerlos a mi posición",
  "OPTION_JUMP_MODE_TOOLTIP": "Elegir el objetivo de sincronización",
  "LABEL_LAST_ACTIVITY": "Última actividad",
-  "LABEL_LAST_ACTIVITY_TOOLTIP": "Muestra el comando más reciente de reproducción, pausa o búsqueda",
+  "LABEL_LAST_ACTIVITY_TOOLTIP": "Muestra el comando más reciente de reproducción, pausa o salto en el tiempo",
  "NO_RECENT_COMMANDS": "Sin comandos recientes",
  "LOBBY_HEADER": "SALA DE ESPERA DE EPISODIO",
  "LOBBY_WAITING_FOR": "🎬 Esperando a: \"{title}\"",
  "LOBBY_WAITING_PEERS": "Esperando participantes...",
-  "BTN_SKIP_PLAY": "Omitir y reproducir",
+  "BTN_SKIP_PLAY": "Omitir y reproducir ya",
  "BTN_SKIP_PLAY_TOOLTIP": "Cancelar la sala de espera y reproducir de todos modos",
  "LOBBY_CONNECT_FIRST": "Únete a una sala primero",
  "LOBBY_CONNECT_FIRST_DESC": "Necesitas unirte a una sala a través de un enlace de invitación o crear una nueva para sincronizar videos.",
@@ -76,7 +76,7 @@
  "LABEL_USERNAME": "Tu nombre de usuario",
  "LABEL_USERNAME_TOOLTIP": "El nombre de usuario ayuda a otros a identificarte.",
  "PLACEHOLDER_USERNAME": "Koala anónimo",
-  "LABEL_HIDE_CLUTTER": "Lista de pestañas limpia",
+  "LABEL_HIDE_CLUTTER": "Ocultar pestañas sin video",
  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra pestañas que no son de video y dominios no relacionados para mantener limpia la lista",
  "LABEL_AUTO_SYNC_NEXT": "Sincro auto del siguiente episodio",
  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automáticamente y espera a todos al cambiar de episodio, luego inicia de forma sincrónica.",
@@ -88,10 +88,10 @@
  "LABEL_LANGUAGE_TOOLTIP": "Elige tu idioma preferido para la extensión",
  "LABEL_TROUBLESHOOTING": "Resolución de problemas",
  "LABEL_TROUBLESHOOTING_TOOLTIP": "Herramientas para solucionar problemas de conexión",
-  "BTN_REGEN_ID": "Regenerar ID de participante",
+  "BTN_REGEN_ID": "Regenerar ID de usuario",
  "BTN_REGEN_ID_TOOLTIP": "Regenerar tu ID interno y volver a conectarte",
  "REGEN_ID_DESC": "Usa esto si ves errores de 'Identidad duplicada'.",
-  "REGEN_ID_OTHER_ISSUE": "¿Otro problema? Abre un Issue en GitHub",
+  "REGEN_ID_OTHER_ISSUE": "¿Tienes otro problema? Abre un reporte en GitHub",
  "LABEL_CONN_STATUS": "Estado de la conexión",
  "LABEL_CONN_STATUS_TOOLTIP": "Estado actual de la conexión WebSocket",
  "CONN_STATUS_DISCONNECTED": "Desconectado",
@@ -115,7 +115,7 @@
  "BTN_ONBOARDING_NEXT": "Siguiente",
  "BTN_ONBOARDING_NEXT_TOOLTIP": "Ir al siguiente paso",
  "ONBOARDING_1_TITLE": "¡Bienvenido a KoalaSync!",
-  "ONBOARDING_1_TEXT": "Mira videos juntos en perfecta sincronización, sin importar dónde estén. ¡Hagamos un recorrido rápido!",
+  "ONBOARDING_1_TEXT": "Mira videos junto a tus amigos en perfecta sincronización, sin importar dónde estén. ¡Hagamos un recorrido rápido!",
  "ONBOARDING_2_TITLE": "1. Crear una sala",
  "ONBOARDING_2_TEXT": "Comienza aquí. Crea una sala y comparte el enlace de invitación con tus amigos.",
  "ONBOARDING_3_TITLE": "2. Seleccionar video",
@@ -127,7 +127,7 @@
  "ERR_CONN_TIMEOUT": "Tiempo de conexión agotado. Inténtalo de nuevo.",
  "ERR_INVALID_SERVER_URL": "Formato de URL de servidor no válido.",
  "ERR_IDENTITY_NOT_LOADED": "Identidad no cargada aún. Espera un momento e inténtalo de nuevo.",
-  "ERR_NO_PEERS_TIME": "No hay otros participantes con posición conocida. Cambia a 'Traerlos a mí'.",
+  "ERR_NO_PEERS_TIME": "No hay otros participantes con posición conocida. Cambia a 'Traerlos a mi posición'.",
  "ERR_NO_VIDEO_TAB": "No se pudo conectar a la pestaña de video.",
  "ERR_SELECT_VIDEO": "¡Selecciona un video primero!",
  "TOAST_INVITE_COPIED": "¡Enlace de invitación copiado!",
@@ -135,8 +135,8 @@
  "TOAST_LOBBY_SKIPPED": "Sala de espera de episodio omitida.",
  "TOAST_LOBBY_SKIP_FAILED": "Error al omitir la sala de espera.",
  "TOAST_LOGS_COPIED": "¡Copiado!",
-  "TOAST_PEER_JOINED": "{name} se unió a la sala",
-  "TOAST_PEER_LEFT": "{name} salió de la sala",
+  "TOAST_PEER_JOINED": "{name} se ha unido a la sala",
+  "TOAST_PEER_LEFT": "{name} ha salido de la sala",
  "TOAST_PEER_ACTION": "{name} ha {action}",
  "STATUS_CONNECTED": "Conectado",
  "STATUS_RECONNECTING": "Reconectando...",
@@ -150,17 +150,17 @@
  "BTN_STATE_SYNCING_GROUP": "Sincronizando al grupo ({time})...",
  "BTN_STATE_SYNCING": "Sincronizando...",
  "BTN_STATE_SYNCED": "✅ ¡Sincronizado!",
-  "NOTIF_PLAY": "inició la reproducción",
-  "NOTIF_PAUSE": "pausó la reproducción",
-  "NOTIF_SEEK": "cambió la posición del video",
-  "NOTIF_FORCE_PREPARE": "inició una sincronización forzada",
-  "NOTIF_FORCE_EXECUTE": "sincronizó a todos",
+  "NOTIF_PLAY": "ha iniciado la reproducción",
+  "NOTIF_PAUSE": "ha pausado la reproducción",
+  "NOTIF_SEEK": "ha cambiado la posición del video",
+  "NOTIF_FORCE_PREPARE": "ha iniciado una sincronización forzada",
+  "NOTIF_FORCE_EXECUTE": "ha sincronizado a todos",
  "DEBUG_NO_TAB": "No hay pestaña objetivo seleccionada.",
  "DEBUG_COMM_FAIL": "No se pudo comunicar con el video de la pestaña.",
  "EMPTY_PEERS_TITLE": "Sin participantes aún",
  "EMPTY_PEERS_HINT": "Comparte tu enlace de invitación para comenzar",
  "EMPTY_HISTORY_TITLE": "Sin actividad aún",
-  "EMPTY_HISTORY_HINT": "Reproduce, pausa o busca para ver el historial",
+  "EMPTY_HISTORY_HINT": "Reproduce, pausa o salta en el tiempo para ver el historial",
  "EMPTY_LOGS_TITLE": "Sin registros",
  "EMPTY_LOGS_HINT": "Los eventos de conexión aparecerán aquí",
  "EMPTY_ROOMS_TITLE": "Sin salas activas",
@@ -199,11 +199,14 @@
  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Mejora de voz",
  "AUDIO_PRESET_SMOOTH": "Suave",
  "AUDIO_PRESET_CUSTOM": "Personalizado",
-  "AUDIO_PARAM_THRESHOLD": "Umbral",
-  "AUDIO_PARAM_KNEE": "Knee",
-  "AUDIO_PARAM_RATIO": "Ratio",
-  "AUDIO_PARAM_ATTACK": "Attack",
-  "AUDIO_PARAM_RELEASE": "Release",
+  "AUDIO_PARAM_THRESHOLD": "Umbral (Threshold)",
+  "AUDIO_PARAM_KNEE": "Codo (Knee)",
+  "AUDIO_PARAM_RATIO": "Relación (Ratio)",
+  "AUDIO_PARAM_ATTACK": "Ataque (Attack)",
+  "AUDIO_PARAM_RELEASE": "Liberación (Release)",
  "AUDIO_EQUALIZER": "Ecualizador",
-  "AUDIO_COMING_SOON": "Próximamente"
+  "AUDIO_COMING_SOON": "Próximamente",
+  "BTN_RESTART_TOUR": "Reiniciar tutorial",
+  "BTN_RESTART_TOUR_TOOLTIP": "Reiniciar el tutorial de inicio",
+  "HINT_SELECT_VIDEO": "¡Selecciona tu video aquí!"
 }
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Égaliseur",
-  "AUDIO_COMING_SOON": "Bientôt disponible"
+  "AUDIO_COMING_SOON": "Bientôt disponible",
+  "BTN_RESTART_TOUR": "Redémarrer le tutoriel",
+  "BTN_RESTART_TOUR_TOOLTIP": "Recommencer le tutoriel d'intégration",
+  "HINT_SELECT_VIDEO": "Sélectionnez votre vidéo ici !"
 }
@@ -1,204 +0,0 @@
-# KoalaSync Browser Extension v2.0 - i18n Technical Implementation Plan
-
-Welcome, future Antigravity AI agent! This document is placed directly in the codebase at `/extension/locales/i18n_plan.md` to serve as a comprehensive architectural handbook for the next steps in adding **full internationalization (i18n) support to the browser extension itself** while maintaining 100% video-sync and background communication safety.
-
---
-
-## 🔍 Context & Audited Scope
-
-KoalaSync is a lightweight, premium browser extension (Chrome & Firefox Manifest V3) for synchronized video playback. The landing pages are already compiled dynamically in 6 languages:
-*   English (`en`)
-*   German (`de`)
-*   French (`fr`)
-*   Spanish (`es`)
-*   Portuguese (Brazil) (`pt-BR`)
-*   Russian (`ru`)
-
-Our goal is to build an identical, premium translation engine for the extension itself.
-
---
-
-## 🏛️ Architectural Choice: Custom JSON Dictionary Engine (Approach B)
-
-We evaluated two paths:
-1.  **Approach A (Native `chrome.i18n` API):** Uses `_locales/` directory. Too rigid—cannot support real-time dynamic switching inside the extension Settings dropdown without closing/re-opening the popup.
-2.  **Approach B (Custom Unified JSON Engine):** Uses flat JSON files matching our website files (`"KEY": "Value"`). Dynamically merges the target dictionary with baseline English `en.json` at runtime, programmatically providing an **airtight English fallback** and **real-time DOM translations** without popup reload.
-
-We chose **Approach B** for maximum compatibility, premium real-time toggling, and clean fallback safety.
-
---
-
-## 🔄 Resolve, Load, & State Flow
-
-1.  **On launch:** Look for saved language in `chrome.storage.sync.get('locale')`.
-2.  **Fallback Autodetect:** If no saved language, read `navigator.language` or `chrome.i18n.getUILanguage()`.
-    *   If the detected locale is supported, set as active.
-    *   If not supported, default to English (`en`).
-3.  **Dictionary Resolution:**
-    *   Asynchronously load the English baseline dictionary (`/extension/locales/en.json`).
-    *   If the target language is different, load target JSON (e.g. `/extension/locales/de.json`) and execute `Object.assign({}, enDict, targetDict)`. This guarantees dynamic translation while cleanly falling back to English for any missing keys.
-4.  **DOM Replacements:** Scan for `data-i18n`, `data-i18n-title`, and `data-i18n-placeholder` attributes, and translate them on the fly.
-5.  **Persistence:** Save dynamic selection modifications from the dropdown into `chrome.storage.sync`. Trigger instant DOM re-translation on change.
-
---
-
-## 📂 Proposed File Structure
-
-```
-KoalaPlay/
-└── extension/
-    ├── locales/                # [NEW] Contains flat translation maps
-    │   ├── i18n_plan.md        # This roadmap file
-    │   ├── en.json             # Flat English baseline keys
-    │   ├── de.json             # German keys
-    │   ├── fr.json             # French keys
-    │   ├── es.json             # Spanish keys
-    │   ├── pt-BR.json          # Portuguese (Brasil) keys
-    │   └── ru.json             # Russian keys
-    ├── i18n.js                 # [NEW] ESM translation engine module
-    ├── popup.html              # Modified with data-i18n attributes
-    ├── popup.js                # Modified to initialize locales and update variables
-    └── background.js           # Modified to push localized notification alerts
-```
-
---
-
-## 🛠️ Draft Code Snippets
-
-### 1. `i18n.js` (Zero-Dependency Engine Module)
-```javascript
-// extension/i18n.js
-export const SUPPORTED_LANGUAGES = ['en', 'de', 'fr', 'es', 'pt-BR', 'ru'];
-export const DEFAULT_LANGUAGE = 'en';
-
-let activeDictionary = {};
-
-export async function loadLocale(langCode) {
-    const resolvedLang = SUPPORTED_LANGUAGES.includes(langCode) ? langCode : DEFAULT_LANGUAGE;
-    try {
-        const enResponse = await fetch(chrome.runtime.getURL(`locales/${DEFAULT_LANGUAGE}.json`));
-        const enDict = await enResponse.json();
-        
-        if (resolvedLang === DEFAULT_LANGUAGE) {
-            activeDictionary = enDict;
-            return;
-        }
-
-        const targetResponse = await fetch(chrome.runtime.getURL(`locales/${resolvedLang}.json`));
-        const targetDict = await targetResponse.json();
-        
-        activeDictionary = Object.assign({}, enDict, targetDict);
-    } catch (err) {
-        console.error('[i18n] Failed to load dictionary. Falling back to English:', err);
-        const rescue = await fetch(chrome.runtime.getURL(`locales/${DEFAULT_LANGUAGE}.json`));
-        activeDictionary = await rescue.json();
-    }
-}
-
-export function getMessage(key) {
-    return activeDictionary[key] || key;
-}
-
-export function translateDOM() {
-    // Translate text nodes
-    document.querySelectorAll('[data-i18n]').forEach(el => {
-        const key = el.getAttribute('data-i18n');
-        const translated = getMessage(key);
-        const img = el.querySelector('img');
-        if (img) {
-            el.innerHTML = '';
-            el.appendChild(img);
-            el.appendChild(document.createTextNode(' ' + translated));
-        } else {
-            el.textContent = translated;
-        }
-    });
-
-    // Translate tooltips
-    document.querySelectorAll('[data-i18n-title]').forEach(el => {
-        const key = el.getAttribute('data-i18n-title');
-        el.setAttribute('title', getMessage(key));
-    });
-
-    // Translate placeholders
-    document.querySelectorAll('[data-i18n-placeholder]').forEach(el => {
-        const key = el.getAttribute('data-i18n-placeholder');
-        el.setAttribute('placeholder', getMessage(key));
-    });
-}
-```
-
-### 2. Markup Changes (`popup.html`)
-*   Annotate text elements: `<button class="tab-btn" data-tab="tab-settings" data-i18n="TAB_SETTINGS" data-i18n-title="TAB_SETTINGS_TOOLTIP">Settings</button>`
-*   Add Language Dropdown in the Settings Panel:
-    ```html
-    <div class="form-group" style="display: flex; align-items: center; justify-content: space-between; background: var(--card); padding: 10px; border-radius: 8px; margin-bottom: 12px; border: 1px solid #334155;">
-        <label style="margin-bottom: 0;" data-i18n="LABEL_LANGUAGE" title="Choose your preferred extension language">App Language</label>
-        <select id="langSelector" style="width: 150px; padding: 6px 10px; font-size: 13px; cursor: pointer;">
-            <option value="en">English</option>
-            <option value="de">Deutsch</option>
-            <option value="fr">Français</option>
-            <option value="es">Español</option>
-            <option value="pt-BR">Português (Brasil)</option>
-            <option value="ru">Русский</option>
-        </select>
-    </div>
-    ```
-
-### 3. Dynamic Script Wiring (`popup.js`)
-*   Import our engine: `import { loadLocale, translateDOM, getMessage } from './i18n.js';`
-*   Initialize during startup:
-    ```javascript
-    async function init() {
-        const data = await chrome.storage.sync.get(['locale', ...]);
-        let activeLang = data.locale;
-        if (!activeLang) {
-            const systemLang = (navigator.language || chrome.i18n.getUILanguage()).split('-')[0];
-            activeLang = ['en', 'de', 'fr', 'es', 'pt', 'ru'].includes(systemLang) ? (systemLang === 'pt' ? 'pt-BR' : systemLang) : 'en';
-            chrome.storage.sync.set({ locale: activeLang });
-        }
-        await loadLocale(activeLang);
-        translateDOM();
-        
-        // Select matching option in selector
-        const langSelector = document.getElementById('langSelector');
-        if (langSelector) langSelector.value = activeLang;
-        
-        // rest of standard init...
-    }
-    ```
-*   Listen to Settings change event:
-    ```javascript
-    const langSelector = document.getElementById('langSelector');
-    if (langSelector) {
-        langSelector.addEventListener('change', async () => {
-            const selectedLang = langSelector.value;
-            await chrome.storage.sync.set({ locale: selectedLang });
-            await loadLocale(selectedLang);
-            translateDOM();
-            // Re-render empty elements and tab list using new dynamic strings
-            refreshLogs();
-            refreshHistory();
-            populateTabs();
-        });
-    }
-    ```
-
-### 4. Background Notifications (`background.js`)
-*   Notifications inside `showNotification` should fetch dynamic keys based on `chrome.storage.sync` language settings and build clean alerts dynamically using `chrome.storage.sync.get('locale')`.
-*   Ensure that WebSocket event transmissions and video player scripts in `content.js` remain **completely untouched and unaware** of the localization engine.
-
---
-
-## 🔒 Safety Guardrail
-
-*   **WebSocket Engine Integrity:** Under no circumstances should `background.js` Socket.IO handshakes, rate limits, or binary protocol headers be adjusted. i18n is strictly an interface rendering skin layer.
-*   **Player Control Pipeline Integrity:** `content.js` expectedEvent suppression tables, HLS buffer calculations, and Media Session API listeners must remain untouched. Do not bind any i18n logic into the content script's active tracking loop.
-
---
-
-## 🧪 Verification Tasks
-
-1.  **Autodetection Audit:** Force-load the extension in Chrome/Firefox in a non-English language container and ensure it starts in that language or English gracefully.
-2.  **Integrity Validation Script:** Write a sanity node checker script `/scripts/test-locales.js` to ensure all key structures are uniform across all JSON files.
-3.  **Real-Time Refresh Verification:** Change dynamic drop-down preferences and verify that every element and alert swaps languages cleanly with zero redraw glitches or page crashes.
@@ -3,8 +3,8 @@
  "HTML_CLASS": "lang-it",
  "APP_TITLE": "KoalaSync",
  "TAB_ROOM": "Stanza",
-  "TAB_ROOM_TOOLTIP": "Impostazioni della stanza e connessione",
-  "TAB_SYNC": "Sincronizza",
+  "TAB_ROOM_TOOLTIP": "Impostazioni della stanza y connessione",
+  "TAB_SYNC": "Sincro",
  "TAB_SYNC_TOOLTIP": "Controlli di sincronizzazione video e azioni remote",
  "TAB_SETTINGS": "Impostazioni",
  "TAB_SETTINGS_TOOLTIP": "Preferenze dell'estensione",
@@ -16,155 +16,155 @@
  "BTN_SERVER_OFFICIAL": "Ufficiale",
  "BTN_SERVER_OFFICIAL_TOOLTIP": "Usa il server ufficiale affidabile",
  "BTN_SERVER_CUSTOM": "Personalizzato",
-  "BTN_SERVER_CUSTOM_TOOLTIP": "Connettiti al tuo server ospitato autonomamente",
+  "BTN_SERVER_CUSTOM_TOOLTIP": "Connettiti al tuo server privato",
  "PLACEHOLDER_SERVER_URL": "wss://tuo-server:3000",
  "LABEL_ROOM_ID": "ID Stanza",
-  "LABEL_ROOM_ID_TOOLTIP": "L'identificatore univoco per la tua stanza di sincronizzazione",
+  "LABEL_ROOM_ID_TOOLTIP": "L'identificatore univoco per la tua stanza",
  "PLACEHOLDER_ROOM_ID": "Inserisci ID Stanza",
-  "PLACEHOLDER_ROOM_ID_TOOLTIP": "L'ID univoco della stanza a cui vuoi unirti",
+  "PLACEHOLDER_ROOM_ID_TOOLTIP": "L'ID della stanza a cui vuoi unirti",
  "LABEL_PASSWORD": "Password (Opzionale)",
-  "LABEL_PASSWORD_TOOLTIP": "Password opzionale per limitare l'accesso alla stanza",
+  "LABEL_PASSWORD_TOOLTIP": "Password per limitare l'accesso alla stanza",
  "PLACEHOLDER_PASSWORD": "Password della stanza (opzionale)",
-  "PLACEHOLDER_PASSWORD_TOOLTIP": "Password per la stanza (lascia vuoto se nessuna)",
+  "PLACEHOLDER_PASSWORD_TOOLTIP": "Lascia vuoto se non c'è una password",
  "BTN_JOIN_ROOM": "Entra / Crea Stanza",
-  "BTN_JOIN_ROOM_TOOLTIP": "Connettiti alla stanza",
+  "BTN_JOIN_ROOM_TOOLTIP": "Entra nella stanza",
  "LABEL_PUBLIC_ROOMS": "Stanze Pubbliche",
-  "LABEL_PUBLIC_ROOMS_TOOLTIP": "Elenco delle stanze pubblicamente disponibili su questo server",
+  "LABEL_PUBLIC_ROOMS_TOOLTIP": "Elenco delle stanze pubbliche su questo server",
  "BTN_REFRESH": "AGGIORNA",
-  "BTN_REFRESH_TOOLTIP": "Aggiorna l'elenco delle stanze pubbliche",
+  "BTN_REFRESH_TOOLTIP": "Aggiorna l'elenco delle stanze",
  "PUBLIC_ROOMS_REFRESHING": "Aggiornamento...",
  "BTN_REFRESH_COOLDOWN": "ATTENDI {seconds}s",
-  "BTN_REFRESH_COOLDOWN_TOOLTIP": "L'aggiornamento dell'elenco è in pausa. Riprova tra {seconds}s.",
-  "PUBLIC_ROOMS_REFRESHING_COOLDOWN": "Aggiornamento stanze pubbliche. Prossimo aggiornamento disponibile tra {seconds}s.",
+  "BTN_REFRESH_COOLDOWN_TOOLTIP": "Riprova tra {seconds}s.",
+  "PUBLIC_ROOMS_REFRESHING_COOLDOWN": "Aggiornamento in corso. Disponibile tra {seconds}s.",
  "LABEL_ACTIVE_ROOM": "Stanza Attiva",
-  "LABEL_ACTIVE_ROOM_TOOLTIP": "La stanza a cui sei attualmente connesso",
+  "LABEL_ACTIVE_ROOM_TOOLTIP": "La stanza a cui sei connesso",
  "ACTIVE_ROOM_NONE": "NESSUNA",
  "ACTIVE_SERVER_OFFICIAL": "Server Ufficiale",
  "LABEL_INVITE_LINK": "Link di Invito",
-  "LABEL_INVITE_LINK_TOOLTIP": "Condividi questo link con gli amici per farli entrare",
-  "LABEL_PEERS_IN_ROOM": "Partecipanti nella Stanza",
-  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Altri utenti attualmente connessi a questa stanza",
+  "LABEL_INVITE_LINK_TOOLTIP": "Condividi questo link per invitare i tuoi amici",
+  "LABEL_PEERS_IN_ROOM": "Partecipanti",
+  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Utenti connessi a questa stanza",
  "NO_PEERS_CONNECTED": "Nessun partecipante connesso",
  "BTN_LEAVE_ROOM": "Lascia Stanza",
  "LABEL_SELECT_VIDEO": "Seleziona Video",
-  "LABEL_SELECT_VIDEO_TOOLTIP": "Scegli la scheda del browser contenente il video da sincronizzare",
+  "LABEL_SELECT_VIDEO_TOOLTIP": "Scegli la scheda con il video da sincronizzare",
  "OPTION_SELECT_TAB": "-- Seleziona una Scheda --",
-  "LABEL_REMOTE_CONTROL": "Controllo Remoto",
+  "LABEL_REMOTE_CONTROL": "Telecomando",
  "BTN_COPY_INVITE": "📋 Link di Invito",
-  "BTN_COPY_INVITE_TOOLTIP": "Copia Link di Invito",
+  "BTN_COPY_INVITE_TOOLTIP": "Copia il link di invito",
  "BTN_PLAY": "▶ Riproduci",
-  "BTN_PLAY_TOOLTIP": "Invia un comando di riproduzione a tutti",
+  "BTN_PLAY_TOOLTIP": "Avvia la riproduzione per tutti",
  "BTN_PAUSE": "⏸ Pausa",
-  "BTN_PAUSE_TOOLTIP": "Invia un comando di pausa a tutti",
-  "BTN_SYNC": "⚡ SYNC",
-  "BTN_SYNC_TOOLTIP": "Forza la sincronizzazione di tutti gli utenti",
-  "OPTION_JUMP_TO_OTHERS": "Salto dagli Altri",
-  "OPTION_JUMP_TO_ME": "Salto da Me",
-  "OPTION_JUMP_MODE_TOOLTIP": "Scegli il target di sincronizzazione",
-  "LABEL_LAST_ACTIVITY": "Stato Ultima Attività",
-  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra il comando più recente di riproduzione, pausa o ricerca",
+  "BTN_PAUSE_TOOLTIP": "Metti in pausa per tutti",
+  "BTN_SYNC": "⚡ SINCRO",
+  "BTN_SYNC_TOOLTIP": "Forza la sincronizzazione per tutti",
+  "OPTION_JUMP_TO_OTHERS": "Vai alla posizione degli altri",
+  "OPTION_JUMP_TO_ME": "Portali alla mia posizione",
+  "OPTION_JUMP_MODE_TOOLTIP": "Scegli l'obiettivo di sincronizzazione",
+  "LABEL_LAST_ACTIVITY": "Ultima Attività",
+  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra l'ultimo comando inviato",
  "NO_RECENT_COMMANDS": "Nessun comando recente",
-  "LOBBY_HEADER": "LOBBY EPISODIO",
+  "LOBBY_HEADER": "SALA D'ATTESA EPISODIO",
  "LOBBY_WAITING_FOR": "🎬 In attesa di: \"{title}\"",
  "LOBBY_WAITING_PEERS": "In attesa dei partecipanti...",
-  "BTN_SKIP_PLAY": "Salta e riproduci comunque",
-  "BTN_SKIP_PLAY_TOOLTIP": "Annulla la lobby e riproduci comunque",
-  "LOBBY_CONNECT_FIRST": "Connettiti prima a una stanza",
-  "LOBBY_CONNECT_FIRST_DESC": "Devi unirti a una stanza tramite un link di invito o crearne una nuova per sincronizzare i video.",
+  "BTN_SKIP_PLAY": "Salta e riproduci ora",
+  "BTN_SKIP_PLAY_TOOLTIP": "Annulla l'attesa e riproduci comunque",
+  "LOBBY_CONNECT_FIRST": "Entra prima in una stanza",
+  "LOBBY_CONNECT_FIRST_DESC": "Devi unirti a una stanza o crearne una nuova per sincronizzare i video.",
  "BTN_CREATE_ROOM_ALT": "Crea Nuova Stanza",
-  "BTN_CREATE_ROOM_ALT_TOOLTIP": "Crea una nuova stanza casuale ed entra",
+  "BTN_CREATE_ROOM_ALT_TOOLTIP": "Crea una stanza casuale ed entra",
  "LABEL_USERNAME": "Tuo Nome Utente",
-  "LABEL_USERNAME_TOOLTIP": "Il nome utente aiuta gli altri a identificarti.",
+  "LABEL_USERNAME_TOOLTIP": "Il tuo nome visibile agli altri.",
  "PLACEHOLDER_USERNAME": "Koala Anonimo",
-  "LABEL_HIDE_CLUTTER": "Nascondi Schede Inutili",
-  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra le schede senza video e i domini non correlati per mantenere pulito l'elenco",
-  "LABEL_AUTO_SYNC_NEXT": "Auto-Sync Prossimo Episodio",
-  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automaticamente e attende tutti i partecipanti al cambio episodio, poi si avvia in sincro.",
-  "LABEL_AUTO_COPY_INVITE": "Copia Automatica Invito",
-  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia automaticamente il link di invito negli appunti quando crei una nuova stanza.",
+  "LABEL_HIDE_CLUTTER": "Nascondi schede senza video",
+  "LABEL_HIDE_CLUTTER_TOOLTIP": "Mantiene pulito l'elenco filtrando le schede non pertinenti",
+  "LABEL_AUTO_SYNC_NEXT": "Sincro auto prossimo episodio",
+  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Attende tutti i partecipanti prima di avviare il prossimo episodio.",
+  "LABEL_AUTO_COPY_INVITE": "Copia automatica invito",
+  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia il link negli appunti quando crei una nuova stanza.",
  "LABEL_NOTIFICATIONS": "Notifiche del Browser",
-  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra le notifiche di sistema quando qualcuno entra/esce o riproduce/mette in pausa.",
+  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra notifiche quando qualcuno entra, esce o cambia stato.",
  "LABEL_LANGUAGE": "Lingua Applicazione",
-  "LABEL_LANGUAGE_TOOLTIP": "Scegli la lingua preferita per l'estensione",
+  "LABEL_LANGUAGE_TOOLTIP": "Scegli la lingua dell'estensione",
  "LABEL_TROUBLESHOOTING": "Risoluzione Problemi",
  "LABEL_TROUBLESHOOTING_TOOLTIP": "Strumenti per risolvere problemi di connessione",
-  "BTN_REGEN_ID": "Rigenera ID Peer",
-  "BTN_REGEN_ID_TOOLTIP": "Rigenera il tuo ID interno e riconnettiti",
-  "REGEN_ID_DESC": "Usa questo se riscontri errori di \"Identità Duplicata\".",
-  "REGEN_ID_OTHER_ISSUE": "Altro problema? Apri una Issue su GitHub",
+  "BTN_REGEN_ID": "Rigenera ID Utente",
+  "BTN_REGEN_ID_TOOLTIP": "Genera un nuovo ID interno e riconnettiti",
+  "REGEN_ID_DESC": "Usa questa opzione se riscontri errori di 'Identità Duplicata'.",
+  "REGEN_ID_OTHER_ISSUE": "Hai altri problemi? Apri una segnalazione su GitHub",
  "LABEL_CONN_STATUS": "Stato Connessione",
-  "LABEL_CONN_STATUS_TOOLTIP": "Stato corrente della connessione WebSocket",
+  "LABEL_CONN_STATUS_TOOLTIP": "Stato attuale della connessione",
  "CONN_STATUS_DISCONNECTED": "Disconnesso",
  "BTN_RETRY": "RIPROVA",
  "BTN_RETRY_TOOLTIP": "Tenta di riconnettersi al server",
  "BTN_COPY_LOGS": "Copia Log",
-  "BTN_COPY_LOGS_TOOLTIP": "Copia i log negli appunti per la condivisione",
-  "LABEL_VIDEO_DEBUG": "Info Debug Video",
-  "LABEL_VIDEO_DEBUG_TOOLTIP": "Dettagli tecnici sull'elemento video attualmente selezionato",
+  "BTN_COPY_LOGS_TOOLTIP": "Copia i log negli appunti",
+  "LABEL_VIDEO_DEBUG": "Debug Video",
+  "LABEL_VIDEO_DEBUG_TOOLTIP": "Dettagli tecnici sul video selezionato",
  "VIDEO_DEBUG_EMPTY": "Nessuna scheda selezionata o video rilevato.",
-  "LABEL_HISTORY": "Cronologia Azioni Completa",
-  "LABEL_HISTORY_TOOLTIP": "Registro cronologico di tutti i comandi di sincronizzazione nella stanza",
+  "LABEL_HISTORY": "Cronologia Completa",
+  "LABEL_HISTORY_TOOLTIP": "Registro di tutti i comandi inviati nella stanza",
  "HISTORY_EMPTY": "Ancora nessuna attività",
  "LABEL_LOGS": "Log (Ultimi 50)",
-  "LABEL_LOGS_TOOLTIP": "Log di connessione tecnica per il debug",
+  "LABEL_LOGS_TOOLTIP": "Log tecnici per il debug",
  "BTN_CLEAR": "PULISCI",
-  "BTN_CLEAR_TOOLTIP": "Cancella l'output del log",
+  "BTN_CLEAR_TOOLTIP": "Cancella i log",
  "LABEL_GITHUB": "Repository GitHub",
  "BTN_ONBOARDING_SKIP": "Salta",
  "BTN_ONBOARDING_SKIP_TOOLTIP": "Salta il tutorial",
  "BTN_ONBOARDING_NEXT": "Avanti",
  "BTN_ONBOARDING_NEXT_TOOLTIP": "Vai al passaggio successivo",
  "ONBOARDING_1_TITLE": "Benvenuto in KoalaSync!",
-  "ONBOARDING_1_TEXT": "Guarda i video insieme in perfetta sincronia, non importa dove ti trovi. Facciamo un rapido tour!",
+  "ONBOARDING_1_TEXT": "Guarda i video insieme ai tuoi amici in perfetta sincronia. Facciamo un breve tour!",
  "ONBOARDING_2_TITLE": "1. Crea una Stanza",
-  "ONBOARDING_2_TEXT": "Inizia qui. Crea una stanza e condividi il link di invito con i tuoi amici.",
+  "ONBOARDING_2_TEXT": "Inizia da qui. Crea una stanza e condividi il link con i tuoi amici.",
  "ONBOARDING_3_TITLE": "2. Seleziona Video",
-  "ONBOARDING_3_TEXT": "Naviga qui per selezionare il video che vuoi sincronizzare. Riproduci, metti in pausa e cerca: tutti rimangono sincronizzati.",
+  "ONBOARDING_3_TEXT": "Scegli il video che vuoi sincronizzare. Play, pausa o salta: tutti vedranno lo stesso.",
  "ONBOARDING_4_TITLE": "3. Personalizza",
-  "ONBOARDING_4_TEXT": "Scegli un nome utente divertente così i tuoi amici sanno chi sei.",
+  "ONBOARDING_4_TEXT": "Scegli un nome utente per farti riconoscere dai tuoi amici.",
  "ONBOARDING_5_TITLE": "Tutto pronto!",
-  "ONBOARDING_5_TEXT": "È ora di prendere i popcorn. Buona visione insieme!",
+  "ONBOARDING_5_TEXT": "È ora di prendere i popcorn. Buona visione!",
  "ERR_CONN_TIMEOUT": "Connessione scaduta. Riprova.",
  "ERR_INVALID_SERVER_URL": "Formato URL del server non valido.",
-  "ERR_IDENTITY_NOT_LOADED": "Identità non ancora caricata. Attendi un momento e riprova.",
-  "ERR_NO_PEERS_TIME": "Nessun altro peer con un orario noto. Passa a 'Salto da Me'.",
+  "ERR_IDENTITY_NOT_LOADED": "Identità non ancora caricata. Attendi un momento.",
+  "ERR_NO_PEERS_TIME": "Nessun altro partecipante con posizione nota. Passa a 'Portali alla mia posizione'.",
  "ERR_NO_VIDEO_TAB": "Impossibile connettersi alla scheda del video.",
  "ERR_SELECT_VIDEO": "Seleziona prima un video!",
  "TOAST_INVITE_COPIED": "Link di invito copiato!",
  "TOAST_COPY_FAILED": "Impossibile copiare negli appunti",
-  "TOAST_LOBBY_SKIPPED": "Lobby dell'episodio saltata.",
-  "TOAST_LOBBY_SKIP_FAILED": "Impossibile saltare la lobby.",
+  "TOAST_LOBBY_SKIPPED": "Sala d'attesa saltata.",
+  "TOAST_LOBBY_SKIP_FAILED": "Impossibile saltare la sala d'attesa.",
  "TOAST_LOGS_COPIED": "Copiato!",
  "TOAST_PEER_JOINED": "{name} è entrato nella stanza",
  "TOAST_PEER_LEFT": "{name} ha lasciato la stanza",
-  "TOAST_PEER_ACTION": "{name} ha {action}",
+  "TOAST_PEER_ACTION": "{name} {action}",
  "STATUS_CONNECTED": "Connesso",
  "STATUS_RECONNECTING": "Riconnessione...",
  "STATUS_CONNECTING": "Connessione in corso...",
-  "STATUS_FAILED": "Fallito",
+  "STATUS_FAILED": "Errore",
  "STATUS_DISCONNECTED": "Disconnesso",
  "BTN_STATE_JOINING": "🚀 Entrando...",
  "BTN_STATE_RECONNECTING": "🔄 Riconnessione...",
-  "BTN_STATE_PLAYING": "▶ Riproduzione...",
+  "BTN_STATE_PLAYING": "▶ In riproduzione...",
  "BTN_STATE_PAUSING": "⏸ In pausa...",
-  "BTN_STATE_SYNCING_GROUP": "Sincronizzazione al gruppo ({time})...",
+  "BTN_STATE_SYNCING_GROUP": "Sincronizzazione di gruppo ({time})...",
  "BTN_STATE_SYNCING": "Sincronizzazione...",
  "BTN_STATE_SYNCED": "✅ Sincronizzato!",
-  "NOTIF_PLAY": "avviato la riproduzione",
-  "NOTIF_PAUSE": "messo in pausa la riproduzione",
-  "NOTIF_SEEK": "cercato nel video",
-  "NOTIF_FORCE_PREPARE": "avviato la sincronizzazione forzata",
-  "NOTIF_FORCE_EXECUTE": "sincronizzato tutti",
-  "DEBUG_NO_TAB": "Nessuna scheda di destinazione selezionata.",
-  "DEBUG_COMM_FAIL": "Impossibile comunicare con il video della scheda.",
-  "EMPTY_PEERS_TITLE": "Ancora nessun partecipante",
-  "EMPTY_PEERS_HINT": "Condividi il tuo link di invito per iniziare",
-  "EMPTY_HISTORY_TITLE": "Ancora nessuna attività",
-  "EMPTY_HISTORY_HINT": "Riproduci, metti in pausa o cerca per vedere la cronologia",
+  "NOTIF_PLAY": "ha avviato la riproduzione",
+  "NOTIF_PAUSE": "ha messo in pausa",
+  "NOTIF_SEEK": "ha cambiato posizione",
+  "NOTIF_FORCE_PREPARE": "ha avviato una sincronizzazione forzata",
+  "NOTIF_FORCE_EXECUTE": "ha sincronizzato tutti",
+  "DEBUG_NO_TAB": "Nessuna scheda selezionata.",
+  "DEBUG_COMM_FAIL": "Errore di comunicazione con il video.",
+  "EMPTY_PEERS_TITLE": "Nessun partecipante",
+  "EMPTY_PEERS_HINT": "Condividi il tuo link per iniziare",
+  "EMPTY_HISTORY_TITLE": "Nessuna attività",
+  "EMPTY_HISTORY_HINT": "Usa i comandi per vedere la cronologia",
  "EMPTY_LOGS_TITLE": "Nessun log",
-  "EMPTY_LOGS_HINT": "Gli eventi di connessione appariranno qui",
+  "EMPTY_LOGS_HINT": "Gli eventi appariranno qui",
  "EMPTY_ROOMS_TITLE": "Nessuna stanza attiva",
-  "EMPTY_ROOMS_HINT": "Crea una stanza o aggiorna per trovare quelle pubbliche",
+  "EMPTY_ROOMS_HINT": "Crea una stanza o aggiorna l'elenco",
  "LABEL_YOU": "Tu",
  "ONBOARDING_DONE": "Fatto!",
  "LABEL_LOBBY_PEER_READY": "Pronto",
@@ -173,37 +173,40 @@
  "LABEL_PEERS_COUNT": "{count} partecipanti",
  "LABEL_CUSTOM_SERVER": "Server Personalizzato",
  "BTN_STATE_CREATING": "🚀 Creazione Stanza...",
-  "NOTIF_LOBBY_CANCEL_TITLE": "KoalaSync — Sincronizzazione Episodio Fallita",
-  "NOTIF_LOBBY_CANCEL_MSG": "Auto-sync annullato: {reason}. Potrebbe essere necessaria una sincronizzazione manuale.",
-  "LOBBY_CANCEL_TIMEOUT": "Timeout",
-  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Timeout (ripristinato)",
-  "LOBBY_CANCEL_PEERS_LEFT": "Tutti gli altri partecipanti hanno lasciato la stanza",
-  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Timeout — non tutti i partecipanti hanno caricato l'episodio",
+  "NOTIF_LOBBY_CANCEL_TITLE": "KoalaSync — Sincro Episodio Fallita",
+  "NOTIF_LOBBY_CANCEL_MSG": "Sincro auto annullata: {reason}. Usa la sincronizzazione manuale.",
+  "LOBBY_CANCEL_TIMEOUT": "Tempo scaduto",
+  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Tempo scaduto (ripristinato)",
+  "LOBBY_CANCEL_PEERS_LEFT": "Tutti gli altri partecipanti sono usciti",
+  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Tempo scaduto: caricamento incompleto per alcuni partecipanti",
  "LOBBY_CANCEL_USER": "Annullato dall'utente",
  "NOTIF_ERROR_TITLE": "Errore KoalaSync",
  "FOOTER_SUPPORT": "☕ Offrimi un caffè",
-  "FOOTER_REVIEW": "★ Valuta",
+  "FOOTER_REVIEW": "★ Valutaci",
  "FOOTER_SUPPORT_PROMPT": "Ti piace KoalaSync? Lascia una recensione!",
-  "LABEL_AUDIO_PROCESSING": "Elaborazione audio",
-  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Applica effetti audio come la compressione alla riproduzione video",
+  "LABEL_AUDIO_PROCESSING": "Elaborazione Audio",
+  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Applica effetti sonori (come il compressore) ai video",
  "AUDIO_OPEN_SETTINGS": "Apri",
-  "NEW_FEATURE_AUDIO": "Novità: Elaborazione audio — prova il compressore!",
+  "NEW_FEATURE_AUDIO": "Novità: Elaborazione Audio — prova il compressore!",
  "AUDIO_BACK": "← Indietro",
-  "AUDIO_PAGE_TITLE": "Impostazioni audio",
-  "AUDIO_MASTER_TOGGLE": "Elaborazione audio",
+  "AUDIO_PAGE_TITLE": "Impostazioni Audio",
+  "AUDIO_MASTER_TOGGLE": "Elaborazione Audio",
  "AUDIO_COMPRESSOR": "Compressore",
-  "AUDIO_COMPRESSOR_ENABLE": "Attivato",
+  "AUDIO_COMPRESSOR_ENABLE": "Attivo",
  "AUDIO_PRESET": "Preimpostazione",
  "AUDIO_PRESET_RECOMMENDED": "Consigliato",
-  "AUDIO_PRESET_DYNAMIC_RANGE": "Gamma dinamica",
-  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Miglioramento vocale",
+  "AUDIO_PRESET_DYNAMIC_RANGE": "Gamma Dinamica",
+  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Miglioramento Vocale",
  "AUDIO_PRESET_SMOOTH": "Morbido",
  "AUDIO_PRESET_CUSTOM": "Personalizzato",
-  "AUDIO_PARAM_THRESHOLD": "Soglia",
-  "AUDIO_PARAM_KNEE": "Knee",
-  "AUDIO_PARAM_RATIO": "Ratio",
-  "AUDIO_PARAM_ATTACK": "Attack",
-  "AUDIO_PARAM_RELEASE": "Release",
+  "AUDIO_PARAM_THRESHOLD": "Soglia (Threshold)",
+  "AUDIO_PARAM_KNEE": "Ginocchio (Knee)",
+  "AUDIO_PARAM_RATIO": "Rapporto (Ratio)",
+  "AUDIO_PARAM_ATTACK": "Attacco (Attack)",
+  "AUDIO_PARAM_RELEASE": "Rilascio (Release)",
  "AUDIO_EQUALIZER": "Equalizzatore",
-  "AUDIO_COMING_SOON": "Prossimamente"
+  "AUDIO_COMING_SOON": "Prossimamente",
+  "BTN_RESTART_TOUR": "Riavvia Tutorial",
+  "BTN_RESTART_TOUR_TOOLTIP": "Riavvia il tutorial introduttivo",
+  "HINT_SELECT_VIDEO": "Scegli il tuo video qui!"
 }
@@ -29,7 +29,7 @@
  "BTN_JOIN_ROOM": "ルームに参加 / 作成",
  "BTN_JOIN_ROOM_TOOLTIP": "ルームに接続",
  "LABEL_PUBLIC_ROOMS": "公開ルーム",
-  "LABEL_PUBLIC_ROOMS_TOOLTIP": "このサーバー上の公開ルーム의リスト",
+  "LABEL_PUBLIC_ROOMS_TOOLTIP": "このサーバー上の公開ルームのリスト",
  "BTN_REFRESH": "更新",
  "BTN_REFRESH_TOOLTIP": "公開ルームのリストを更新",
  "PUBLIC_ROOMS_REFRESHING": "更新中...",
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "イコライザー",
-  "AUDIO_COMING_SOON": "近日公開"
+  "AUDIO_COMING_SOON": "近日公開",
+  "BTN_RESTART_TOUR": "チュートリアルを再起動",
+  "BTN_RESTART_TOUR_TOOLTIP": "オンボーディングチュートリアルを再起動する",
+  "HINT_SELECT_VIDEO": "ここで動画を選択してください！"
 }
@@ -30,7 +30,7 @@
  "BTN_JOIN_ROOM_TOOLTIP": "방에 연결",
  "LABEL_PUBLIC_ROOMS": "공개 방",
  "LABEL_PUBLIC_ROOMS_TOOLTIP": "이 서버의 공개 방 목록",
-  "BTN_REFRESH": "Refreschi",
+  "BTN_REFRESH": "새로고침",
  "BTN_REFRESH_TOOLTIP": "공개 방 목록 새로고침",
  "PUBLIC_ROOMS_REFRESHING": "새로고침 중...",
  "BTN_REFRESH_COOLDOWN": "{seconds}초 대기",
@@ -140,7 +140,7 @@
  "TOAST_PEER_ACTION": "{name} 님이 {action}",
  "STATUS_CONNECTED": "연결됨",
  "STATUS_RECONNECTING": "재연결 중...",
-  "STATUS_CONNECTING": "연kel 중...",
+  "STATUS_CONNECTING": "연결 중...",
  "STATUS_FAILED": "실패",
  "STATUS_DISCONNECTED": "연결 끊김",
  "BTN_STATE_JOINING": "🚀 참여 중...",
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "이퀄라이저",
-  "AUDIO_COMING_SOON": "출시 예정"
+  "AUDIO_COMING_SOON": "출시 예정",
+  "BTN_RESTART_TOUR": "튜토리얼 다시 시작",
+  "BTN_RESTART_TOUR_TOOLTIP": "온보딩 튜토리얼을 다시 시작합니다",
+  "HINT_SELECT_VIDEO": "여기에서 비디오를 선택하세요!"
 }
@@ -156,7 +156,7 @@
  "NOTIF_FORCE_PREPARE": "is een geforceerde sync gestart",
  "NOTIF_FORCE_EXECUTE": "heeft iedereen gesynchroniseerd",
  "DEBUG_NO_TAB": "Geen doeltabblad geselecteerd.",
-  "DEBUG_COMM_FAIL": "Kon niet cmmuniceren met de videotab.",
+  "DEBUG_COMM_FAIL": "Kon niet communiceren met de videotab.",
  "EMPTY_PEERS_TITLE": "Nog geen deelnemers",
  "EMPTY_PEERS_HINT": "Deel uw uitnodigingslink om te beginnen",
  "EMPTY_HISTORY_TITLE": "Nog geen activiteit",
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Equalizer",
-  "AUDIO_COMING_SOON": "Binnenkort beschikbaar"
+  "AUDIO_COMING_SOON": "Binnenkort beschikbaar",
+  "BTN_RESTART_TOUR": "Tutorial opnieuw starten",
+  "BTN_RESTART_TOUR_TOOLTIP": "Start de introductie-tutorial opnieuw",
+  "HINT_SELECT_VIDEO": "Selecteer hier je video!"
 }
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Korektor",
-  "AUDIO_COMING_SOON": "Wkrótce"
+  "AUDIO_COMING_SOON": "Wkrótce",
+  "BTN_RESTART_TOUR": "Uruchom samouczek ponownie",
+  "BTN_RESTART_TOUR_TOOLTIP": "Uruchom ponownie samouczek powitalny",
+  "HINT_SELECT_VIDEO": "Wybierz swoje wideo tutaj!"
 }
@@ -4,9 +4,9 @@
  "APP_TITLE": "KoalaSync",
  "TAB_ROOM": "Sala",
  "TAB_ROOM_TOOLTIP": "Configurações da sala e conexão",
-  "TAB_SYNC": "Sincro",
+  "TAB_SYNC": "Sincronia",
  "TAB_SYNC_TOOLTIP": "Controles de sincronia de vídeo e ações",
-  "TAB_SETTINGS": "Opções",
+  "TAB_SETTINGS": "Configurações",
  "TAB_SETTINGS_TOOLTIP": "Preferências da extensão",
  "TAB_STATUS": "Status",
  "TAB_STATUS_TOOLTIP": "Diagnósticos avançados e logs",
@@ -15,23 +15,23 @@
  "LABEL_SERVER": "Servidor",
  "BTN_SERVER_OFFICIAL": "Oficial",
  "BTN_SERVER_OFFICIAL_TOOLTIP": "Usar o servidor oficial confiável",
-  "BTN_SERVER_CUSTOM": "Perso",
-  "BTN_SERVER_CUSTOM_TOOLTIP": "Conectar ao seu próprio servidor auto-hospedado",
+  "BTN_SERVER_CUSTOM": "Personalizado",
+  "BTN_SERVER_CUSTOM_TOOLTIP": "Conectar ao seu próprio servidor privado",
  "PLACEHOLDER_SERVER_URL": "wss://seu-servidor:3000",
  "LABEL_ROOM_ID": "ID da sala",
-  "LABEL_ROOM_ID_TOOLTIP": "O identificador exclusivo para sua sala de sincronização",
+  "LABEL_ROOM_ID_TOOLTIP": "O identificador exclusivo da sua sala",
  "PLACEHOLDER_ROOM_ID": "Digite o ID da sala",
-  "PLACEHOLDER_ROOM_ID_TOOLTIP": "O ID exclusivo da sala na qual você deseja entrar",
+  "PLACEHOLDER_ROOM_ID_TOOLTIP": "O ID da sala na qual você deseja entrar",
  "LABEL_PASSWORD": "Senha (Opcional)",
  "LABEL_PASSWORD_TOOLTIP": "Senha opcional para restringir o acesso à sala",
-  "PLACEHOLDER_PASSWORD": "Senha da sala (opcional)",
-  "PLACEHOLDER_PASSWORD_TOOLTIP": "Senha para a sala (deixe em branco se não houver)",
+  "PLACEHOLDER_PASSWORD": "Senha da sala",
+  "PLACEHOLDER_PASSWORD_TOOLTIP": "Deixe em branco se não houver senha",
  "BTN_JOIN_ROOM": "Entrar / Criar sala",
-  "BTN_JOIN_ROOM_TOOLTIP": "Conectar à sala",
+  "BTN_JOIN_ROOM_TOOLTIP": "Entrar na sala",
  "LABEL_PUBLIC_ROOMS": "Salas públicas",
  "LABEL_PUBLIC_ROOMS_TOOLTIP": "Lista de salas públicas disponíveis neste servidor",
  "BTN_REFRESH": "ATUALIZAR",
-  "BTN_REFRESH_TOOLTIP": "Atualizar a lista de salas públicas",
+  "BTN_REFRESH_TOOLTIP": "Atualizar a lista de salas",
  "PUBLIC_ROOMS_REFRESHING": "Atualizando...",
  "BTN_REFRESH_COOLDOWN": "AGUARDE {seconds}s",
  "BTN_REFRESH_COOLDOWN_TOOLTIP": "A lista de salas está em espera. Tente novamente em {seconds}s.",
@@ -41,99 +41,99 @@
  "ACTIVE_ROOM_NONE": "NENHUMA",
  "ACTIVE_SERVER_OFFICIAL": "Servidor oficial",
  "LABEL_INVITE_LINK": "Link de convite",
-  "LABEL_INVITE_LINK_TOOLTIP": "Compartilhe este link com amigos para que eles entrem",
-  "LABEL_PEERS_IN_ROOM": "Participantes na sala",
-  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Outros usuários conectados atualmente a esta sala",
+  "LABEL_INVITE_LINK_TOOLTIP": "Compartilhe este link com seus amigos para que eles entrem",
+  "LABEL_PEERS_IN_ROOM": "Participantes",
+  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Outros usuários conectados a esta sala",
  "NO_PEERS_CONNECTED": "Sem participantes conectados",
  "BTN_LEAVE_ROOM": "Sair da sala",
  "LABEL_SELECT_VIDEO": "Selecionar vídeo",
-  "LABEL_SELECT_VIDEO_TOOLTIP": "Escolha a aba do navegador contendo o vídeo a ser sincronizado",
+  "LABEL_SELECT_VIDEO_TOOLTIP": "Escolha a aba do navegador com o vídeo a ser sincronizado",
  "OPTION_SELECT_TAB": "-- Selecione uma aba --",
  "LABEL_REMOTE_CONTROL": "Controle remoto",
  "BTN_COPY_INVITE": "📋 Link de convite",
  "BTN_COPY_INVITE_TOOLTIP": "Copiar link de convite",
  "BTN_PLAY": "▶ Reproduzir",
-  "BTN_PLAY_TOOLTIP": "Enviar um comando de reproduzir para todos",
+  "BTN_PLAY_TOOLTIP": "Iniciar a reprodução para todos",
  "BTN_PAUSE": "⏸ Pausar",
-  "BTN_PAUSE_TOOLTIP": "Enviar um comando de pausar para todos",
-  "BTN_SYNC": "⚡ SYNC",
+  "BTN_PAUSE_TOOLTIP": "Pausar o vídeo para todos",
+  "BTN_SYNC": "⚡ SINCRO",
  "BTN_SYNC_TOOLTIP": "Forçar todos os usuários a sincronizar",
-  "OPTION_JUMP_TO_OTHERS": "Ir para os outros",
-  "OPTION_JUMP_TO_ME": "Trazer para mim",
+  "OPTION_JUMP_TO_OTHERS": "Ir para a posição dos outros",
+  "OPTION_JUMP_TO_ME": "Trazer para a minha posição",
  "OPTION_JUMP_MODE_TOOLTIP": "Escolher o alvo de sincronização",
  "LABEL_LAST_ACTIVITY": "Última atividade",
-  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra o comando mais recente de reproduzir, pausar ou buscar",
+  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra o comando mais recente de reproduzir, pausar ou pular",
  "NO_RECENT_COMMANDS": "Sem comandos recentes",
-  "LOBBY_HEADER": "LOBBY DE EPISÓDIO",
+  "LOBBY_HEADER": "SALA DE ESPERA",
  "LOBBY_WAITING_FOR": "🎬 Aguardando: \"{title}\"",
  "LOBBY_WAITING_PEERS": "Aguardando participantes...",
-  "BTN_SKIP_PLAY": "Pular e reproduzir",
-  "BTN_SKIP_PLAY_TOOLTIP": "Cancelar o lobby e reproduzir assim mesmo",
+  "BTN_SKIP_PLAY": "Pular e reproduzir agora",
+  "BTN_SKIP_PLAY_TOOLTIP": "Cancelar a espera e reproduzir mesmo assim",
  "LOBBY_CONNECT_FIRST": "Entre em uma sala primeiro",
  "LOBBY_CONNECT_FIRST_DESC": "Você precisa entrar em uma sala através de um link de convite ou criar uma nova para sincronizar vídeos.",
  "BTN_CREATE_ROOM_ALT": "Criar nova sala",
  "BTN_CREATE_ROOM_ALT_TOOLTIP": "Criar uma nova sala aleatória e entrar",
  "LABEL_USERNAME": "Seu nome de usuário",
-  "LABEL_USERNAME_TOOLTIP": "O nome de usuário ajuda os outros a identificá-lo.",
+  "LABEL_USERNAME_TOOLTIP": "Seu nome visível para os outros.",
  "PLACEHOLDER_USERNAME": "Coala anônimo",
-  "LABEL_HIDE_CLUTTER": "Lista de abas limpa",
-  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra abas que não são de vídeo e domínios não relacionados para manter a lista organizada",
+  "LABEL_HIDE_CLUTTER": "Ocultar abas sem vídeo",
+  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra abas não relacionadas para manter a lista limpa",
  "LABEL_AUTO_SYNC_NEXT": "Sincro auto do próximo episódio",
-  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automaticamente e aguarda todos ao mudar de episódio, depois inicia em sincronia.",
-  "LABEL_AUTO_COPY_INVITE": "Auto-copiar link",
-  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia automaticamente o link de convite para a área de transferência ao criar uma nova sala.",
+  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automaticamente e aguarda todos ao mudar de episódio.",
+  "LABEL_AUTO_COPY_INVITE": "Auto-copiar link de convite",
+  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia automaticamente o link para a área de transferência ao criar uma nova sala.",
  "LABEL_NOTIFICATIONS": "Notificações do navegador",
-  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra notificações do sistema quando alguém entra/sai ou reproduz/pausa.",
+  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra notificações quando alguém entra, sai, reproduz ou pausa.",
  "LABEL_LANGUAGE": "Idioma do aplicativo",
-  "LABEL_LANGUAGE_TOOLTIP": "Escolha o idioma de sua preferência para a extensão",
-  "LABEL_TROUBLESHOOTING": "Resolução de problemas",
-  "LABEL_TROUBLESHOOTING_TOOLTIP": "Ferramentas para solucionar problemas de conexão",
-  "BTN_REGEN_ID": "Regenerar ID de participante",
-  "BTN_REGEN_ID_TOOLTIP": "Regenerar seu ID interno e conectar novamente",
-  "REGEN_ID_DESC": "Use esta opção se notar erros de 'Identidade duplicada'.",
-  "REGEN_ID_OTHER_ISSUE": "Outro problema? Abra um Issue no GitHub",
+  "LABEL_LANGUAGE_TOOLTIP": "Escolha o seu idioma preferido",
+  "LABEL_TROUBLESHOOTING": "Solução de problemas",
+  "LABEL_TROUBLESHOOTING_TOOLTIP": "Ferramentas para corrigir problemas de conexão",
+  "BTN_REGEN_ID": "Regenerar ID do usuário",
+  "BTN_REGEN_ID_TOOLTIP": "Gerar um novo ID interno e conectar novamente",
+  "REGEN_ID_DESC": "Use esta opção se aparecer o erro de 'Identidade duplicada'.",
+  "REGEN_ID_OTHER_ISSUE": "Outro problema? Abra um relatório no GitHub",
  "LABEL_CONN_STATUS": "Status da conexão",
  "LABEL_CONN_STATUS_TOOLTIP": "Status atual da conexão WebSocket",
  "CONN_STATUS_DISCONNECTED": "Desconectado",
-  "BTN_RETRY": "REENTRAR",
+  "BTN_RETRY": "TENTAR NOVAMENTE",
  "BTN_RETRY_TOOLTIP": "Tentar reconectar ao servidor",
  "BTN_COPY_LOGS": "Copiar logs",
-  "BTN_COPY_LOGS_TOOLTIP": "Copiar logs para a área de transferência para compartilhar",
-  "LABEL_VIDEO_DEBUG": "Informações de depuração de vídeo",
-  "LABEL_VIDEO_DEBUG_TOOLTIP": "Detalhes técnicos sobre o elemento de vídeo selecionado atualmente",
+  "BTN_COPY_LOGS_TOOLTIP": "Copiar logs para a área de transferência",
+  "LABEL_VIDEO_DEBUG": "Debug de vídeo",
+  "LABEL_VIDEO_DEBUG_TOOLTIP": "Detalhes técnicos sobre o vídeo selecionado no momento",
  "VIDEO_DEBUG_EMPTY": "Nenhuma aba selecionada ou vídeo detectado.",
  "LABEL_HISTORY": "Histórico completo",
-  "LABEL_HISTORY_TOOLTIP": "Registro cronológico de todos os comandos de sincronização na sala",
+  "LABEL_HISTORY_TOOLTIP": "Registro cronológico de todos os comandos na sala",
  "HISTORY_EMPTY": "Sem atividade ainda",
  "LABEL_LOGS": "Logs (Últimos 50)",
  "LABEL_LOGS_TOOLTIP": "Logs técnicos de conexão para depuração",
  "BTN_CLEAR": "LIMPAR",
-  "BTN_CLEAR_TOOLTIP": "Limpar a saída dos logs",
+  "BTN_CLEAR_TOOLTIP": "Limpar os logs",
  "LABEL_GITHUB": "Repositório GitHub",
  "BTN_ONBOARDING_SKIP": "Pular",
  "BTN_ONBOARDING_SKIP_TOOLTIP": "Pular o tutorial",
  "BTN_ONBOARDING_NEXT": "Próximo",
  "BTN_ONBOARDING_NEXT_TOOLTIP": "Ir para o próximo passo",
  "ONBOARDING_1_TITLE": "Bem-vindo ao KoalaSync!",
-  "ONBOARDING_1_TEXT": "Assista a vídeos juntos em perfeita sincronia, não importa onde estejam. Vamos fazer um tour rápido!",
+  "ONBOARDING_1_TEXT": "Assista a vídeos com seus amigos em perfeita sincronia, não importa onde estejam. Vamos fazer um tour rápido!",
  "ONBOARDING_2_TITLE": "1. Criar uma sala",
  "ONBOARDING_2_TEXT": "Comece aqui. Crie uma sala e compartilhe o link de convite com seus amigos.",
  "ONBOARDING_3_TITLE": "2. Selecionar vídeo",
-  "ONBOARDING_3_TEXT": "Navegue aqui para selecionar o vídeo a ser sincronizado. Reproduza, pause e busque: todos permanecem sincronizados.",
+  "ONBOARDING_3_TEXT": "Navegue aqui para selecionar o vídeo a ser sincronizado. Reproduza, pause e avance — todos verão o mesmo.",
  "ONBOARDING_4_TITLE": "3. Personalizar",
-  "ONBOARDING_4_TEXT": "Escolha um nome de usuário divertido para que seus amigos saibam quem você é.",
+  "ONBOARDING_4_TEXT": "Escolha um nome de usuário divertido para que seus amigos reconheçam você.",
  "ONBOARDING_5_TITLE": "Tudo pronto!",
  "ONBOARDING_5_TEXT": "Hora de pegar a pipoca. Divirta-se assistindo com seus amigos!",
-  "ERR_CONN_TIMEOUT": "Tempo limite de conexão esgotado. Tente novamente.",
+  "ERR_CONN_TIMEOUT": "Tempo limite esgotado. Tente novamente.",
  "ERR_INVALID_SERVER_URL": "Formato de URL do servidor inválido.",
-  "ERR_IDENTITY_NOT_LOADED": "Identidade não carregada ainda. Aguarde um momento e tente novamente.",
-  "ERR_NO_PEERS_TIME": "Nenhum outro participante com posição conhecida. Mude para 'Traerlos a mí' / 'Trazer para mim'.",
+  "ERR_IDENTITY_NOT_LOADED": "Identidade não carregada ainda. Aguarde um momento.",
+  "ERR_NO_PEERS_TIME": "Nenhum participante com posição conhecida. Mude para 'Trazer para a minha posição'.",
  "ERR_NO_VIDEO_TAB": "Não foi possível conectar à aba do vídeo.",
  "ERR_SELECT_VIDEO": "Selecione um vídeo primeiro!",
  "TOAST_INVITE_COPIED": "Link de convite copiado!",
  "TOAST_COPY_FAILED": "Falha ao copiar para a área de transferência",
-  "TOAST_LOBBY_SKIPPED": "Lobby de episódio ignorado.",
-  "TOAST_LOBBY_SKIP_FAILED": "Falha ao ignorar o lobby.",
+  "TOAST_LOBBY_SKIPPED": "Sala de espera ignorada.",
+  "TOAST_LOBBY_SKIP_FAILED": "Falha ao ignorar a sala de espera.",
  "TOAST_LOGS_COPIED": "Copiado!",
  "TOAST_PEER_JOINED": "{name} entrou na sala",
  "TOAST_PEER_LEFT": "{name} saiu da sala",
@@ -146,46 +146,46 @@
  "BTN_STATE_JOINING": "🚀 Entrando...",
  "BTN_STATE_RECONNECTING": "🔄 Reconectando...",
  "BTN_STATE_PLAYING": "▶ Reproduzindo...",
-  "BTN_STATE_PAUSING": "⏸ Pausando...",
+  "BTN_STATE_PAUSING": "⏸ Em pausa...",
  "BTN_STATE_SYNCING_GROUP": "Sincronizando com o grupo ({time})...",
  "BTN_STATE_SYNCING": "Sincronizando...",
  "BTN_STATE_SYNCED": "✅ Sincronizado!",
  "NOTIF_PLAY": "iniciou a reprodução",
-  "NOTIF_PAUSE": "pausou a reprodução",
+  "NOTIF_PAUSE": "pausou o vídeo",
  "NOTIF_SEEK": "mudou a posição do vídeo",
  "NOTIF_FORCE_PREPARE": "iniciou uma sincronização forçada",
  "NOTIF_FORCE_EXECUTE": "sincronizou todos",
-  "DEBUG_NO_TAB": "Nenhuma aba alvo selecionada.",
-  "DEBUG_COMM_FAIL": "Não foi possível comunicar com o vídeo da aba.",
-  "EMPTY_PEERS_TITLE": "Nenhum participante ainda",
+  "DEBUG_NO_TAB": "Nenhuma aba selecionada.",
+  "DEBUG_COMM_FAIL": "Erro ao se comunicar com o vídeo.",
+  "EMPTY_PEERS_TITLE": "Nenhum participante",
  "EMPTY_PEERS_HINT": "Compartilhe seu link de convite para começar",
-  "EMPTY_HISTORY_TITLE": "Sem atividade ainda",
-  "EMPTY_HISTORY_HINT": "Reproduza, pause ou busque para ver o histórico",
+  "EMPTY_HISTORY_TITLE": "Sem atividade",
+  "EMPTY_HISTORY_HINT": "Reproduza ou pause para ver o histórico",
  "EMPTY_LOGS_TITLE": "Sem logs",
  "EMPTY_LOGS_HINT": "Os eventos de conexão aparecerão aqui",
  "EMPTY_ROOMS_TITLE": "Sem salas ativas",
-  "EMPTY_ROOMS_HINT": "Crie uma sala ou atualize para buscar salas públicas",
+  "EMPTY_ROOMS_HINT": "Crie uma sala ou atualize a lista",
  "LABEL_YOU": "Você",
  "ONBOARDING_DONE": "Concluído!",
  "LABEL_LOBBY_PEER_READY": "Pronto",
  "LABEL_LOBBY_PEER_LOADING": "Carregando...",
  "LABEL_PASSWORD_PROTECTED": "Protegido por senha",
  "LABEL_PEERS_COUNT": "{count} participantes",
-  "LABEL_CUSTOM_SERVER": "Servidor personalizado",
+  "LABEL_CUSTOM_SERVER": "Servidor privado",
  "BTN_STATE_CREATING": "🚀 Criando sala...",
  "NOTIF_LOBBY_CANCEL_TITLE": "KoalaSync — Falha na sincronização do episódio",
-  "NOTIF_LOBBY_CANCEL_MSG": "Sincronização automática cancelada: {reason}. Pode ser necessário sincronizar manualmente.",
+  "NOTIF_LOBBY_CANCEL_MSG": "Sincronização automática cancelada: {reason}. Você deve sincronizar manualmente.",
  "LOBBY_CANCEL_TIMEOUT": "Tempo limite esgotado",
-  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Tempo limite esgotado (recuperado)",
+  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Tempo limite (recuperado)",
  "LOBBY_CANCEL_PEERS_LEFT": "Todos os outros participantes saíram",
-  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Tempo limite esgotado — nem todos os participantes carregaram o episódio",
+  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Tempo limite — nem todos carregaram o episódio",
  "LOBBY_CANCEL_USER": "Cancelado pelo usuário",
-  "NOTIF_ERROR_TITLE": "Erro do KoalaSync",
+  "NOTIF_ERROR_TITLE": "Erro no KoalaSync",
  "FOOTER_SUPPORT": "☕ Me pague um café",
  "FOOTER_REVIEW": "★ Avaliar",
  "FOOTER_SUPPORT_PROMPT": "Gostou do KoalaSync? Deixe uma avaliação!",
  "LABEL_AUDIO_PROCESSING": "Processamento de áudio",
-  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Aplica efeitos de áudio como compressão à reprodução de vídeo",
+  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Aplica efeitos de áudio (como compressão) aos vídeos",
  "AUDIO_OPEN_SETTINGS": "Abrir",
  "NEW_FEATURE_AUDIO": "Novo: Processamento de áudio — experimente o compressor!",
  "AUDIO_BACK": "← Voltar",
@@ -196,14 +196,17 @@
  "AUDIO_PRESET": "Predefinição",
  "AUDIO_PRESET_RECOMMENDED": "Recomendado",
  "AUDIO_PRESET_DYNAMIC_RANGE": "Faixa dinâmica",
-  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Aprimoramento de voz",
+  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Aprimoramento vocal",
  "AUDIO_PRESET_SMOOTH": "Suave",
  "AUDIO_PRESET_CUSTOM": "Personalizado",
-  "AUDIO_PARAM_THRESHOLD": "Limiar",
-  "AUDIO_PARAM_KNEE": "Knee",
-  "AUDIO_PARAM_RATIO": "Ratio",
-  "AUDIO_PARAM_ATTACK": "Attack",
-  "AUDIO_PARAM_RELEASE": "Release",
+  "AUDIO_PARAM_THRESHOLD": "Limiar (Threshold)",
+  "AUDIO_PARAM_KNEE": "Joelho (Knee)",
+  "AUDIO_PARAM_RATIO": "Razão (Ratio)",
+  "AUDIO_PARAM_ATTACK": "Ataque (Attack)",
+  "AUDIO_PARAM_RELEASE": "Liberação (Release)",
  "AUDIO_EQUALIZER": "Equalizador",
-  "AUDIO_COMING_SOON": "Em breve"
+  "AUDIO_COMING_SOON": "Em breve",
+  "BTN_RESTART_TOUR": "Reiniciar tutorial",
+  "BTN_RESTART_TOUR_TOOLTIP": "Reiniciar o tutorial de introdução",
+  "HINT_SELECT_VIDEO": "Selecione seu vídeo aqui!"
 }
@@ -4,136 +4,136 @@
  "APP_TITLE": "KoalaSync",
  "TAB_ROOM": "Sala",
  "TAB_ROOM_TOOLTIP": "Definições da sala e ligação",
-  "TAB_SYNC": "Sincronização",
+  "TAB_SYNC": "Sincronia",
  "TAB_SYNC_TOOLTIP": "Controlo de sincronização de vídeo e ações remotas",
  "TAB_SETTINGS": "Definições",
  "TAB_SETTINGS_TOOLTIP": "Preferências da extensão",
  "TAB_STATUS": "Estado",
-  "TAB_STATUS_TOOLTIP": "Diagnóstico avanzado e registos",
+  "TAB_STATUS_TOOLTIP": "Diagnóstico avançado e registos",
  "BTN_CREATE_ROOM": "+ Criar Nova Sala",
  "MANUAL_CONNECT_HEADER": "Ligação Manual / Avançado",
  "LABEL_SERVER": "Servidor",
  "BTN_SERVER_OFFICIAL": "Oficial",
  "BTN_SERVER_OFFICIAL_TOOLTIP": "Usar o servidor oficial fiável",
  "BTN_SERVER_CUSTOM": "Personalizado",
-  "BTN_SERVER_CUSTOM_TOOLTIP": "Ligar ao seu próprio servidor auto-hospedado",
+  "BTN_SERVER_CUSTOM_TOOLTIP": "Ligar ao seu próprio servidor privado",
  "PLACEHOLDER_SERVER_URL": "wss://o-seu-servidor:3000",
  "LABEL_ROOM_ID": "ID da Sala",
-  "LABEL_ROOM_ID_TOOLTIP": "O identificador exclusivo para a sua sala de sincronização",
+  "LABEL_ROOM_ID_TOOLTIP": "O identificador exclusivo para a sua sala",
  "PLACEHOLDER_ROOM_ID": "Introduzir ID da Sala",
-  "PLACEHOLDER_ROOM_ID_TOOLTIP": "O ID exclusivo da sala à qual deseja aderir",
+  "PLACEHOLDER_ROOM_ID_TOOLTIP": "O ID da sala à qual deseja aceder",
  "LABEL_PASSWORD": "Palavra-passe (Opcional)",
-  "LABEL_PASSWORD_TOOLTIP": "Palavra-passe opcional para restringir o acesso à sala",
-  "PLACEHOLDER_PASSWORD": "Palavra-passe da sala (opcional)",
-  "PLACEHOLDER_PASSWORD_TOOLTIP": "Palavra-passe para la sala (deixar em branco se não houver)",
+  "LABEL_PASSWORD_TOOLTIP": "Palavra-passe para restringir o acesso à sala",
+  "PLACEHOLDER_PASSWORD": "Palavra-passe da sala",
+  "PLACEHOLDER_PASSWORD_TOOLTIP": "Deixe em branco se não houver palavra-passe",
  "BTN_JOIN_ROOM": "Entrar / Criar Sala",
-  "BTN_JOIN_ROOM_TOOLTIP": "Ligar à sala",
+  "BTN_JOIN_ROOM_TOOLTIP": "Entrar na sala",
  "LABEL_PUBLIC_ROOMS": "Salas Públicas",
-  "LABEL_PUBLIC_ROOMS_TOOLTIP": "Lista de salas públicas disponíveis neste servidor",
+  "LABEL_PUBLIC_ROOMS_TOOLTIP": "Lista de salas públicas neste servidor",
  "BTN_REFRESH": "ATUALIZAR",
-  "BTN_REFRESH_TOOLTIP": "Atualizar a lista de salas públicas",
+  "BTN_REFRESH_TOOLTIP": "Atualizar a lista de salas",
  "PUBLIC_ROOMS_REFRESHING": "A atualizar...",
  "BTN_REFRESH_COOLDOWN": "AGUARDE {seconds}s",
-  "BTN_REFRESH_COOLDOWN_TOOLTIP": "A atualização da lista de salas está em espera. Tente novamente em {seconds}s.",
-  "PUBLIC_ROOMS_REFRESHING_COOLDOWN": "A atualizar salas públicas. Próxima atualização disponível em {seconds}s.",
+  "BTN_REFRESH_COOLDOWN_TOOLTIP": "A atualização está em espera. Tente novamente em {seconds}s.",
+  "PUBLIC_ROOMS_REFRESHING_COOLDOWN": "A atualizar salas. Próxima atualização em {seconds}s.",
  "LABEL_ACTIVE_ROOM": "Sala Ativa",
  "LABEL_ACTIVE_ROOM_TOOLTIP": "A sala à qual está atualmente ligado",
  "ACTIVE_ROOM_NONE": "NENHUMA",
  "ACTIVE_SERVER_OFFICIAL": "Servidor Oficial",
-  "LABEL_INVITE_LINK": "Link de Invito",
-  "LABEL_INVITE_LINK_TOOLTIP": "Partilhar este link com os amigos para que possam entrar",
+  "LABEL_INVITE_LINK": "Link de Convite",
+  "LABEL_INVITE_LINK_TOOLTIP": "Partilhe este link com os amigos para que possam entrar",
  "LABEL_PEERS_IN_ROOM": "Participantes na Sala",
-  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Outros utilizadores attualmente ligados a questa sala",
-  "NO_PEERS_CONNECTED": "Nenhum partecipante ligado",
-  "BTN_LEAVE_ROOM": "Sair della Sala",
+  "LABEL_PEERS_IN_ROOM_TOOLTIP": "Utilizadores atualmente ligados a esta sala",
+  "NO_PEERS_CONNECTED": "Nenhum participante ligado",
+  "BTN_LEAVE_ROOM": "Sair da Sala",
  "LABEL_SELECT_VIDEO": "Selecionar Vídeo",
-  "LABEL_SELECT_VIDEO_TOOLTIP": "Escolher o separador do navegador que contém o vídeo a sincronizar",
+  "LABEL_SELECT_VIDEO_TOOLTIP": "Escolha o separador do navegador com o vídeo a sincronizar",
  "OPTION_SELECT_TAB": "-- Selecionar um Separador --",
  "LABEL_REMOTE_CONTROL": "Controlo Remoto",
-  "BTN_COPY_INVITE": "📋 Link de Invito",
-  "BTN_COPY_INVITE_TOOLTIP": "Copiar Link de Invito",
+  "BTN_COPY_INVITE": "📋 Link de Convite",
+  "BTN_COPY_INVITE_TOOLTIP": "Copiar Link de Convite",
  "BTN_PLAY": "▶ Reproduzir",
-  "BTN_PLAY_TOOLTIP": "Enviar um comando de Reproduzir para todos",
+  "BTN_PLAY_TOOLTIP": "Iniciar a reprodução para todos",
  "BTN_PAUSE": "⏸ Pausa",
-  "BTN_PAUSE_TOOLTIP": "Enviar um comando de Pausa para todos",
-  "BTN_SYNC": "⚡ SYNC",
-  "BTN_SYNC_TOOLTIP": "Forçar todos os utilizadores a sincronizarem-se",
-  "OPTION_JUMP_TO_OTHERS": "Ir para os Outros",
-  "OPTION_JUMP_TO_ME": "Ir para Mim",
+  "BTN_PAUSE_TOOLTIP": "Pausar o vídeo para todos",
+  "BTN_SYNC": "⚡ SINCRO",
+  "BTN_SYNC_TOOLTIP": "Forçar sincronização de todos os utilizadores",
+  "OPTION_JUMP_TO_OTHERS": "Ir para a posição dos outros",
+  "OPTION_JUMP_TO_ME": "Trazer para a minha posição",
  "OPTION_JUMP_MODE_TOOLTIP": "Escolher o destino de sincronização",
-  "LABEL_LAST_ACTIVITY": "Estado da Última Atividade",
-  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra o comando mais recente de reproduzir, pausa ou busca",
+  "LABEL_LAST_ACTIVITY": "Última Atividade",
+  "LABEL_LAST_ACTIVITY_TOOLTIP": "Mostra o comando mais recente",
  "NO_RECENT_COMMANDS": "Nenhum comando recente",
-  "LOBBY_HEADER": "LOBBY DE EPISÓDIO",
-  "LOBBY_WAITING_FOR": "🎬 A aguardar: \"{title}\"",
-  "LOBBY_WAITING_PEERS": "A aguardar participantes...",
-  "BTN_SKIP_PLAY": "Ignorar e reproduzir mesmo assim",
-  "BTN_SKIP_PLAY_TOOLTIP": "Cancelar o lobby e reproduzir mesmo assim",
-  "LOBBY_CONNECT_FIRST": "Ligar-se primeiro a uma sala",
+  "LOBBY_HEADER": "SALA DE ESPERA",
+  "LOBBY_WAITING_FOR": "🎬 À espera de: \"{title}\"",
+  "LOBBY_WAITING_PEERS": "À espera dos participantes...",
+  "BTN_SKIP_PLAY": "Ignorar e reproduzir agora",
+  "BTN_SKIP_PLAY_TOOLTIP": "Cancelar a espera e reproduzir mesmo assim",
+  "LOBBY_CONNECT_FIRST": "Ligue-se primeiro a uma sala",
  "LOBBY_CONNECT_FIRST_DESC": "Precisa de entrar numa sala através de um link de convite ou criar uma nova para sincronizar vídeos.",
  "BTN_CREATE_ROOM_ALT": "Criar Nova Sala",
-  "BTN_CREATE_ROOM_ALT_TOOLTIP": "Criar uma nova sala aleatória e entrar nela",
+  "BTN_CREATE_ROOM_ALT_TOOLTIP": "Criar uma sala aleatória e entrar nela",
  "LABEL_USERNAME": "O seu Nome de Utilizador",
-  "LABEL_USERNAME_TOOLTIP": "O nome de utilizador ajuda os outros a identificá-lo.",
+  "LABEL_USERNAME_TOOLTIP": "O seu nome visível para os outros.",
  "PLACEHOLDER_USERNAME": "Coala Anónimo",
-  "LABEL_HIDE_CLUTTER": "Ocultar Separadores Desnecessários",
-  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra separadores sem vídeo e domínios não relacionados para manter a lista limpa",
-  "LABEL_AUTO_SYNC_NEXT": "Sincronização Automática do Próximo Episódio",
-  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automaticamente e aguarda por todos os participantes quando um episódio muda, iniciando depois a reprodução em sincronia.",
-  "LABEL_AUTO_COPY_INVITE": "Copiar Automaticamente o Link de Convite",
-  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia automaticamente o link de convite para a área de transferência ao criar uma nova sala.",
+  "LABEL_HIDE_CLUTTER": "Ocultar separadores sem vídeo",
+  "LABEL_HIDE_CLUTTER_TOOLTIP": "Filtra separadores não relacionados para manter a lista limpa",
+  "LABEL_AUTO_SYNC_NEXT": "Sincro Auto do Próximo Episódio",
+  "LABEL_AUTO_SYNC_NEXT_TOOLTIP": "Pausa automaticamente e aguarda por todos ao mudar de episódio.",
+  "LABEL_AUTO_COPY_INVITE": "Copiar Convite Automaticamente",
+  "LABEL_AUTO_COPY_INVITE_TOOLTIP": "Copia automaticamente o link para a área de transferência ao criar uma nova sala.",
  "LABEL_NOTIFICATIONS": "Notificações do Navegador",
-  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra notificações do sistema quando alguém entra/sai ou reproduz/pausa.",
-  "LABEL_LANGUAGE": "Idioma da App",
-  "LABEL_LANGUAGE_TOOLTIP": "Escolha o seu idioma de preferência para a extensão",
+  "LABEL_NOTIFICATIONS_TOOLTIP": "Mostra notificações quando alguém entra, sai, reproduz ou pausa.",
+  "LABEL_LANGUAGE": "Idioma da Aplicação",
+  "LABEL_LANGUAGE_TOOLTIP": "Escolha o seu idioma de preferência",
  "LABEL_TROUBLESHOOTING": "Resolução de Problemas",
  "LABEL_TROUBLESHOOTING_TOOLTIP": "Ferramentas para corrigir problemas de ligação",
-  "BTN_REGEN_ID": "Regerar ID do Peer",
+  "BTN_REGEN_ID": "Regerar ID do Utilizador",
  "BTN_REGEN_ID_TOOLTIP": "Regerar o seu ID interno e voltar a ligar",
-  "REGEN_ID_DESC": "Use isto se vir erros de \"Identidade Duplicata\".",
-  "REGEN_ID_OTHER_ISSUE": "Outro problema? Abra um Issue no GitHub",
+  "REGEN_ID_DESC": "Use isto se encontrar erros de 'Identidade Duplicada'.",
+  "REGEN_ID_OTHER_ISSUE": "Outro problema? Abra um relatório no GitHub",
  "LABEL_CONN_STATUS": "Estado da Ligação",
-  "LABEL_CONN_STATUS_TOOLTIP": "Estado atual da ligação WebSocket",
+  "LABEL_CONN_STATUS_TOOLTIP": "Estado atual da ligação",
  "CONN_STATUS_DISCONNECTED": "Desligado",
  "BTN_RETRY": "TENTAR NOVAMENTE",
  "BTN_RETRY_TOOLTIP": "Tentar voltar a ligar ao servidor",
  "BTN_COPY_LOGS": "Copiar Registos",
-  "BTN_COPY_LOGS_TOOLTIP": "Copiar registos para a área de transferência para partilha",
-  "LABEL_VIDEO_DEBUG": "Info de Debug de Vídeo",
-  "LABEL_VIDEO_DEBUG_TOOLTIP": "Detalhes técnicos sobre o elemento de vídeo atualmente seleccionado",
+  "BTN_COPY_LOGS_TOOLTIP": "Copiar registos para a área de transferência",
+  "LABEL_VIDEO_DEBUG": "Debug de Vídeo",
+  "LABEL_VIDEO_DEBUG_TOOLTIP": "Detalhes técnicos sobre o vídeo atualmente selecionado",
  "VIDEO_DEBUG_EMPTY": "Nenhum separador selecionado ou vídeo detetado.",
-  "LABEL_HISTORY": "Histórico Completo de Ações",
-  "LABEL_HISTORY_TOOLTIP": "Registo cronológico de todos os comandos de sincronização na sala",
+  "LABEL_HISTORY": "Histórico Completo",
+  "LABEL_HISTORY_TOOLTIP": "Registo cronológico de todos os comandos na sala",
  "HISTORY_EMPTY": "Nenhuma atividade ainda",
  "LABEL_LOGS": "Registos (Últimos 50)",
-  "LABEL_LOGS_TOOLTIP": "Registos de ligação técnica para depuração",
+  "LABEL_LOGS_TOOLTIP": "Registos técnicos para depuração",
  "BTN_CLEAR": "LIMPAR",
-  "BTN_CLEAR_TOOLTIP": "Limpar a saída do registo",
+  "BTN_CLEAR_TOOLTIP": "Limpar os registos",
  "LABEL_GITHUB": "Repositório GitHub",
  "BTN_ONBOARDING_SKIP": "Saltar",
  "BTN_ONBOARDING_SKIP_TOOLTIP": "Saltar o tutorial",
  "BTN_ONBOARDING_NEXT": "Seguinte",
  "BTN_ONBOARDING_NEXT_TOOLTIP": "Ir para o passo seguinte",
  "ONBOARDING_1_TITLE": "Bem-vindo ao KoalaSync!",
-  "ONBOARDING_1_TEXT": "Veja vídeos em conjunto numa sincronizzazione perfetta — não importa onde esteja. Vamos fare uma breve visita guiada!",
+  "ONBOARDING_1_TEXT": "Veja vídeos em conjunto com os seus amigos em sincronia perfeita. Vamos fazer uma breve visita guiada!",
  "ONBOARDING_2_TITLE": "1. Criar uma Sala",
  "ONBOARDING_2_TEXT": "Comece aqui. Crie uma sala e partilhe o link de convite com os seus amigos.",
  "ONBOARDING_3_TITLE": "2. Selecionar Vídeo",
-  "ONBOARDING_3_TEXT": "Navegue até aqui para selecionar o vídeo que deseja sincronizar. Reproduza, pause e avance — todos ficam em sincronia.",
+  "ONBOARDING_3_TEXT": "Navegue até aqui para selecionar o vídeo a sincronizar. Reproduza, pause e avance — todos vêm o mesmo.",
  "ONBOARDING_4_TITLE": "3. Personalizar",
-  "ONBOARDING_4_TEXT": "Escolha um nome de utilizador divertido para que os seus amigos saibam quem você é.",
+  "ONBOARDING_4_TEXT": "Escolha um nome de utilizador divertido para que os seus amigos o reconheçam.",
  "ONBOARDING_5_TITLE": "Está tudo pronto!",
-  "ONBOARDING_5_TEXT": "Altura de ir buscar pipocas. Divirtam-se a ver juntos!",
+  "ONBOARDING_5_TEXT": "Hora de ir buscar as pipocas. Divirtam-se!",
  "ERR_CONN_TIMEOUT": "Ligação expirada. Tente novamente.",
-  "ERR_INVALID_SERVER_URL": "Formato de URL do Servidor inválido.",
-  "ERR_IDENTITY_NOT_LOADED": "Identidade ainda não carregada. Aguarde um momento e tente novamente.",
-  "ERR_NO_PEERS_TIME": "Nenhum outro peer com hora conhecida. Mude para 'Ir para Mim'.",
-  "ERR_NO_VIDEO_TAB": "Não foi possível ligar ao separador do vídeo.",
+  "ERR_INVALID_SERVER_URL": "Formato de URL do servidor inválido.",
+  "ERR_IDENTITY_NOT_LOADED": "Identidade ainda não carregada. Aguarde um momento.",
+  "ERR_NO_PEERS_TIME": "Nenhum participante com hora conhecida. Mude para 'Trazer para a minha posição'.",
+  "ERR_NO_VIDEO_TAB": "Não foi possível aceder ao separador do vídeo.",
  "ERR_SELECT_VIDEO": "Selecione primeiro um vídeo!",
  "TOAST_INVITE_COPIED": "Link de convite copiado!",
  "TOAST_COPY_FAILED": "Falha ao copiar para a área de transferência",
-  "TOAST_LOBBY_SKIPPED": "Lobby do episódio ignorado.",
-  "TOAST_LOBBY_SKIP_FAILED": "Falha ao ignorar o lobby.",
+  "TOAST_LOBBY_SKIPPED": "Sala de espera ignorada.",
+  "TOAST_LOBBY_SKIP_FAILED": "Falha ao ignorar a sala de espera.",
  "TOAST_LOGS_COPIED": "Copiado!",
  "TOAST_PEER_JOINED": "{name} entrou na sala",
  "TOAST_PEER_LEFT": "{name} saiu da sala",
@@ -146,64 +146,67 @@
  "BTN_STATE_JOINING": "🚀 A entrar...",
  "BTN_STATE_RECONNECTING": "🔄 A voltar a ligar...",
  "BTN_STATE_PLAYING": "▶ A reproduzir...",
-  "BTN_STATE_PAUSING": "⏸ A pausar...",
-  "BTN_STATE_SYNCING_GROUP": "A sincronizar com o grupo ({time})....",
+  "BTN_STATE_PAUSING": "⏸ Em pausa...",
+  "BTN_STATE_SYNCING_GROUP": "A sincronizar em grupo ({time})....",
  "BTN_STATE_SYNCING": "A sincronizar...",
  "BTN_STATE_SYNCED": "✅ Sincronizado!",
  "NOTIF_PLAY": "iniciou a reprodução",
-  "NOTIF_PAUSE": "pausou a reprodução",
-  "NOTIF_SEEK": "avançou/recuou no vídeo",
-  "NOTIF_FORCE_PREPARE": "iniciou a sincronização forçada",
+  "NOTIF_PAUSE": "pausou o vídeo",
+  "NOTIF_SEEK": "mudou a posição do vídeo",
+  "NOTIF_FORCE_PREPARE": "iniciou uma sincronização forçada",
  "NOTIF_FORCE_EXECUTE": "sincronizou todos",
-  "DEBUG_NO_TAB": "Nenhum separador de destino selecionado.",
-  "DEBUG_COMM_FAIL": "Não foi possível comunicar com o vídeo do separador.",
-  "EMPTY_PEERS_TITLE": "Nenhum participante ainda",
+  "DEBUG_NO_TAB": "Nenhum separador selecionado.",
+  "DEBUG_COMM_FAIL": "Erro ao comunicar com o vídeo.",
+  "EMPTY_PEERS_TITLE": "Nenhum participante",
  "EMPTY_PEERS_HINT": "Partilhe o seu link de convite para começar",
-  "EMPTY_HISTORY_TITLE": "Nenhuma atividade ainda",
-  "EMPTY_HISTORY_HINT": "Reproduza, pause ou avance para ver o histórico",
-  "EMPTY_LOGS_TITLE": "Nenhum registo",
-  "EMPTY_LOGS_HINT": "Os eventi de ligação vão aparecer aqui",
+  "EMPTY_HISTORY_TITLE": "Nenhuma atividade",
+  "EMPTY_HISTORY_HINT": "Reproduza ou pause para ver o histórico",
+  "EMPTY_LOGS_TITLE": "Sem registos",
+  "EMPTY_LOGS_HINT": "Os eventos de ligação vão aparecer aqui",
  "EMPTY_ROOMS_TITLE": "Nenhuma sala ativa",
-  "EMPTY_ROOMS_HINT": "Crie uma sala ou atualize para encontrar salas públicas",
+  "EMPTY_ROOMS_HINT": "Crie uma sala ou atualize a lista",
  "LABEL_YOU": "Tu",
  "ONBOARDING_DONE": "Concluído!",
  "LABEL_LOBBY_PEER_READY": "Pronto",
  "LABEL_LOBBY_PEER_LOADING": "A carregar...",
  "LABEL_PASSWORD_PROTECTED": "Protegido por Palavra-passe",
  "LABEL_PEERS_COUNT": "{count} participantes",
-  "LABEL_CUSTOM_SERVER": "Servidor Personalizado",
+  "LABEL_CUSTOM_SERVER": "Servidor Privado",
  "BTN_STATE_CREATING": "🚀 A Criar Sala...",
-  "NOTIF_LOBBY_CANCEL_TITLE": "KoalaSync — Sincronização do Episódio Falhou",
+  "NOTIF_LOBBY_CANCEL_TITLE": "KoalaSync — Falha na Sincronização do Episódio",
  "NOTIF_LOBBY_CANCEL_MSG": "Sincronização automática cancelada: {reason}. Pode ter de sincronizar manualmente.",
-  "LOBBY_CANCEL_TIMEOUT": "Timeout",
-  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Timeout (recuperado)",
+  "LOBBY_CANCEL_TIMEOUT": "Tempo limite expirado",
+  "LOBBY_CANCEL_TIMEOUT_RECOVERED": "Tempo limite (recuperado)",
  "LOBBY_CANCEL_PEERS_LEFT": "Todos os outros participantes saíram",
-  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Timeout — nem todos os participantes carregaram o episódio",
+  "LOBBY_CANCEL_TIMEOUT_PEERS_LOAD": "Tempo limite — alguns participantes não carregaram o episódio",
  "LOBBY_CANCEL_USER": "Cancelado pelo utilizador",
-  "NOTIF_ERROR_TITLE": "Erro do KoalaSync",
-  "FOOTER_SUPPORT": "☕ Oferece um café",
+  "NOTIF_ERROR_TITLE": "Erro no KoalaSync",
+  "FOOTER_SUPPORT": "☕ Oferece-me um café",
  "FOOTER_REVIEW": "★ Avaliar",
  "FOOTER_SUPPORT_PROMPT": "Gostas do KoalaSync? Deixa uma avaliação!",
-  "LABEL_AUDIO_PROCESSING": "Processamento de áudio",
-  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Aplica efeitos de áudio como compressão à reprodução de vídeo",
+  "LABEL_AUDIO_PROCESSING": "Processamento de Áudio",
+  "LABEL_AUDIO_PROCESSING_TOOLTIP": "Aplica efeitos de áudio (como compressão) aos vídeos",
  "AUDIO_OPEN_SETTINGS": "Abrir",
  "NEW_FEATURE_AUDIO": "Novo: Processamento de áudio — experimente o compressor!",
  "AUDIO_BACK": "← Voltar",
-  "AUDIO_PAGE_TITLE": "Configurações de áudio",
-  "AUDIO_MASTER_TOGGLE": "Processamento de áudio",
+  "AUDIO_PAGE_TITLE": "Configurações de Áudio",
+  "AUDIO_MASTER_TOGGLE": "Processamento de Áudio",
  "AUDIO_COMPRESSOR": "Compressor",
  "AUDIO_COMPRESSOR_ENABLE": "Ativado",
  "AUDIO_PRESET": "Predefinição",
  "AUDIO_PRESET_RECOMMENDED": "Recomendado",
-  "AUDIO_PRESET_DYNAMIC_RANGE": "Gama dinâmica",
-  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Melhoria vocal",
+  "AUDIO_PRESET_DYNAMIC_RANGE": "Gama Dinâmica",
+  "AUDIO_PRESET_VOCAL_ENHANCEMENT": "Melhoria Vocal",
  "AUDIO_PRESET_SMOOTH": "Suave",
  "AUDIO_PRESET_CUSTOM": "Personalizado",
-  "AUDIO_PARAM_THRESHOLD": "Limiar",
-  "AUDIO_PARAM_KNEE": "Knee",
-  "AUDIO_PARAM_RATIO": "Ratio",
-  "AUDIO_PARAM_ATTACK": "Attack",
-  "AUDIO_PARAM_RELEASE": "Release",
+  "AUDIO_PARAM_THRESHOLD": "Limiar (Threshold)",
+  "AUDIO_PARAM_KNEE": "Joelho (Knee)",
+  "AUDIO_PARAM_RATIO": "Rácio (Ratio)",
+  "AUDIO_PARAM_ATTACK": "Ataque (Attack)",
+  "AUDIO_PARAM_RELEASE": "Libertação (Release)",
  "AUDIO_EQUALIZER": "Equalizador",
-  "AUDIO_COMING_SOON": "Em breve"
+  "AUDIO_COMING_SOON": "Em breve",
+  "BTN_RESTART_TOUR": "Reiniciar Tutorial",
+  "BTN_RESTART_TOUR_TOOLTIP": "Reiniciar o tutorial introdutório",
+  "HINT_SELECT_VIDEO": "Selecione o seu vídeo aqui!"
 }
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Эквалайзер",
-  "AUDIO_COMING_SOON": "Скоро"
+  "AUDIO_COMING_SOON": "Скоро",
+  "BTN_RESTART_TOUR": "Перезапустить обучение",
+  "BTN_RESTART_TOUR_TOOLTIP": "Запустить приветственное руководство заново",
+  "HINT_SELECT_VIDEO": "Выберите ваше видео здесь!"
 }
@@ -205,5 +205,8 @@
  "AUDIO_PARAM_ATTACK": "Attack",
  "AUDIO_PARAM_RELEASE": "Release",
  "AUDIO_EQUALIZER": "Ekolayzer",
-  "AUDIO_COMING_SOON": "Çok yakında"
+  "AUDIO_COMING_SOON": "Çok yakında",
+  "BTN_RESTART_TOUR": "Eğitimi Yeniden Başlat",
+  "BTN_RESTART_TOUR_TOOLTIP": "Tanıtım eğitimini yeniden başlat",
+  "HINT_SELECT_VIDEO": "Videonuzu buradan seçin!"
 }
@@ -1,7 +1,8 @@
 {
  "manifest_version": 3,
+  "default_locale": "en",
  "name": "KoalaSync",
-  "version": "2.2.0",
+  "version": "2.4.1",
  "description": "Synchronize video playback on YouTube, Netflix, Emby, Jellyfin, and any HTML5 site in real-time with friends.",
  "permissions": [
    "storage",
@@ -364,6 +364,14 @@
            0%, 100% { opacity: 0.4; transform: scale(1); }
            50% { opacity: 1; transform: scale(1.3); }
        }
+        @keyframes spotlightPulse {
+            0%, 100% { box-shadow: 0 0 0 9999px rgba(15, 23, 42, 0.65), 0 0 0 0px var(--accent); }
+            50% { box-shadow: 0 0 0 9999px rgba(15, 23, 42, 0.65), 0 0 0 6px var(--accent); }
+        }
+        @keyframes floatHint {
+            0%, 100% { transform: translateY(0); }
+            50% { transform: translateY(-4px); }
+        }
    </style>
 </head>
 <body>
@@ -457,11 +465,16 @@
    <div id="tab-sync" class="tab-content">
        <!-- SYNC ACTIVE: Visible when in a room -->
        <div id="sync-active">
-        <div class="form-group">
+        <div class="form-group" style="position: relative;">
            <label title="Choose the browser tab containing the video to sync" data-i18n="LABEL_SELECT_VIDEO" data-i18n-title="LABEL_SELECT_VIDEO_TOOLTIP">Select Video</label>
            <select id="targetTab">
                <option value="" data-i18n="OPTION_SELECT_TAB">-- Select a Tab --</option>
            </select>
+            <!-- Hint Tooltip -->
+            <div id="targetTabHint" style="display: none; position: absolute; top: -25px; right: 0; background: var(--accent); color: white; padding: 4px 8px; border-radius: 6px; font-size: 11px; font-weight: bold; pointer-events: none; animation: floatHint 2s ease-in-out infinite; box-shadow: 0 4px 12px rgba(99, 102, 241, 0.4); z-index: 10;" data-i18n="HINT_SELECT_VIDEO">
+                Select your video here!
+                <div style="position: absolute; bottom: -4px; right: 20px; width: 8px; height: 8px; background: var(--accent); transform: rotate(45deg);"></div>
+            </div>
        </div>
        
        <div style="display: flex; justify-content: space-between; align-items: center; margin-bottom: 4px;">
@@ -577,7 +590,8 @@

        <div style="margin-top: 15px; padding: 8px; border-top: 1px solid var(--card);">
            <label title="Tools for fixing connection issues" data-i18n="LABEL_TROUBLESHOOTING" data-i18n-title="LABEL_TROUBLESHOOTING_TOOLTIP">Troubleshooting</label>
-            <button id="regenId" class="secondary" style="width: 100%; font-size: 11px;" title="Regenerate your internal ID and reconnect" data-i18n="BTN_REGEN_ID" data-i18n-title="BTN_REGEN_ID_TOOLTIP">Regenerate Peer ID</button>
+            <button id="restartTourBtn" class="secondary" style="width: 100%; font-size: 11px;" title="Restart the onboarding tutorial" data-i18n="BTN_RESTART_TOUR" data-i18n-title="BTN_RESTART_TOUR_TOOLTIP">Restart Tutorial</button>
+            <button id="regenId" class="secondary" style="width: 100%; font-size: 11px; margin-top: 8px;" title="Regenerate your internal ID and reconnect" data-i18n="BTN_REGEN_ID" data-i18n-title="BTN_REGEN_ID_TOOLTIP">Regenerate Peer ID</button>
            <p style="font-size: 9px; color: var(--text-muted); margin-top: 5px; text-align: center;" data-i18n="REGEN_ID_DESC">Use this if you see "Duplicate Identity" errors.</p>
            <p style="font-size: 9px; text-align: center; margin-top: 6px;"><a href="https://github.com/Shik3i/KoalaSync/issues" target="_blank" style="color: var(--accent); text-decoration: none;" data-i18n="REGEN_ID_OTHER_ISSUE">Other issue? Open a GitHub Issue</a></p>
        </div>
@@ -598,8 +612,9 @@
        <div id="connStatus" class="info-card" style="display:flex; align-items:center; gap: 10px;">
            <span id="connDot" class="status-dot status-offline"></span>
            <span id="connText" style="flex:1;">Disconnected</span>
+            <span id="connPing" style="font-size:11px; font-family:monospace; font-weight:600; opacity:0.8;"></span>
            <button id="retryBtn" class="secondary" style="display:none; width: auto; padding: 4px 8px; font-size: 10px; margin: 0;" title="Attempt to reconnect to the server" data-i18n="BTN_RETRY" data-i18n-title="BTN_RETRY_TOOLTIP">RETRY</button>
-            <button id="copyLogs" class="btn secondary" style="width: auto; padding: 4px 10px; font-size: 11px;" title="Copy logs to clipboard for sharing" data-i18n="BTN_COPY_LOGS" data-i18n-title="BTN_COPY_LOGS_TOOLTIP">Copy Logs</button>
+            <button id="copyLogs" class="btn secondary" style="width: auto; padding: 4px 10px; font-size: 11px; margin: 0;" title="Copy logs to clipboard for sharing" data-i18n="BTN_COPY_LOGS" data-i18n-title="BTN_COPY_LOGS_TOOLTIP">Copy Logs</button>
        </div>

        <label title="Technical details about the currently selected video element" data-i18n="LABEL_VIDEO_DEBUG" data-i18n-title="LABEL_VIDEO_DEBUG_TOOLTIP">Video Debug Info</label>
@@ -636,16 +651,31 @@
    <script src="popup.js" type="module"></script>

    <!-- Onboarding Overlay -->
-    <div id="onboarding-overlay" style="display:none; position:fixed; inset:0; background:rgba(0,0,0,0.5); backdrop-filter: blur(2px); z-index:1000; align-items:flex-end; justify-content:center; padding-bottom: 20px;">
-        <div id="onboarding-card" style="background:var(--card); padding:24px; border-radius:16px; max-width:280px; width:90%; text-align:center; box-shadow:0 8px 32px rgba(0,0,0,0.5); ">
-            <div id="onboarding-icon" style="font-size:48px; margin-bottom:12px;">👋</div>
-            <h2 id="onboarding-title" style="color:var(--accent); margin:0 0 8px; font-size:16px;">Welcome to KoalaSync!</h2>
-            <p id="onboarding-text" style="color:var(--text-muted); font-size:13px; margin:0 0 16px; line-height:1.4;">Let's get you started.</p>
-            <div style="display:flex; gap:8px; justify-content:center;">
-                <button id="onboarding-skip" class="secondary" style="width:auto; padding:8px 16px;" title="Skip the tutorial" data-i18n="BTN_ONBOARDING_SKIP" data-i18n-title="BTN_ONBOARDING_SKIP_TOOLTIP">Skip</button>
-                <button id="onboarding-next" class="primary" style="width:auto; padding:8px 16px;" title="Go to next step" data-i18n="BTN_ONBOARDING_NEXT" data-i18n-title="BTN_ONBOARDING_NEXT_TOOLTIP">Next</button>
+    <div id="onboarding-overlay" style="display:none; position:fixed; inset:0; background:transparent; z-index:1000; pointer-events:auto;">
+        <!-- Spotlight element -->
+        <div id="onboarding-spotlight" style="position:fixed; pointer-events:none; border:2px solid var(--accent); box-shadow:0 0 0 9999px rgba(15, 23, 42, 0.65); border-radius:8px; transition:all 0.3s cubic-bezier(0.4, 0, 0.2, 1); display:none; opacity:0; z-index:1001; animation: spotlightPulse 2s infinite ease-in-out;"></div>
+        
+        <!-- Onboarding Card -->
+        <div id="onboarding-card" style="position:fixed; background:var(--card); padding:16px 20px; border-radius:12px; width:280px; box-shadow:0 8px 32px rgba(0,0,0,0.5); z-index:1002; transition:all 0.3s cubic-bezier(0.4, 0, 0.2, 1); box-sizing:border-box; border:1px solid #334155; opacity:0; transform: scale(0.9); display:none;">
+            <div style="display:flex; justify-content:space-between; align-items:center; margin-bottom:8px;">
+                <span id="onboarding-icon" style="font-size:24px;">👋</span>
+                <span id="onboarding-step-indicator" style="font-size:10px; font-weight:700; color:var(--accent); text-transform:uppercase; letter-spacing:0.5px;">Step 1 of 5</span>
            </div>
-            <div id="onboarding-dots" style="margin-top:12px; display:flex; gap:6px; justify-content:center;"></div>
+            <h2 id="onboarding-title" style="color:var(--accent); margin:0 0 6px; font-size:14px; font-weight:700; text-align:left;">Welcome to KoalaSync!</h2>
+            <p id="onboarding-text" style="color:var(--text-muted); font-size:12px; margin:0 0 16px; line-height:1.4; text-align:left;">Let's get you started.</p>
+            
+            <!-- Progress Bar -->
+            <div id="onboarding-progress-container" style="height:4px; background:#334155; border-radius:2px; margin-bottom:16px; overflow:hidden;">
+                <div id="onboarding-progress-bar" style="height:100%; width:20%; background:var(--accent); transition:width 0.3s ease;"></div>
+            </div>
+            
+            <div style="display:flex; gap:8px; justify-content:space-between; align-items:center;">
+                <button id="onboarding-skip" class="secondary" style="width:auto; padding:6px 12px; margin:0; font-size:11px;" title="Skip the tutorial" data-i18n="BTN_ONBOARDING_SKIP" data-i18n-title="BTN_ONBOARDING_SKIP_TOOLTIP">Skip</button>
+                <button id="onboarding-next" class="primary" style="width:auto; padding:6px 16px; margin:0; font-size:11px;" title="Go to next step" data-i18n="BTN_ONBOARDING_NEXT" data-i18n-title="BTN_ONBOARDING_NEXT_TOOLTIP">Next</button>
+            </div>
+            
+            <!-- Tooltip pointer arrow -->
+            <div id="onboarding-arrow" style="position:absolute; width:0; height:0; border:6px solid transparent; transition:all 0.3s ease;"></div>
        </div>
    </div>
 </body>
@@ -16,6 +16,7 @@ const elements = {
    clearLogs: document.getElementById('clearLogs'),
    connDot: document.getElementById('connDot'),
    connText: document.getElementById('connText'),
+    connPing: document.getElementById('connPing'),
    serverUrl: document.getElementById('serverUrl'),
    serverOfficial: document.getElementById('serverOfficial'),
    serverCustom: document.getElementById('serverCustom'),
@@ -28,6 +29,7 @@ const elements = {
    inviteLink: document.getElementById('inviteLink'),
    filterNoise: document.getElementById('filterNoise'),
    regenId: document.getElementById('regenId'),
+    restartTourBtn: document.getElementById('restartTourBtn'),
    lastActionCard: document.getElementById('lastActionCard'),
    historyList: document.getElementById('historyList'),
    copyLogs: document.getElementById('copyLogs'),
@@ -67,6 +69,7 @@ let lastPeersJson = null;
 let lastKnownPeers = [];
 let isDevTabVisible = false;
 let reconnectSlowMode = false;
+let isProcessingConnection = false;
 let joinBtnTimeout = null;
 let forceSyncResetTimer = null;
 let popupIntervals = [];
@@ -172,7 +175,7 @@ function setRoomRefreshCooldown() {

 // --- Initialization ---
 async function init() {
-    const localData = await chrome.storage.local.get(['serverUrl', 'useCustomServer', 'roomId', 'password', 'username', 'filterNoise', 'autoSyncNextEpisode', 'forceSyncMode', 'browserNotifications', 'autoCopyInvite', 'locale', 'audioSettings']);
+    const localData = await chrome.storage.local.get(['serverUrl', 'useCustomServer', 'roomId', 'password', 'username', 'filterNoise', 'autoSyncNextEpisode', 'forceSyncMode', 'browserNotifications', 'autoCopyInvite', 'locale', 'audioSettings', 'activeTab']);
    // Migrate preferences from sync → local for existing users
    const oldSync = await chrome.storage.sync.get(['serverUrl', 'useCustomServer', 'roomId', 'password', 'username', 'filterNoise', 'autoSyncNextEpisode', 'forceSyncMode', 'browserNotifications', 'autoCopyInvite', 'locale', 'audioSettings']);
    const toMigrate = {};
@@ -234,8 +237,7 @@ async function init() {
    refreshLogs();
    refreshHistory();

-    // Default connection status (localized) before async check
-    applyConnectionStatus('disconnected');
+    // Initial Status Check (status shows via GET_STATUS below)

    // Initial Status Check
    chrome.runtime.sendMessage({ type: 'GET_STATUS' }, async (res) => {
@@ -248,17 +250,38 @@ async function init() {
            localPeerId = res.peerId;
            reconnectSlowMode = res.reconnectSlowMode || false;
            applyConnectionStatus(res.status);
+            updatePingDisplay(res.ping);
            updatePeerList(res.peers);
            lastKnownPeers = res.peers || [];
            if (res.lastActionState) updateLastActionUI(res.lastActionState, res.peers);
+
+            // If user has a room configured but background is not connected,
+            // trigger connection now — the popup opening is explicit user intent.
+            if (res.status === 'disconnected' && localData.roomId) {
+                chrome.runtime.sendMessage({ type: 'CONNECT' }).catch(() => {});
+                applyConnectionStatus('connecting');
+            }
            
            // Populate Tabs using the background's targetTabId
            await populateTabs(res.peers, res.targetTabId);

            // Render lobby status if active
            if (res.episodeLobby) updateLobbyUI(res.episodeLobby, res.peers);
+
+            if (res.status === 'connected' && !res.targetTabId && localData.roomId) {
+                const syncTabBtn = document.querySelector('.tab-btn[data-tab="tab-sync"]');
+                if (syncTabBtn) syncTabBtn.click();
+                showSelectVideoHint();
+            } else if (localData.activeTab) {
+                const btn = document.querySelector(`.tab-btn[data-tab="${localData.activeTab}"]`);
+                if (btn) btn.click();
+            }
        } else {
            await populateTabs();
+            if (localData.activeTab) {
+                const btn = document.querySelector(`.tab-btn[data-tab="${localData.activeTab}"]`);
+                if (btn) btn.click();
+            }
        }
    });

@@ -480,6 +503,24 @@ function renderEmpty(container, type) {
    wrapper.appendChild(iconDiv);
    wrapper.appendChild(titleDiv);
    wrapper.appendChild(hintDiv);
+
+    // "No peers yet" — turn the hint into a one-click action so the user can
+    // immediately copy and share the invite link instead of hunting for it.
+    if (type === 'peers' && elements.inviteLink && elements.inviteLink.value) {
+        const copyBtn = document.createElement('button');
+        copyBtn.type = 'button';
+        copyBtn.className = 'primary';
+        copyBtn.style.cssText = 'display:inline-block; width:auto; margin-top:12px; padding:6px 14px; font-size:11px;';
+        copyBtn.textContent = getMessage('BTN_COPY_INVITE');
+        copyBtn.title = getMessage('BTN_COPY_INVITE_TOOLTIP');
+        copyBtn.addEventListener('click', () => {
+            navigator.clipboard.writeText(elements.inviteLink.value)
+                .then(() => showToast(getMessage('TOAST_INVITE_COPIED'), 'success', 2000))
+                .catch(() => showToast(getMessage('TOAST_COPY_FAILED'), 'error'));
+        });
+        wrapper.appendChild(copyBtn);
+    }
+
    container.replaceChildren(wrapper);
 }

@@ -812,6 +853,9 @@ function applyConnectionStatus(status) {
    if (elements.connText) {
        elements.connText.textContent = connected ? getMessage('STATUS_CONNECTED') : (reconnecting ? getMessage('STATUS_RECONNECTING') : (connecting ? getMessage('STATUS_CONNECTING') : getMessage('STATUS_DISCONNECTED')));
    }
+    if (!connected) {
+        updatePingDisplay(null);
+    }
    if (elements.retryBtn) {
        elements.retryBtn.style.display = reconnecting && reconnectSlowMode ? 'block' : 'none';
    }
@@ -831,6 +875,23 @@ function applyConnectionStatus(status) {
    if (elements.forceSyncBtn) elements.forceSyncBtn.textContent = getMessage('BTN_SYNC');
 }

+function updatePingDisplay(pingMs) {
+    if (!elements.connPing) return;
+    if (pingMs === null || pingMs === undefined || typeof pingMs !== 'number' || !Number.isFinite(pingMs)) {
+        elements.connPing.textContent = '';
+        elements.connPing.style.color = '';
+        return;
+    }
+    elements.connPing.textContent = `${Math.round(pingMs)}ms`;
+    if (pingMs < 50) {
+        elements.connPing.style.color = '#22c55e';
+    } else if (pingMs < 150) {
+        elements.connPing.style.color = '#f59e0b';
+    } else {
+        elements.connPing.style.color = '#ef4444';
+    }
+}
+
 function updateHistory(history) {
    if (!history || !elements.historyList) return;
    elements.historyList.innerHTML = '';
@@ -1099,6 +1160,8 @@ elements.tabs.forEach(btn => {
        isDevTabVisible = btn.dataset.tab === 'tab-dev';
        if (isDevTabVisible) refreshLogs();
        if (btn.dataset.tab === 'tab-sync') refreshHistory();
+        
+        chrome.storage.local.set({ activeTab: btn.dataset.tab });
    });
 });

@@ -1141,8 +1204,13 @@ elements.roomId.addEventListener('input', () => {
 });

 elements.joinBtn.addEventListener('click', async () => {
+    if (isProcessingConnection) return;
+    isProcessingConnection = true;
    clearConnectionErrorTimer();
-    if (elements.joinBtn.disabled) return;
+    if (elements.joinBtn.disabled) {
+        isProcessingConnection = false;
+        return;
+    }
    const roomIdInput = elements.roomId.value.trim();
    const isCreating = !roomIdInput;
    
@@ -1151,10 +1219,23 @@ elements.joinBtn.addEventListener('click', async () => {
    
    if (joinBtnTimeout) clearTimeout(joinBtnTimeout);
    joinBtnTimeout = setTimeout(() => {
-        elements.joinBtn.disabled = false;
-        elements.joinBtn.textContent = getMessage('BTN_JOIN_ROOM');
-        joinBtnTimeout = null;
-        showError(getMessage('ERR_CONN_TIMEOUT'));
+        chrome.runtime.sendMessage({ type: 'GET_STATUS' }, (res) => {
+            if (res && res.status === 'connecting') {
+                joinBtnTimeout = setTimeout(() => {
+                    elements.joinBtn.disabled = false;
+                    elements.joinBtn.textContent = getMessage('BTN_JOIN_ROOM');
+                    joinBtnTimeout = null;
+                    isProcessingConnection = false;
+                    showError(getMessage('ERR_CONN_TIMEOUT'));
+                }, 15000);
+                return;
+            }
+            elements.joinBtn.disabled = false;
+            elements.joinBtn.textContent = getMessage('BTN_JOIN_ROOM');
+            joinBtnTimeout = null;
+            isProcessingConnection = false;
+            if (res && res.status !== 'connected') showError(getMessage('ERR_CONN_TIMEOUT'));
+        });
    }, 15000);
    
    const serverUrl = elements.serverUrl.value.trim();
@@ -1165,6 +1246,8 @@ elements.joinBtn.addEventListener('click', async () => {
        showError(getMessage('ERR_INVALID_SERVER_URL'));
        elements.joinBtn.disabled = false;
        elements.joinBtn.textContent = getMessage('BTN_JOIN_ROOM');
+        if (joinBtnTimeout) { clearTimeout(joinBtnTimeout); joinBtnTimeout = null; }
+        isProcessingConnection = false;
        return;
    }
    if (useCustom && serverUrl) {
@@ -1175,6 +1258,8 @@ elements.joinBtn.addEventListener('click', async () => {
            showError(getMessage('ERR_INVALID_SERVER_URL'));
            elements.joinBtn.disabled = false;
            elements.joinBtn.textContent = getMessage('BTN_JOIN_ROOM');
+            if (joinBtnTimeout) { clearTimeout(joinBtnTimeout); joinBtnTimeout = null; }
+            isProcessingConnection = false;
            return;
        }
    }
@@ -1201,6 +1286,8 @@ elements.joinBtn.addEventListener('click', async () => {
 });

 elements.leaveBtn.addEventListener('click', async () => {
+    if (isProcessingConnection) return;
+    isProcessingConnection = true;
    clearConnectionErrorTimer();
    chrome.runtime.sendMessage({ type: 'LEAVE_ROOM' });
    await chrome.storage.local.set({ roomId: '', password: '' });
@@ -1208,6 +1295,7 @@ elements.leaveBtn.addEventListener('click', async () => {
    elements.password.value = '';
    lastKnownPeers = [];
    updateUI(null, null);
+    isProcessingConnection = false;
 });

 function generateRoomId() {
@@ -1258,6 +1346,9 @@ elements.retryBtn.addEventListener('click', () => {
 });

 elements.targetTab.addEventListener('change', () => {
+    const hint = document.getElementById('targetTabHint');
+    if (hint) hint.style.display = 'none';
+
    const val = elements.targetTab.value;
    const tabId = val ? parseInt(val) : null;
    const tabTitle = elements.targetTab.options[elements.targetTab.selectedIndex]?.dataset.originalTitle || null;
@@ -1267,8 +1358,14 @@ elements.targetTab.addEventListener('change', () => {
 elements.forceSyncBtn.addEventListener('click', async () => {
    if (elements.forceSyncBtn.disabled) return;
    
+    const originalText = elements.forceSyncBtn.textContent;
+    elements.forceSyncBtn.disabled = true;
+
    const status = await new Promise(r => chrome.runtime.sendMessage({ type: 'GET_STATUS' }, r));
-    if (chrome.runtime.lastError || !status || !status.targetTabId) return;
+    if (chrome.runtime.lastError || !status || !status.targetTabId) {
+        elements.forceSyncBtn.disabled = false;
+        return;
+    }

    const mode = elements.forceSyncMode.value;
    let targetTime = null;
@@ -1276,6 +1373,7 @@ elements.forceSyncBtn.addEventListener('click', async () => {
    if (mode === 'jump-to-others') {
        if (!localPeerId) {
            showError(getMessage('ERR_IDENTITY_NOT_LOADED'));
+            elements.forceSyncBtn.disabled = false;
            return;
        }
        const peers = status.peers || [];
@@ -1285,6 +1383,7 @@ elements.forceSyncBtn.addEventListener('click', async () => {

        if (otherTimes.length === 0) {
            showError(getMessage('ERR_NO_PEERS_TIME'));
+            elements.forceSyncBtn.disabled = false;
            return;
        }

@@ -1293,8 +1392,6 @@ elements.forceSyncBtn.addEventListener('click', async () => {
        targetTime = otherTimes.length % 2 !== 0 ? otherTimes[mid] : (otherTimes[mid - 1] + otherTimes[mid]) / 2;
    }

-    const originalText = elements.forceSyncBtn.textContent;
-    elements.forceSyncBtn.disabled = true;
    elements.forceSyncBtn.textContent = mode === 'jump-to-others' ? getMessage('BTN_STATE_SYNCING_GROUP', { time: formatTime(targetTime) }) : getMessage('BTN_STATE_SYNCING');
    forceSyncDone = false;
    const peerCount = (status.peers || []).filter(p => (typeof p === 'object' ? p.peerId : p) !== localPeerId).length;
@@ -1550,6 +1647,9 @@ chrome.runtime.onMessage.addListener((msg) => {
        updatePeerList(msg.peers);
        if (msg.peers) detectPeerChanges(msg.peers);
    } else if (msg.type === 'CONNECTION_STATUS') {
+        if (msg.status === 'connected' || msg.status === 'disconnected') {
+            if (joinBtnTimeout) { clearTimeout(joinBtnTimeout); joinBtnTimeout = null; }
+        }
        if (msg.status === 'connected') {
            clearConnectionErrorTimer();
        }
@@ -1559,8 +1659,10 @@ chrome.runtime.onMessage.addListener((msg) => {
        }
        if (msg.status === 'connected') {
            chrome.runtime.sendMessage({ type: 'GET_STATUS' }, (res) => {
-                if (res && res.peers) updatePeerList(res.peers);
-                if (res && res.lastActionState) updateLastActionUI(res.lastActionState, res.peers);
+                if (!res) return;
+                if (res.peers) updatePeerList(res.peers);
+                if (res.lastActionState) updateLastActionUI(res.lastActionState, res.peers);
+                updatePingDisplay(res.ping);
            });
        }
        if (msg.status === 'disconnected') {
@@ -1579,11 +1681,14 @@ chrome.runtime.onMessage.addListener((msg) => {
                }
            });
        }
+    } else if (msg.type === 'PING_UPDATE') {
+        updatePingDisplay(msg.ping);
    } else if (msg.type === 'HISTORY_UPDATE') {
        updateHistory(msg.history);
    } else if (msg.type === 'ROOM_LIST') {
        updateRoomList(msg.rooms);
    } else if (msg.type === 'JOIN_STATUS') {
+        isProcessingConnection = false;
        if (joinBtnTimeout) {
            clearTimeout(joinBtnTimeout);
            joinBtnTimeout = null;
@@ -1595,9 +1700,15 @@ chrome.runtime.onMessage.addListener((msg) => {
            // Final confirmation of join from background
            chrome.storage.local.get(['roomId', 'password', 'useCustomServer', 'serverUrl'], (data) => {
                updateUI(data.roomId, data.password, data.useCustomServer, data.serverUrl);
+                const syncTabBtn = document.querySelector('.tab-btn[data-tab="tab-sync"]');
+                if (syncTabBtn) syncTabBtn.click();
+                showSelectVideoHint();
            });
        } else {
            // Join failed: reset UI state
+            chrome.storage.local.set({ roomId: '', password: '' });
+            elements.roomId.value = '';
+            elements.password.value = '';
            updateUI(null, null);
        }
    } else if (msg.type === 'LOBBY_UPDATE') {
@@ -1685,6 +1796,7 @@ elements.copyLogs.addEventListener('click', () => {
            : '\uD83D\uDD34';
        lines.push(`- **Status:** ${emoji} ${st}`);
        lines.push(`- **Server:** \`${safe(status.serverUrl, '?')}\``);
+        lines.push(`- **Ping:** ${status.ping != null ? `${status.ping}ms` : '-'}`);
        if (status.roomId) {
            lines.push(`- **Room:** \`${status.roomId}\``);
            const peers = Array.isArray(status.peers) ? status.peers : [];
@@ -2022,36 +2134,188 @@ function updateLobbyUI(lobby, peers) {

 // --- Onboarding Tour ---
 const onboardingSteps = [
-    { icon: '👋', get title() { return getMessage('ONBOARDING_1_TITLE'); }, get text() { return getMessage('ONBOARDING_1_TEXT'); }, targetTab: 'tab-room' },
-    { icon: '🏠', get title() { return getMessage('ONBOARDING_2_TITLE'); }, get text() { return getMessage('ONBOARDING_2_TEXT'); }, targetTab: 'tab-room' },
-    { icon: '🎬', get title() { return getMessage('ONBOARDING_3_TITLE'); }, get text() { return getMessage('ONBOARDING_3_TEXT'); }, targetTab: 'tab-sync' },
-    { icon: '⚙️', get title() { return getMessage('ONBOARDING_4_TITLE'); }, get text() { return getMessage('ONBOARDING_4_TEXT'); }, targetTab: 'tab-settings' },
-    { icon: '🎉', get title() { return getMessage('ONBOARDING_5_TITLE'); }, get text() { return getMessage('ONBOARDING_5_TEXT'); }, targetTab: 'tab-room' }
+    { 
+        icon: '👋', 
+        get title() { return getMessage('ONBOARDING_1_TITLE'); }, 
+        get text() { return getMessage('ONBOARDING_1_TEXT'); },
+        targetTab: 'tab-room',
+        targetSelector: null
+    },
+    { 
+        icon: '🏠', 
+        get title() { return getMessage('ONBOARDING_2_TITLE'); }, 
+        get text() { return getMessage('ONBOARDING_2_TEXT'); }, 
+        targetTab: 'tab-room',
+        targetSelector: '#createRoomBtn'
+    },
+    { 
+        icon: '🎬', 
+        get title() { return getMessage('ONBOARDING_3_TITLE'); }, 
+        get text() { return getMessage('ONBOARDING_3_TEXT'); }, 
+        targetTab: 'tab-sync',
+        targetSelector: '#targetTab'
+    },
+    { 
+        icon: '⚙️', 
+        get title() { return getMessage('ONBOARDING_4_TITLE'); }, 
+        get text() { return getMessage('ONBOARDING_4_TEXT'); },
+        targetTab: 'tab-settings',
+        targetSelector: '#username'
+    },
+    {
+        icon: '🍿',
+        get title() { return getMessage('ONBOARDING_5_TITLE'); },
+        get text() { return getMessage('ONBOARDING_5_TEXT'); },
+        targetTab: 'tab-room',
+        targetSelector: null
+    }
 ];

+function showSelectVideoHint() {
+    const hint = document.getElementById('targetTabHint');
+    if (hint && !elements.targetTab.value) {
+        hint.style.display = 'block';
+    }
+}
+
 let onboardingStep = 0;
+let onboardingTimeout = null;

 function showOnboarding() {
    const overlay = document.getElementById('onboarding-overlay');
    if (!overlay) return;
-    document.body.style.minHeight = '400px';
-    overlay.style.display = 'flex';
+    document.body.style.minHeight = '420px';
+    overlay.style.display = 'block';
+    onboardingStep = 0;
    renderOnboardingStep();
 }

+function positionSpotlightAndCard(targetEl) {
+    const spotlight = document.getElementById('onboarding-spotlight');
+    const card = document.getElementById('onboarding-card');
+    const arrow = document.getElementById('onboarding-arrow');
+    if (!spotlight || !card || !arrow) return;
+
+    spotlight.style.display = 'block';
+    card.style.display = 'block';
+    
+    // Force a reflow
+    card.getBoundingClientRect();
+    spotlight.getBoundingClientRect();
+
+    const targetRect = targetEl.getBoundingClientRect();
+    const pad = 6;
+    const sLeft = targetRect.left - pad;
+    const sTop = targetRect.top - pad;
+    const sWidth = targetRect.width + (pad * 2);
+    const sHeight = targetRect.height + (pad * 2);
+    
+    spotlight.style.left = `${sLeft}px`;
+    spotlight.style.top = `${sTop}px`;
+    spotlight.style.width = `${sWidth}px`;
+    spotlight.style.height = `${sHeight}px`;
+    spotlight.style.opacity = '1';
+
+    const cardWidth = 280;
+    const viewportHeight = window.innerHeight || document.documentElement.clientHeight;
+    
+    let cLeft = targetRect.left + (targetRect.width - cardWidth) / 2;
+    cLeft = Math.max(12, Math.min(320 - cardWidth - 12, cLeft));
+    
+    const cardHeight = card.offsetHeight || 150;
+    let cTop = targetRect.bottom + 14;
+    let arrowDir = 'up';
+    
+    if (cTop + cardHeight > viewportHeight - 12) {
+        cTop = targetRect.top - cardHeight - 14;
+        arrowDir = 'down';
+    }
+    
+    if (cTop < 12) {
+        cTop = targetRect.bottom + 14;
+        arrowDir = 'up';
+    }
+
+    card.style.left = `${cLeft}px`;
+    card.style.top = `${cTop}px`;
+    card.style.opacity = '1';
+    card.style.transform = 'scale(1)';
+
+    arrow.style.left = '';
+    arrow.style.right = '';
+    arrow.style.top = '';
+    arrow.style.bottom = '';
+    arrow.style.borderColor = 'transparent';
+    
+    const targetCenter = targetRect.left + (targetRect.width / 2);
+    const arrowLeft = targetCenter - cLeft - 6;
+    arrow.style.left = `${Math.max(12, Math.min(cardWidth - 24, arrowLeft))}px`;
+    
+    if (arrowDir === 'up') {
+        arrow.style.top = '-12px';
+        arrow.style.borderBottomColor = 'var(--card)';
+    } else {
+        arrow.style.bottom = '-12px';
+        arrow.style.borderTopColor = 'var(--card)';
+    }
+}
+
+function centerCardFallback() {
+    const spotlight = document.getElementById('onboarding-spotlight');
+    const card = document.getElementById('onboarding-card');
+    const arrow = document.getElementById('onboarding-arrow');
+    if (!card) return;
+
+    if (spotlight) {
+        spotlight.style.display = 'none';
+        spotlight.style.opacity = '0';
+    }
+    if (arrow) {
+        arrow.style.borderColor = 'transparent';
+    }
+
+    card.style.display = 'block';
+    
+    const cardWidth = 280;
+    const viewportHeight = window.innerHeight || document.documentElement.clientHeight;
+    
+    const cLeft = (320 - cardWidth) / 2;
+    const cTop = (viewportHeight - (card.offsetHeight || 150)) / 2;
+    
+    card.style.left = `${cLeft}px`;
+    card.style.top = `${cTop}px`;
+    card.style.opacity = '1';
+    card.style.transform = 'scale(1)';
+}
+
 function renderOnboardingStep() {
+    if (onboardingTimeout) clearTimeout(onboardingTimeout);
+    
    const step = onboardingSteps[onboardingStep];
    const icon = document.getElementById('onboarding-icon');
    const title = document.getElementById('onboarding-title');
    const text = document.getElementById('onboarding-text');
    const nextBtn = document.getElementById('onboarding-next');
-    const dots = document.getElementById('onboarding-dots');
-    if (!icon || !title || !text || !nextBtn || !dots) return;
+    const stepIndicator = document.getElementById('onboarding-step-indicator');
+    const progressBar = document.getElementById('onboarding-progress-bar');
+    
+    if (!icon || !title || !text || !nextBtn) return;

    icon.textContent = step.icon;
    title.textContent = step.title;
    text.textContent = step.text;

+    if (stepIndicator) {
+        stepIndicator.textContent = `Step ${onboardingStep + 1} of ${onboardingSteps.length}`;
+    }
+    if (progressBar) {
+        progressBar.style.width = `${((onboardingStep + 1) / onboardingSteps.length) * 100}%`;
+    }
+
+    nextBtn.textContent = onboardingStep === onboardingSteps.length - 1 
+        ? (getMessage('ONBOARDING_DONE') !== 'ONBOARDING_DONE' ? getMessage('ONBOARDING_DONE') : 'Done!') 
+        : getMessage('BTN_ONBOARDING_NEXT');
+
    if (step.targetTab) {
        const tabBtn = document.querySelector(`.tab-btn[data-tab="${step.targetTab}"]`);
        if (tabBtn) tabBtn.click();
@@ -2062,31 +2326,53 @@ function renderOnboardingStep() {
            if (syncActive) syncActive.style.display = 'block';
            if (syncInactive) syncInactive.style.display = 'none';
        } else {
-            // Restore actual lock state when on other tabs so we don't leave it unlocked
            const inRoom = elements.sectionActive && elements.sectionActive.style.display === 'block';
            if (syncActive) syncActive.style.display = inRoom ? 'block' : 'none';
            if (syncInactive) syncInactive.style.display = inRoom ? 'none' : 'block';
        }
    }

-    dots.replaceChildren();
-    onboardingSteps.forEach((_, i) => {
-        const dot = document.createElement('div');
-        dot.style.cssText = `width:8px; height:8px; border-radius:50%; background:${i === onboardingStep ? 'var(--accent)' : '#475569'};`;
-        dots.appendChild(dot);
-    });
+    const spotlight = document.getElementById('onboarding-spotlight');
+    const card = document.getElementById('onboarding-card');
+    if (spotlight) spotlight.style.opacity = '0';
+    if (card) {
+        card.style.opacity = '0';
+        card.style.transform = 'scale(0.95)';
+    }

-    nextBtn.textContent = onboardingStep === onboardingSteps.length - 1 ? (getMessage('ONBOARDING_DONE') !== 'ONBOARDING_DONE' ? getMessage('ONBOARDING_DONE') : 'Done!') : getMessage('BTN_ONBOARDING_NEXT');
+    onboardingTimeout = setTimeout(() => {
+        const targetEl = step.targetSelector ? document.querySelector(step.targetSelector) : null;
+        if (targetEl && targetEl.offsetParent !== null) {
+            positionSpotlightAndCard(targetEl);
+        } else {
+            centerCardFallback();
+        }
+    }, 180);
 }

 function completeOnboarding() {
-    const overlay = document.getElementById('onboarding-overlay');
-    if (overlay) overlay.style.display = 'none';
-    document.body.style.minHeight = '';
-    chrome.storage.sync.set({ onboardingComplete: true });
+    if (onboardingTimeout) clearTimeout(onboardingTimeout);
    
-    const inRoom = elements.sectionActive && elements.sectionActive.style.display === 'block';
-    toggleUIState(inRoom);
+    const overlay = document.getElementById('onboarding-overlay');
+    const spotlight = document.getElementById('onboarding-spotlight');
+    const card = document.getElementById('onboarding-card');
+    
+    if (card) {
+        card.style.opacity = '0';
+        card.style.transform = 'scale(0.9)';
+    }
+    if (spotlight) {
+        spotlight.style.opacity = '0';
+    }
+    
+    setTimeout(() => {
+        if (overlay) overlay.style.display = 'none';
+        document.body.style.minHeight = '';
+        chrome.storage.sync.set({ onboardingComplete: true });
+        
+        const inRoom = elements.sectionActive && elements.sectionActive.style.display === 'block';
+        toggleUIState(inRoom);
+    }, 300);
 }

 document.getElementById('onboarding-next')?.addEventListener('click', () => {
@@ -2103,3 +2389,8 @@ document.getElementById('onboarding-skip')?.addEventListener('click', completeOn
 document.getElementById('onboarding-overlay')?.addEventListener('click', (e) => {
    if (e.target.id === 'onboarding-overlay') completeOnboarding();
 });
+
+elements.restartTourBtn?.addEventListener('click', () => {
+    onboardingStep = 0;
+    showOnboarding();
+});
@@ -1,15 +1,15 @@
 {
  "name": "koalasync",
-  "version": "2.1.3",
+  "version": "2.2.4",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "koalasync",
-      "version": "2.1.3",
+      "version": "2.2.4",
      "devDependencies": {
        "archiver": "^7.0.1",
-        "esbuild": "^0.28.0",
+        "esbuild": "^0.28.1",
        "eslint": "^10.4.0",
        "fs-extra": "^11.2.0",
        "sharp": "^0.34.5",
@@ -28,9 +28,9 @@
      }
    },
    "node_modules/@esbuild/aix-ppc64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.0.tgz",
-      "integrity": "sha512-lhRUCeuOyJQURhTxl4WkpFTjIsbDayJHih5kZC1giwE+MhIzAb7mEsQMqMf18rHLsrb5qI1tafG20mLxEWcWlA==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.28.1.tgz",
+      "integrity": "sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==",
      "cpu": [
        "ppc64"
      ],
@@ -45,9 +45,9 @@
      }
    },
    "node_modules/@esbuild/android-arm": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.0.tgz",
-      "integrity": "sha512-wqh0ByljabXLKHeWXYLqoJ5jKC4XBaw6Hk08OfMrCRd2nP2ZQ5eleDZC41XHyCNgktBGYMbqnrJKq/K/lzPMSQ==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.28.1.tgz",
+      "integrity": "sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==",
      "cpu": [
        "arm"
      ],
@@ -62,9 +62,9 @@
      }
    },
    "node_modules/@esbuild/android-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.0.tgz",
-      "integrity": "sha512-+WzIXQOSaGs33tLEgYPYe/yQHf0WTU0X42Jca3y8NWMbUVhp7rUnw+vAsRC/QiDrdD31IszMrZy+qwPOPjd+rw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.28.1.tgz",
+      "integrity": "sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==",
      "cpu": [
        "arm64"
      ],
@@ -79,9 +79,9 @@
      }
    },
    "node_modules/@esbuild/android-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.0.tgz",
-      "integrity": "sha512-+VJggoaKhk2VNNqVL7f6S189UzShHC/mR9EE8rDdSkdpN0KflSwWY/gWjDrNxxisg8Fp1ZCD9jLMo4m0OUfeUA==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.28.1.tgz",
+      "integrity": "sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==",
      "cpu": [
        "x64"
      ],
@@ -96,9 +96,9 @@
      }
    },
    "node_modules/@esbuild/darwin-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.0.tgz",
-      "integrity": "sha512-0T+A9WZm+bZ84nZBtk1ckYsOvyA3x7e2Acj1KdVfV4/2tdG4fzUp91YHx+GArWLtwqp77pBXVCPn2We7Letr0Q==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.28.1.tgz",
+      "integrity": "sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==",
      "cpu": [
        "arm64"
      ],
@@ -113,9 +113,9 @@
      }
    },
    "node_modules/@esbuild/darwin-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.0.tgz",
-      "integrity": "sha512-fyzLm/DLDl/84OCfp2f/XQ4flmORsjU7VKt8HLjvIXChJoFFOIL6pLJPH4Yhd1n1gGFF9mPwtlN5Wf82DZs+LQ==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.28.1.tgz",
+      "integrity": "sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==",
      "cpu": [
        "x64"
      ],
@@ -130,9 +130,9 @@
      }
    },
    "node_modules/@esbuild/freebsd-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.0.tgz",
-      "integrity": "sha512-l9GeW5UZBT9k9brBYI+0WDffcRxgHQD8ShN2Ur4xWq/NFzUKm3k5lsH4PdaRgb2w7mI9u61nr2gI2mLI27Nh3Q==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==",
      "cpu": [
        "arm64"
      ],
@@ -147,9 +147,9 @@
      }
    },
    "node_modules/@esbuild/freebsd-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.0.tgz",
-      "integrity": "sha512-BXoQai/A0wPO6Es3yFJ7APCiKGc1tdAEOgeTNy3SsB491S3aHn4S4r3e976eUnPdU+NbdtmBuLncYir2tMU9Nw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.28.1.tgz",
+      "integrity": "sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==",
      "cpu": [
        "x64"
      ],
@@ -164,9 +164,9 @@
      }
    },
    "node_modules/@esbuild/linux-arm": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.0.tgz",
-      "integrity": "sha512-CjaaREJagqJp7iTaNQjjidaNbCKYcd4IDkzbwwxtSvjI7NZm79qiHc8HqciMddQ6CKvJT6aBd8lO9kN/ZudLlw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.28.1.tgz",
+      "integrity": "sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==",
      "cpu": [
        "arm"
      ],
@@ -181,9 +181,9 @@
      }
    },
    "node_modules/@esbuild/linux-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.0.tgz",
-      "integrity": "sha512-RVyzfb3FWsGA55n6WY0MEIEPURL1FcbhFE6BffZEMEekfCzCIMtB5yyDcFnVbTnwk+CLAgTujmV/Lgvih56W+A==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.28.1.tgz",
+      "integrity": "sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==",
      "cpu": [
        "arm64"
      ],
@@ -198,9 +198,9 @@
      }
    },
    "node_modules/@esbuild/linux-ia32": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.0.tgz",
-      "integrity": "sha512-KBnSTt1kxl9x70q+ydterVdl+Cn0H18ngRMRCEQfrbqdUuntQQ0LoMZv47uB97NljZFzY6HcfqEZ2SAyIUTQBQ==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.28.1.tgz",
+      "integrity": "sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==",
      "cpu": [
        "ia32"
      ],
@@ -215,9 +215,9 @@
      }
    },
    "node_modules/@esbuild/linux-loong64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.0.tgz",
-      "integrity": "sha512-zpSlUce1mnxzgBADvxKXX5sl8aYQHo2ezvMNI8I0lbblJtp8V4odlm3Yzlj7gPyt3T8ReksE6bK+pT3WD+aJRg==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.28.1.tgz",
+      "integrity": "sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==",
      "cpu": [
        "loong64"
      ],
@@ -232,9 +232,9 @@
      }
    },
    "node_modules/@esbuild/linux-mips64el": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.0.tgz",
-      "integrity": "sha512-2jIfP6mmjkdmeTlsX/9vmdmhBmKADrWqN7zcdtHIeNSCH1SqIoNI63cYsjQR8J+wGa4Y5izRcSHSm8K3QWmk3w==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.28.1.tgz",
+      "integrity": "sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==",
      "cpu": [
        "mips64el"
      ],
@@ -249,9 +249,9 @@
      }
    },
    "node_modules/@esbuild/linux-ppc64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.0.tgz",
-      "integrity": "sha512-bc0FE9wWeC0WBm49IQMPSPILRocGTQt3j5KPCA8os6VprfuJ7KD+5PzESSrJ6GmPIPJK965ZJHTUlSA6GNYEhg==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.28.1.tgz",
+      "integrity": "sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==",
      "cpu": [
        "ppc64"
      ],
@@ -266,9 +266,9 @@
      }
    },
    "node_modules/@esbuild/linux-riscv64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.0.tgz",
-      "integrity": "sha512-SQPZOwoTTT/HXFXQJG/vBX8sOFagGqvZyXcgLA3NhIqcBv1BJU1d46c0rGcrij2B56Z2rNiSLaZOYW5cUk7yLQ==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.28.1.tgz",
+      "integrity": "sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==",
      "cpu": [
        "riscv64"
      ],
@@ -283,9 +283,9 @@
      }
    },
    "node_modules/@esbuild/linux-s390x": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.0.tgz",
-      "integrity": "sha512-SCfR0HN8CEEjnYnySJTd2cw0k9OHB/YFzt5zgJEwa+wL/T/raGWYMBqwDNAC6dqFKmJYZoQBRfHjgwLHGSrn3Q==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.28.1.tgz",
+      "integrity": "sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==",
      "cpu": [
        "s390x"
      ],
@@ -300,9 +300,9 @@
      }
    },
    "node_modules/@esbuild/linux-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.0.tgz",
-      "integrity": "sha512-us0dSb9iFxIi8srnpl931Nvs65it/Jd2a2K3qs7fz2WfGPHqzfzZTfec7oxZJRNPXPnNYZtanmRc4AL/JwVzHQ==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.28.1.tgz",
+      "integrity": "sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==",
      "cpu": [
        "x64"
      ],
@@ -317,9 +317,9 @@
      }
    },
    "node_modules/@esbuild/netbsd-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.0.tgz",
-      "integrity": "sha512-CR/RYotgtCKwtftMwJlUU7xCVNg3lMYZ0RzTmAHSfLCXw3NtZtNpswLEj/Kkf6kEL3Gw+BpOekRX0BYCtklhUw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==",
      "cpu": [
        "arm64"
      ],
@@ -334,9 +334,9 @@
      }
    },
    "node_modules/@esbuild/netbsd-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.0.tgz",
-      "integrity": "sha512-nU1yhmYutL+fQ71Kxnhg8uEOdC0pwEW9entHykTgEbna2pw2dkbFSMeqjjyHZoCmt8SBkOSvV+yNmm94aUrrqw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.28.1.tgz",
+      "integrity": "sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==",
      "cpu": [
        "x64"
      ],
@@ -351,9 +351,9 @@
      }
    },
    "node_modules/@esbuild/openbsd-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.0.tgz",
-      "integrity": "sha512-cXb5vApOsRsxsEl4mcZ1XY3D4DzcoMxR/nnc4IyqYs0rTI8ZKmW6kyyg+11Z8yvgMfAEldKzP7AdP64HnSC/6g==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.28.1.tgz",
+      "integrity": "sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==",
      "cpu": [
        "arm64"
      ],
@@ -368,9 +368,9 @@
      }
    },
    "node_modules/@esbuild/openbsd-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.0.tgz",
-      "integrity": "sha512-8wZM2qqtv9UP3mzy7HiGYNH/zjTA355mpeuA+859TyR+e+Tc08IHYpLJuMsfpDJwoLo1ikIJI8jC3GFjnRClzA==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.28.1.tgz",
+      "integrity": "sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==",
      "cpu": [
        "x64"
      ],
@@ -385,9 +385,9 @@
      }
    },
    "node_modules/@esbuild/openharmony-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.0.tgz",
-      "integrity": "sha512-FLGfyizszcef5C3YtoyQDACyg95+dndv79i2EekILBofh5wpCa1KuBqOWKrEHZg3zrL3t5ouE5jgr94vA+Wb2w==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.28.1.tgz",
+      "integrity": "sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==",
      "cpu": [
        "arm64"
      ],
@@ -402,9 +402,9 @@
      }
    },
    "node_modules/@esbuild/sunos-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.0.tgz",
-      "integrity": "sha512-1ZgjUoEdHZZl/YlV76TSCz9Hqj9h9YmMGAgAPYd+q4SicWNX3G5GCyx9uhQWSLcbvPW8Ni7lj4gDa1T40akdlw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.28.1.tgz",
+      "integrity": "sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==",
      "cpu": [
        "x64"
      ],
@@ -419,9 +419,9 @@
      }
    },
    "node_modules/@esbuild/win32-arm64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.0.tgz",
-      "integrity": "sha512-Q9StnDmQ/enxnpxCCLSg0oo4+34B9TdXpuyPeTedN/6+iXBJ4J+zwfQI28u/Jl40nOYAxGoNi7mFP40RUtkmUA==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.28.1.tgz",
+      "integrity": "sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==",
      "cpu": [
        "arm64"
      ],
@@ -436,9 +436,9 @@
      }
    },
    "node_modules/@esbuild/win32-ia32": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.0.tgz",
-      "integrity": "sha512-zF3ag/gfiCe6U2iczcRzSYJKH1DCI+ByzSENHlM2FcDbEeo5Zd2C86Aq0tKUYAJJ1obRP84ymxIAksZUcdztHA==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.28.1.tgz",
+      "integrity": "sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==",
      "cpu": [
        "ia32"
      ],
@@ -453,9 +453,9 @@
      }
    },
    "node_modules/@esbuild/win32-x64": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.0.tgz",
-      "integrity": "sha512-pEl1bO9mfAmIC+tW5btTmrKaujg3zGtUmWNdCw/xs70FBjwAL3o9OEKNHvNmnyylD6ubxUERiEhdsL0xBQ9efw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.28.1.tgz",
+      "integrity": "sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==",
      "cpu": [
        "x64"
      ],
@@ -1835,9 +1835,9 @@
      }
    },
    "node_modules/esbuild": {
-      "version": "0.28.0",
-      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.0.tgz",
-      "integrity": "sha512-sNR9MHpXSUV/XB4zmsFKN+QgVG82Cc7+/aaxJ8Adi8hyOac+EXptIp45QBPaVyX3N70664wRbTcLTOemCAnyqw==",
+      "version": "0.28.1",
+      "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.28.1.tgz",
+      "integrity": "sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==",
      "dev": true,
      "hasInstallScript": true,
      "license": "MIT",
@@ -1848,32 +1848,32 @@
        "node": ">=18"
      },
      "optionalDependencies": {
-        "@esbuild/aix-ppc64": "0.28.0",
-        "@esbuild/android-arm": "0.28.0",
-        "@esbuild/android-arm64": "0.28.0",
-        "@esbuild/android-x64": "0.28.0",
-        "@esbuild/darwin-arm64": "0.28.0",
-        "@esbuild/darwin-x64": "0.28.0",
-        "@esbuild/freebsd-arm64": "0.28.0",
-        "@esbuild/freebsd-x64": "0.28.0",
-        "@esbuild/linux-arm": "0.28.0",
-        "@esbuild/linux-arm64": "0.28.0",
-        "@esbuild/linux-ia32": "0.28.0",
-        "@esbuild/linux-loong64": "0.28.0",
-        "@esbuild/linux-mips64el": "0.28.0",
-        "@esbuild/linux-ppc64": "0.28.0",
-        "@esbuild/linux-riscv64": "0.28.0",
-        "@esbuild/linux-s390x": "0.28.0",
-        "@esbuild/linux-x64": "0.28.0",
-        "@esbuild/netbsd-arm64": "0.28.0",
-        "@esbuild/netbsd-x64": "0.28.0",
-        "@esbuild/openbsd-arm64": "0.28.0",
-        "@esbuild/openbsd-x64": "0.28.0",
-        "@esbuild/openharmony-arm64": "0.28.0",
-        "@esbuild/sunos-x64": "0.28.0",
-        "@esbuild/win32-arm64": "0.28.0",
-        "@esbuild/win32-ia32": "0.28.0",
-        "@esbuild/win32-x64": "0.28.0"
+        "@esbuild/aix-ppc64": "0.28.1",
+        "@esbuild/android-arm": "0.28.1",
+        "@esbuild/android-arm64": "0.28.1",
+        "@esbuild/android-x64": "0.28.1",
+        "@esbuild/darwin-arm64": "0.28.1",
+        "@esbuild/darwin-x64": "0.28.1",
+        "@esbuild/freebsd-arm64": "0.28.1",
+        "@esbuild/freebsd-x64": "0.28.1",
+        "@esbuild/linux-arm": "0.28.1",
+        "@esbuild/linux-arm64": "0.28.1",
+        "@esbuild/linux-ia32": "0.28.1",
+        "@esbuild/linux-loong64": "0.28.1",
+        "@esbuild/linux-mips64el": "0.28.1",
+        "@esbuild/linux-ppc64": "0.28.1",
+        "@esbuild/linux-riscv64": "0.28.1",
+        "@esbuild/linux-s390x": "0.28.1",
+        "@esbuild/linux-x64": "0.28.1",
+        "@esbuild/netbsd-arm64": "0.28.1",
+        "@esbuild/netbsd-x64": "0.28.1",
+        "@esbuild/openbsd-arm64": "0.28.1",
+        "@esbuild/openbsd-x64": "0.28.1",
+        "@esbuild/openharmony-arm64": "0.28.1",
+        "@esbuild/sunos-x64": "0.28.1",
+        "@esbuild/win32-arm64": "0.28.1",
+        "@esbuild/win32-ia32": "0.28.1",
+        "@esbuild/win32-x64": "0.28.1"
      }
    },
    "node_modules/escape-string-regexp": {
@@ -1,17 +1,18 @@
 {
  "name": "koalasync",
-  "version": "2.2.0",
+  "version": "2.4.1",
  "description": "KoalaSync Build Scripts",
  "private": true,
+  "type": "module",
  "scripts": {
-    "build:extension": "node scripts/build-extension.js",
+    "build:extension": "node scripts/build-extension.cjs",
    "lint": "eslint .",
    "lint:fix": "eslint . --fix",
    "verify": "node scripts/verify-release.mjs"
  },
  "devDependencies": {
    "archiver": "^7.0.1",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.1",
    "eslint": "^10.4.0",
    "fs-extra": "^11.2.0",
    "sharp": "^0.34.5",
@@ -2,7 +2,7 @@

 This directory contains utility scripts for the KoalaSync development workflow.

-## build-extension.js
+## build-extension.cjs

 The primary build tool for KoalaSync. This Node.js script automates two critical tasks:

@@ -15,7 +15,7 @@ The primary build tool for KoalaSync. This Node.js script automates two critical
 From the **repository root**, run:

 ```bash
-node scripts/build-extension.js
+node scripts/build-extension.cjs
 ```

 ### Why this script exists
@@ -38,7 +38,7 @@ const baseManifest = JSON.parse(fs.readFileSync(baseManifestPath, 'utf8'));

 // Helper to copy files, ignoring manifest.json and manifest.base.json
 // Also injects shared constants into content.js
-function copyExtensionFiles(targetDir) {
+function copyExtensionFiles(targetDir, browserName) {
  fs.mkdirSync(targetDir, { recursive: true });
  
  // Read master constants for injection
@@ -77,7 +77,7 @@ function copyExtensionFiles(targetDir) {
        const eStart = '// --- SHARED_EVENTS_INJECT_START ---';
        const eEnd = '// --- SHARED_EVENTS_INJECT_END ---';
        const ePattern = new RegExp(`${eStart}[\\s\\S]+?${eEnd}`);
-        const eRep = `${eStart}\n    // This block is automatically updated by /scripts/build-extension.js\n    const EVENTS = ${eventsObject};\n    ${eEnd}`;
+        const eRep = `${eStart}\n    // This block is automatically updated by /scripts/build-extension.cjs\n    const EVENTS = ${eventsObject};\n    ${eEnd}`;
        
        if (ePattern.test(content)) {
          content = content.replace(ePattern, eRep);
@@ -97,8 +97,49 @@ function copyExtensionFiles(targetDir) {
          console.warn('⚠️ WARNING: Heartbeat markers not found in content.js');
        }

+        // 3. Inject Episode Utils
+        const euStart = '// --- SHARED_EPISODE_UTILS_INJECT_START ---';
+        const euEnd = '// --- SHARED_EPISODE_UTILS_INJECT_END ---';
+        const euPattern = new RegExp(euStart.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') + '[\\s\\S]+?' + euEnd.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+        const euPath = path.join(rootDir, 'extension', 'episode-utils.js');
+        if (fs.existsSync(euPath)) {
+          const euContent = fs.readFileSync(euPath, 'utf8');
+          const stripped = euContent
+            .replace(/^\/\*\*[\s\S]*?\*\/\s*/m, '')
+            .replace(/export function /g, 'function ')
+            .trim();
+          const euRep = `${euStart}\n    // This block is automatically updated by /scripts/build-extension.cjs\n${stripped.split('\n').map(l => '    ' + l).join('\n')}\n    ${euEnd}`;
+          if (euPattern.test(content)) {
+            content = content.replace(euPattern, euRep);
+          } else {
+            console.warn('⚠ WARNING: Episode utils markers not found in content.js');
+          }
+        }
+
        fs.writeFileSync(destPath, content);
        console.log('✓ Injected shared constants into content.js');
+      } else if (item === 'background.js') {
+        let content = fs.readFileSync(srcPath, 'utf8');
+        
+        // 3. Inject Uninstall URL Constants
+        const uStart = '// --- UNINSTALL_URL_INJECT_START ---';
+        const uEnd = '// --- UNINSTALL_URL_INJECT_END ---';
+        const uPattern = new RegExp(`${uStart}[\\s\\S]+?${uEnd}`);
+        const placeholderUrl = "https://bye.koalastuff.net/c/camp_99ztjRVbK1BNN2RU";
+        
+        let uRep = `${uStart}\n        // This block is automatically updated by /scripts/build-extension.cjs\n`;
+        uRep += `        const UNINSTALL_URL = "${placeholderUrl}";\n`;
+        uRep += `        const BROWSER_TYPE = "${browserName}";\n`;
+        uRep += `        ${uEnd}`;
+        
+        if (uPattern.test(content)) {
+          content = content.replace(uPattern, uRep);
+        } else {
+          console.warn('⚠️ WARNING: Uninstall URL markers not found in background.js');
+        }
+
+        fs.writeFileSync(destPath, content);
+        console.log(`✓ Injected uninstall URL constants for ${browserName} into background.js`);
      } else {
        fs.copyFileSync(srcPath, destPath);
      }
@@ -127,7 +168,7 @@ async function buildBrowser(browserName, manifestModifier) {
  const browserDistDir = path.join(distDir, browserName);
  
  // 1. Copy files
-  copyExtensionFiles(browserDistDir);
+  copyExtensionFiles(browserDistDir, browserName);
  
  // 2. Modify and write manifest
  const browserManifest = manifestModifier(JSON.parse(JSON.stringify(baseManifest)));
@@ -0,0 +1,76 @@
+import assert from 'node:assert/strict';
+import { extractEpisodeId, sameEpisode } from '../extension/episode-utils.js';
+
+// --- extractEpisodeId ---
+
+// Standard SxxExx patterns
+assert.equal(extractEpisodeId('S01E01'), 'S01E01');
+assert.equal(extractEpisodeId('S1E1'), 'S01E01');
+assert.equal(extractEpisodeId('s01e01'), 'S01E01', 'case insensitive');
+assert.equal(extractEpisodeId('Season 1 Episode 2'), 'S01E02');
+assert.equal(extractEpisodeId('season 01 episode 02'), 'S01E02');
+
+// Separators: dash, dot, slash, colon, space, comma
+assert.equal(extractEpisodeId('S01 - E01'), 'S01E01', 'dash separator');
+assert.equal(extractEpisodeId('S01.E01'), 'S01E01', 'dot separator');
+assert.equal(extractEpisodeId('S01/E01'), 'S01E01', 'slash separator (Crunchyroll)');
+assert.equal(extractEpisodeId('S01:E01'), 'S01E01', 'colon separator');
+assert.equal(extractEpisodeId('S01,E01'), 'S01E01', 'comma separator');
+assert.equal(extractEpisodeId('S01 E01'), 'S01E01', 'space separator');
+
+// German / multi-language
+assert.equal(extractEpisodeId('Folge 5'), 'EP005');
+assert.equal(extractEpisodeId('Episode 12'), 'EP012');
+assert.equal(extractEpisodeId('Ep. 3'), 'EP003');
+assert.equal(extractEpisodeId('#42'), 'EP042');
+
+// Edge cases
+assert.equal(extractEpisodeId(null), null);
+assert.equal(extractEpisodeId(undefined), null);
+assert.equal(extractEpisodeId(''), null);
+assert.equal(extractEpisodeId(123), null);
+assert.equal(extractEpisodeId('Some Movie Title'), null);
+assert.equal(extractEpisodeId('Breaking Bad'), null);
+
+// Leading zeros preserved
+assert.equal(extractEpisodeId('S01E001'), 'S01E001');
+
+// --- sameEpisode ---
+
+// Identical episodes
+assert.equal(sameEpisode('S01E01', 'S01E01'), true);
+assert.equal(sameEpisode('S01E01 - Pilot', 'S01E01'), true, 'extra text ignored');
+assert.equal(sameEpisode('Folge 5', 'Episode 5'), true, 'German vs English');
+
+// Different episodes
+assert.equal(sameEpisode('S01E01', 'S01E02'), false);
+assert.equal(sameEpisode('Folge 1', 'Folge 2'), false);
+assert.equal(sameEpisode('S01E01', 'S02E01'), false);
+
+// Both unknown → assume same (backward compat)
+assert.equal(sameEpisode(null, null), true);
+assert.equal(sameEpisode(undefined, undefined), true);
+assert.equal(sameEpisode('', ''), true);
+assert.equal(sameEpisode('Some Movie', 'Some Movie'), true);
+assert.equal(sameEpisode('Some Movie', 'Other Movie'), false, 'different unknowns differ');
+
+// One unknown, one known → different
+assert.equal(sameEpisode('S01E01', null), false);
+assert.equal(sameEpisode(null, 'Episode 5'), false);
+assert.equal(sameEpisode(undefined, 'S01E01'), false);
+
+// Mixed formats — only match when the same episode
+assert.equal(sameEpisode('S01E05', 'S01E05'), true, 'same SxxExx');
+assert.equal(sameEpisode('Folge 5', 'Episode 5'), true, 'German Folge vs English Episode');
+assert.equal(sameEpisode('Episode 12', 'Ep. 12'), true, 'Episode X vs Ep. X');
+assert.equal(sameEpisode('#42', 'Folge 42'), true, '#X vs Folge X');
+
+// Different format IDs → different (season-tagged vs seasonless)
+assert.equal(sameEpisode('S01E05', 'Episode 5'), false, 'SxxExx vs Episode X: different IDs');
+assert.equal(sameEpisode('S01E01', 'EP001'), false, 'SxxExx vs EPxxx: different IDs');
+
+// parseable but truly different
+assert.equal(sameEpisode('S01E01', 'S01E02'), false, 'different episodes');
+assert.equal(sameEpisode('S01E01', 'S02E01'), false, 'different seasons');
+
+console.log('episode-utils tests passed');
@@ -0,0 +1,244 @@
+const fs = require('fs');
+const path = require('path');
+
+const localesDir = path.join(__dirname, '..', 'extension', 'locales');
+const enPath = path.join(localesDir, 'en.json');
+
+if (!fs.existsSync(enPath)) {
+  console.error('CRITICAL: en.json is missing!');
+  process.exit(1);
+}
+
+let hasError = false;
+
+// Verify SUPPORTED_LANGUAGES in extension/i18n.js matches JSON files
+const i18nPath = path.join(__dirname, '..', 'extension', 'i18n.js');
+try {
+  if (fs.existsSync(i18nPath)) {
+    const i18nContent = fs.readFileSync(i18nPath, 'utf8');
+    const langMatch = i18nContent.match(/export const SUPPORTED_LANGUAGES = \[(.*?)\];/);
+    if (!langMatch) {
+      hasError = true;
+      console.error('❌ Could not parse SUPPORTED_LANGUAGES from extension/i18n.js');
+    } else {
+      const supportedLangs = langMatch[1].split(',').map(s => s.trim().replace(/['"]/g, ''));
+      const fileLangs = fs.readdirSync(localesDir)
+        .filter(file => file.endsWith('.json'))
+        .map(file => file.replace('.json', ''));
+
+      for (const lang of fileLangs) {
+        if (!supportedLangs.includes(lang)) {
+          hasError = true;
+          console.error(`❌ ${lang}.json exists in extension/locales but is missing from SUPPORTED_LANGUAGES in extension/i18n.js`);
+        }
+      }
+      for (const lang of supportedLangs) {
+        if (!fileLangs.includes(lang)) {
+          hasError = true;
+          console.error(`❌ ${lang} is in SUPPORTED_LANGUAGES in extension/i18n.js but ${lang}.json is missing from extension/locales`);
+        }
+      }
+    }
+  }
+} catch (err) {
+  hasError = true;
+  console.error('❌ Failed to verify SUPPORTED_LANGUAGES synchronization:', err.message);
+}
+
+const enDict = JSON.parse(fs.readFileSync(enPath, 'utf8'));
+const enKeys = Object.keys(enDict);
+
+const localeFiles = fs.readdirSync(localesDir).filter(file => file.endsWith('.json'));
+
+console.log(`Auditing i18n locales using ${enKeys.length} baseline keys from en.json...\n`);
+
+for (const file of localeFiles) {
+  const filePath = path.join(localesDir, file);
+  try {
+    const raw = fs.readFileSync(filePath, 'utf8');
+
+    // Check for duplicate keys in raw JSON before parsing
+    const keyRe = /"(\w+)"\s*:/g;
+    const seenKeys = {};
+    let dupes = [];
+    let m;
+    while ((m = keyRe.exec(raw)) !== null) {
+      if (seenKeys[m[1]]) {
+        dupes.push(m[1]);
+      }
+      seenKeys[m[1]] = true;
+    }
+    if (dupes.length > 0) {
+      hasError = true;
+      console.error(`❌ ${file} has duplicate keys: ${[...new Set(dupes)].join(', ')}`);
+      continue;
+    }
+
+    const dict = JSON.parse(raw);
+    const keys = Object.keys(dict);
+
+    const missingKeys = enKeys.filter(k => !keys.includes(k));
+    const extraKeys = keys.filter(k => !enKeys.includes(k));
+    const emptyKeys = keys.filter(k => typeof dict[k] === 'string' && dict[k].trim() === '');
+    const placeholderKeys = keys.filter(k => {
+      if (typeof dict[k] !== 'string') return false;
+      const val = dict[k];
+      const lower = val.toLowerCase();
+      return (
+        lower.includes('placeholder') ||
+        lower.includes('todo:') ||
+        lower.includes('tbd:') ||
+        /\bTODO\b/.test(val) ||
+        /\bTBD\b/.test(val)
+      );
+    });
+
+    if (missingKeys.length > 0 || extraKeys.length > 0 || emptyKeys.length > 0 || placeholderKeys.length > 0) {
+      hasError = true;
+      console.error(`❌ ${file} has inconsistencies:`);
+      if (missingKeys.length > 0) {
+        console.error(`  Missing keys (${missingKeys.length}):`, missingKeys);
+      }
+      if (extraKeys.length > 0) {
+        console.error(`  Extra keys (${extraKeys.length}):`, extraKeys);
+      }
+      if (emptyKeys.length > 0) {
+        console.error(`  Empty translation values (${emptyKeys.length}):`, emptyKeys);
+      }
+      if (placeholderKeys.length > 0) {
+        console.error(`  Placeholder/TODO values (${placeholderKeys.length}):`, placeholderKeys);
+      }
+    } else {
+      console.log(`✓ ${file} is fully consistent (matches all keys).`);
+    }
+  } catch (err) {
+    hasError = true;
+    console.error(`❌ Failed to parse ${file}:`, err.message);
+  }
+}
+
+// ──────────────────────────────────────
+// Verify Chrome _locales/*/messages.json
+// ──────────────────────────────────────
+console.log('\nVerifying Chrome _locales/messages.json structure...\n');
+
+const chromeLocalesDir = path.join(__dirname, '..', 'extension', '_locales');
+
+// Map custom locale codes to Chrome's underscore format
+const chromeLocaleMap = {
+  'en': 'en', 'de': 'de', 'fr': 'fr', 'es': 'es', 'it': 'it',
+  'ja': 'ja', 'ko': 'ko', 'nl': 'nl', 'pl': 'pl',
+  'pt-BR': 'pt_BR', 'pt': 'pt_PT', 'ru': 'ru', 'tr': 'tr'
+};
+
+// Read SUPPORTED_LANGUAGES from i18n.js
+const i18nContent = fs.readFileSync(i18nPath, 'utf8');
+const langMatch = i18nContent.match(/export const SUPPORTED_LANGUAGES = \[(.*?)\];/);
+const supportedLangs = langMatch
+  ? langMatch[1].split(',').map(s => s.trim().replace(/['"]/g, ''))
+  : [];
+
+// Verify default_locale in manifest.base.json
+const manifestPath = path.join(__dirname, '..', 'extension', 'manifest.base.json');
+try {
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  if (!manifest.default_locale) {
+    hasError = true;
+    console.error('❌ manifest.base.json is missing "default_locale"');
+  } else if (manifest.default_locale !== 'en') {
+    hasError = true;
+    console.error(`❌ manifest.base.json default_locale is "${manifest.default_locale}", expected "en"`);
+  } else {
+    console.log('✓ manifest.base.json has default_locale: "en"');
+  }
+} catch (err) {
+  hasError = true;
+  console.error('❌ Failed to read manifest.base.json:', err.message);
+}
+
+// Verify _locales structure for each supported language
+const expectedKeys = ['appName', 'appDesc'];
+for (const lang of supportedLangs) {
+  const chromeLocale = chromeLocaleMap[lang];
+  if (!chromeLocale) {
+    hasError = true;
+    console.error(`❌ No Chrome locale mapping for "${lang}" in chromeLocaleMap`);
+    continue;
+  }
+
+  const msgPath = path.join(chromeLocalesDir, chromeLocale, 'messages.json');
+
+  if (!fs.existsSync(msgPath)) {
+    hasError = true;
+    console.error(`❌ Missing _locales/${chromeLocale}/messages.json for language "${lang}"`);
+    continue;
+  }
+
+  try {
+    const raw = fs.readFileSync(msgPath, 'utf8');
+    const messages = JSON.parse(raw);
+    const keys = Object.keys(messages);
+
+    // Detect duplicate top-level keys via regex (JSON.parse silently keeps last value)
+    const topKeyRe = /^\s{2}"(\w+)"\s*:/gm;
+    const topSeen = {};
+    let topDupes = [];
+    let tm;
+    while ((tm = topKeyRe.exec(raw)) !== null) {
+      if (topSeen[tm[1]]) topDupes.push(tm[1]);
+      topSeen[tm[1]] = true;
+    }
+    if (topDupes.length > 0) {
+      hasError = true;
+      console.error(`❌ _locales/${chromeLocale}/messages.json has duplicate keys: ${[...new Set(topDupes)].join(', ')}`);
+      continue;
+    }
+
+    // Validate each entry has a "message" field
+    for (const key of keys) {
+      if (!messages[key].message || typeof messages[key].message !== 'string') {
+        hasError = true;
+        console.error(`❌ _locales/${chromeLocale}/messages.json: "${key}" is missing a valid "message" field`);
+      }
+    }
+
+    // Check for missing or extra keys vs expected baseline
+    const missing = expectedKeys.filter(k => !keys.includes(k));
+    const extra = keys.filter(k => !expectedKeys.includes(k));
+    if (missing.length > 0) {
+      hasError = true;
+      console.error(`❌ _locales/${chromeLocale}/messages.json missing keys: ${missing.join(', ')}`);
+    }
+    if (extra.length > 0) {
+      console.log(`ℹ️  _locales/${chromeLocale}/messages.json has extra keys (ok): ${extra.join(', ')}`);
+    }
+    if (missing.length === 0) {
+      console.log(`✓ _locales/${chromeLocale}/messages.json is valid and complete`);
+    }
+  } catch (err) {
+    hasError = true;
+    console.error(`❌ Failed to parse _locales/${chromeLocale}/messages.json:`, err.message);
+  }
+}
+
+// Detect orphan _locales directories (no matching supported language)
+if (fs.existsSync(chromeLocalesDir)) {
+  const chromeCodes = supportedLangs.map(l => chromeLocaleMap[l]).filter(Boolean);
+  const dirs = fs.readdirSync(chromeLocalesDir);
+  for (const dir of dirs) {
+    const dirPath = path.join(chromeLocalesDir, dir);
+    if (fs.statSync(dirPath).isDirectory() && dir !== '.git' && !chromeCodes.includes(dir)) {
+      hasError = true;
+      console.error(`❌ Orphan _locales/${dir}/ directory exists but no matching language in SUPPORTED_LANGUAGES`);
+    }
+  }
+}
+
+console.log('');
+if (hasError) {
+  console.error('❌ Locale consistency check failed! Please fix the errors listed above.');
+  process.exit(1);
+} else {
+  console.log('🎉 All locale files (locales/ and _locales/) are valid and consistent!');
+  process.exit(0);
+}
@@ -1,108 +0,0 @@
-const fs = require('fs');
-const path = require('path');
-
-const localesDir = path.join(__dirname, '..', 'extension', 'locales');
-const enPath = path.join(localesDir, 'en.json');
-
-if (!fs.existsSync(enPath)) {
-  console.error('CRITICAL: en.json is missing!');
-  process.exit(1);
-}
-
-let hasError = false;
-
-// Verify SUPPORTED_LANGUAGES in extension/i18n.js matches JSON files
-const i18nPath = path.join(__dirname, '..', 'extension', 'i18n.js');
-try {
-  if (fs.existsSync(i18nPath)) {
-    const i18nContent = fs.readFileSync(i18nPath, 'utf8');
-    const langMatch = i18nContent.match(/export const SUPPORTED_LANGUAGES = \[(.*?)\];/);
-    if (!langMatch) {
-      hasError = true;
-      console.error('❌ Could not parse SUPPORTED_LANGUAGES from extension/i18n.js');
-    } else {
-      const supportedLangs = langMatch[1].split(',').map(s => s.trim().replace(/['"]/g, ''));
-      const fileLangs = fs.readdirSync(localesDir)
-        .filter(file => file.endsWith('.json'))
-        .map(file => file.replace('.json', ''));
-
-      for (const lang of fileLangs) {
-        if (!supportedLangs.includes(lang)) {
-          hasError = true;
-          console.error(`❌ ${lang}.json exists in extension/locales but is missing from SUPPORTED_LANGUAGES in extension/i18n.js`);
-        }
-      }
-      for (const lang of supportedLangs) {
-        if (!fileLangs.includes(lang)) {
-          hasError = true;
-          console.error(`❌ ${lang} is in SUPPORTED_LANGUAGES in extension/i18n.js but ${lang}.json is missing from extension/locales`);
-        }
-      }
-    }
-  }
-} catch (err) {
-  hasError = true;
-  console.error('❌ Failed to verify SUPPORTED_LANGUAGES synchronization:', err.message);
-}
-
-const enDict = JSON.parse(fs.readFileSync(enPath, 'utf8'));
-const enKeys = Object.keys(enDict);
-
-const localeFiles = fs.readdirSync(localesDir).filter(file => file.endsWith('.json') && file !== 'en.json');
-
-console.log(`Auditing i18n locales using ${enKeys.length} baseline keys from en.json...\n`);
-
-for (const file of localeFiles) {
-  const filePath = path.join(localesDir, file);
-  try {
-    const raw = fs.readFileSync(filePath, 'utf8');
-
-    // Check for duplicate keys in raw JSON before parsing
-    const keyRe = /"(\w+)"\s*:/g;
-    const seenKeys = {};
-    let dupes = [];
-    let m;
-    while ((m = keyRe.exec(raw)) !== null) {
-      if (seenKeys[m[1]]) {
-        dupes.push(m[1]);
-      }
-      seenKeys[m[1]] = true;
-    }
-    if (dupes.length > 0) {
-      hasError = true;
-      console.error(`❌ ${file} has duplicate keys: ${[...new Set(dupes)].join(', ')}`);
-      continue;
-    }
-
-    const dict = JSON.parse(raw);
-    const keys = Object.keys(dict);
-
-    const missingKeys = enKeys.filter(k => !keys.includes(k));
-    const extraKeys = keys.filter(k => !enKeys.includes(k));
-
-    if (missingKeys.length > 0 || extraKeys.length > 0) {
-      hasError = true;
-      console.error(`❌ ${file} has inconsistencies:`);
-      if (missingKeys.length > 0) {
-        console.error(`  Missing keys (${missingKeys.length}):`, missingKeys);
-      }
-      if (extraKeys.length > 0) {
-        console.error(`  Extra keys (${extraKeys.length}):`, extraKeys);
-      }
-    } else {
-      console.log(`✓ ${file} is fully consistent (matches all keys).`);
-    }
-  } catch (err) {
-    hasError = true;
-    console.error(`❌ Failed to parse ${file}:`, err.message);
-  }
-}
-
-console.log('');
-if (hasError) {
-  console.error('❌ Locale consistency check failed! Please fix the errors listed above.');
-  process.exit(1);
-} else {
-  console.log('🎉 All locale files are perfectly synchronized and consistent!');
-  process.exit(0);
-}
@@ -0,0 +1,56 @@
+import assert from 'node:assert/strict';
+import { getAvatarForName, generateUsername, USERNAME_ADJECTIVES, USERNAME_NOUNS } from '../shared/names.js';
+
+// --- getAvatarForName (deterministic) ---
+
+// Exact matches
+assert.equal(getAvatarForName('Koala'), '🐨', 'Koala');
+assert.equal(getAvatarForName('Tiger'), '🐯', 'Tiger');
+assert.equal(getAvatarForName('Panda'), '🐼', 'Panda');
+assert.equal(getAvatarForName('Fox'), '🦊', 'Fox');
+
+// Case insensitive
+assert.equal(getAvatarForName('koala'), '🐨', 'lowercase');
+assert.equal(getAvatarForName('MyKoalaUser'), '🐨', 'embedded uppercase');
+
+// Longest match wins (caterpillar > cat)
+assert.equal(getAvatarForName('CaterpillarCat'), '🐛', 'caterpillar before cat');
+assert.equal(getAvatarForName('Cat'), '🐱', 'cat alone');
+
+// Emoji with ZWJ sequences (multi-codepoint)
+assert.equal(getAvatarForName('Polar'), '🐻\u200D❄️', 'polar bear ZWJ');
+assert.equal(getAvatarForName('Crow'), '🐦\u200D⬛', 'crow ZWJ');
+
+// Human-like characters
+assert.equal(getAvatarForName('Ninja'), '🥷', 'ninja');
+assert.equal(getAvatarForName('Wizard'), '🧙', 'wizard');
+assert.equal(getAvatarForName('Pirate'), '🏴', 'pirate');
+assert.equal(getAvatarForName('Alien'), '👾', 'alien');
+assert.equal(getAvatarForName('Robot'), '🤖', 'robot');
+
+// Fallback
+assert.equal(getAvatarForName(''), '👤', 'empty string');
+assert.equal(getAvatarForName('Xyzzy123'), '👤', 'unknown name');
+assert.equal(getAvatarForName(null), '👤', 'null');
+assert.equal(getAvatarForName(undefined), '👤', 'undefined');
+
+// --- generateUsername (format check) ---
+for (let i = 0; i < 10; i++) {
+    const name = generateUsername();
+    // Format: AdjectiveNoun (e.g. "HappyKoala")
+    assert.ok(/^[A-Z][a-z]+[A-Z][a-z]+$/.test(name), `format: ${name}`);
+    // Adjective from list
+    const adj = USERNAME_ADJECTIVES.some(a => name.startsWith(a));
+    assert.ok(adj, `adjective from list: ${name}`);
+    // Noun from list
+    const noun = USERNAME_NOUNS.some(n => name.endsWith(n));
+    assert.ok(noun, `noun from list: ${name}`);
+}
+
+// Every noun has an emoji (no broken usernames)
+for (const noun of USERNAME_NOUNS) {
+    const avatar = getAvatarForName(noun);
+    assert.notEqual(avatar, '👤', `noun "${noun}" has no emoji — add to ANIMAL_EMOJI_MAP`);
+}
+
+console.log('names tests passed');
@@ -0,0 +1,110 @@
+import assert from 'node:assert/strict';
+import {
+    checkConnectionRate,
+    checkEventRate,
+    checkHealthRate,
+    checkAdminMetricsAuthRate,
+    checkAuthRate,
+    recordAuthFailure,
+    clearRateLimitMaps,
+    connectionCounts,
+    failedAuthAttempts,
+    eventCounts,
+    healthCounts,
+    adminMetricsAuthCounts,
+    roomListCooldowns,
+    rateLimitDenied,
+    startRateLimitCleanup,
+    stopRateLimitCleanup
+} from '../server/rate-limiter.js';
+
+// Helper: mock io for cleanup
+const mockIo = { sockets: { sockets: new Map() } };
+
+// Reset state before each test group
+function reset() {
+    clearRateLimitMaps();
+    Object.assign(rateLimitDenied, { connections: 0, events: 0, health: 0, adminMetricsAuth: 0, roomList: 0 });
+    stopRateLimitCleanup();
+}
+
+// --- checkConnectionRate ---
+reset();
+assert.equal(checkConnectionRate('1.1.1.1'), true, 'first connection allowed');
+for (let i = 0; i < 9; i++) checkConnectionRate('1.1.1.1');
+assert.equal(checkConnectionRate('1.1.1.1'), false, '11th connection blocked');
+assert.equal(rateLimitDenied.connections, 1, 'denial counter incremented');
+
+reset();
+assert.equal(checkConnectionRate('2.2.2.2'), true, 'separate IP independent');
+
+// --- checkEventRate ---
+reset();
+assert.equal(checkEventRate('sock1'), true, 'first event allowed');
+for (let i = 0; i < 29; i++) checkEventRate('sock1');
+assert.equal(checkEventRate('sock1'), false, '31st event blocked');
+assert.equal(rateLimitDenied.events, 1);
+
+reset();
+assert.equal(checkEventRate('sock2'), true, 'separate socket independent');
+
+// --- checkHealthRate ---
+reset();
+assert.equal(checkHealthRate('1.2.3.4'), true, 'first health check allowed');
+for (let i = 0; i < 9; i++) checkHealthRate('1.2.3.4');
+assert.equal(checkHealthRate('1.2.3.4'), false, '11th health check blocked');
+assert.equal(rateLimitDenied.health, 1);
+
+// --- checkAdminMetricsAuthRate ---
+reset();
+assert.equal(checkAdminMetricsAuthRate('5.6.7.8'), true, 'first admin auth allowed');
+for (let i = 0; i < 4; i++) checkAdminMetricsAuthRate('5.6.7.8');
+assert.equal(checkAdminMetricsAuthRate('5.6.7.8'), false, '6th admin auth blocked');
+assert.equal(rateLimitDenied.adminMetricsAuth, 1);
+
+// --- checkAuthRate ---
+reset();
+assert.equal(checkAuthRate('10.0.0.1', 'room-a'), true, 'first auth attempt allowed');
+for (let i = 0; i < 5; i++) recordAuthFailure('10.0.0.1', 'room-a');
+assert.equal(checkAuthRate('10.0.0.1', 'room-a'), false, '6th auth attempt blocked');
+assert.equal(checkAuthRate('10.0.0.1', 'room-b'), true, 'different room not blocked');
+
+// --- recordAuthFailure ---
+reset();
+recordAuthFailure('10.0.0.2', 'room-x');
+assert.equal(failedAuthAttempts.size, 1, 'failure recorded');
+const record = failedAuthAttempts.get('10.0.0.2:room-x');
+assert.equal(record.count, 1, 'count incremented');
+assert.ok(record.lastAttempt <= Date.now(), 'timestamp set');
+
+recordAuthFailure('10.0.0.2', 'room-x');
+assert.equal(failedAuthAttempts.get('10.0.0.2:room-x').count, 2, 'count increments on repeat');
+
+// --- clearRateLimitMaps ---
+reset();
+connectionCounts.set('ip1', { count: 1, resetTime: Date.now() + 60000 });
+eventCounts.set('sock1', { count: 1, resetTime: Date.now() + 10000 });
+healthCounts.set('ip2', { count: 1, resetTime: Date.now() + 60000 });
+adminMetricsAuthCounts.set('ip3', { count: 1, resetTime: Date.now() + 60000 });
+roomListCooldowns.set('sock2', Date.now());
+clearRateLimitMaps();
+assert.equal(connectionCounts.size, 0, 'connectionCounts cleared');
+assert.equal(eventCounts.size, 0, 'eventCounts cleared');
+assert.equal(healthCounts.size, 0, 'healthCounts cleared');
+assert.equal(adminMetricsAuthCounts.size, 0, 'adminMetricsAuthCounts cleared');
+assert.equal(roomListCooldowns.size, 0, 'roomListCooldowns cleared');
+
+// --- startRateLimitCleanup / stopRateLimitCleanup ---
+reset();
+startRateLimitCleanup(mockIo);
+startRateLimitCleanup(mockIo); // double-start guard
+stopRateLimitCleanup();
+assert.ok(true, 'cleanup start/stop does not throw');
+
+// --- rateLimitDenied reset ---
+reset();
+rateLimitDenied.connections = 5;
+Object.assign(rateLimitDenied, { connections: 0, events: 0, health: 0, adminMetricsAuth: 0, roomList: 0 });
+assert.equal(rateLimitDenied.connections, 0, 'denial counter resettable');
+
+console.log('rate-limiter tests passed');
@@ -77,9 +77,12 @@ assert.equal(adminHealth.avgPeersPerRoom, 2.5, 'admin metrics should include ave
 assert.equal(adminHealth.maxPeersInRoom, 3, 'admin metrics should include max room size');
 assert.deepEqual(adminHealth.memory, { rss: 10, heapUsed: 5, heapTotal: 8 }, 'admin metrics should expose process memory');
 assert.deepEqual(
-  adminHealth.rateLimitEntries,
-  { connections: 1, events: 2, health: 3, adminMetricsAuth: 4, authFailures: 5, roomList: 6 },
-  'admin metrics should expose aggregate rate-limit map sizes'
+  adminHealth.rateLimits,
+  {
+    trackedClients: { connections: 1, events: 2, health: 3, adminMetricsAuth: 4, authFailures: 5, roomList: 6 },
+    denied: { connections: 0, events: 0, health: 0, adminMetricsAuth: 0, roomList: 0 }
+  },
+  'admin metrics should expose rate-limit tracking and denial counts'
 );

 console.log('server ops tests passed');
@@ -1,5 +1,8 @@
 import assert from 'node:assert/strict';
-import {
+
+// Must set env before dynamic import — ESM hoists static imports
+process.env.ADMIN_METRICS_TOKEN = process.env.ADMIN_METRICS_TOKEN || 'test-admin-token-with-more-than-32-chars';
+const {
  ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE,
  HEALTH_RATE_LIMIT_PER_MINUTE,
  healthCounts,
@@ -9,9 +12,9 @@ import {
  rooms,
  startServer,
  stopServerForTests
-} from '../server/index.js';
+} = await import('../server/index.js');

-const adminToken = process.env.ADMIN_METRICS_TOKEN || 'test-admin-token-with-more-than-32-chars';
+const adminToken = process.env.ADMIN_METRICS_TOKEN;
 const baseHeaders = { 'x-forwarded-for': '203.0.113.10' };

 function url(path) {
@@ -0,0 +1,103 @@
+import assert from 'node:assert/strict';
+import http from 'node:http';
+import { createRequire } from 'node:module';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(path.join(__dirname, '..', 'server', 'package.json'));
+const WebSocket = require('ws');
+
+let port, mod, clients = [];
+
+function wsu() { return `ws://127.0.0.1:${port}/socket.io/?EIO=4&transport=websocket&version=2.4.0&token=62170b705234c4f4807a9b22420bb93cf1a2aacfa4c5d3b47804482babb8eb50`; }
+async function c() {
+    const ws = new WebSocket(wsu()); clients.push(ws); ws._m = []; ws.on('message', d => ws._m.push(d.toString()));
+    await new Promise((r, j) => { const t = setTimeout(() => j(Error('connect')), 5e3); ws.on('open', () => { clearTimeout(t); r(); }); });
+    ws.send('40'); const s = Date.now(); while (ws._m.length < 2 && Date.now()-s < 5e3) await new Promise(r => setTimeout(r, 50));
+    if (ws._m.length < 2) throw Error('handshake');
+    ws._m.length = 0; return ws;
+}
+function s(ws, evt, d={}) { ws.send(`42${JSON.stringify([evt,d])}`); }
+function a(ws) { if (ws._m.length) { const r=ws._m.shift(); return r.startsWith('42') ? JSON.parse(r.substring(2)) : r; } return new Promise((resolve, reject) => { const t=setTimeout(()=>reject(Error('timeout')),3e3); const h=(d)=>{clearTimeout(t);ws.removeListener('message',h);const r=d.toString();resolve(r.startsWith('42')?JSON.parse(r.substring(2)):r);};ws.on('message',h);}); }
+async function w(ws, evt, ms=3000) { const st=Date.now(); while(Date.now()-st<ms) { for(let i=0;i<ws._m.length;i++){const r=ws._m[i];ws._m.splice(i,1);if(r.startsWith('42')){try{const[e]=JSON.parse(r.substring(2));if(e===evt)return e}catch{/* skip */}}} await new Promise(r=>setTimeout(r,50));} throw Error(`wait:${evt}`); }
+async function j(ws, rid, pid, pw=null) { s(ws,'join_room',{roomId:rid,peerId:pid,password:pw,protocolVersion:'1.0.0'}); assert.equal((await a(ws))[0],'room_data'); }
+function close() { clients.forEach(w=>{try{w.close()}catch{/* ignore */}}); clients.length=0; }
+
+try {
+    process.env.ADMIN_METRICS_TOKEN = 'ws-integration-test-32chars-minimum!';
+    mod = await import('../server/index.js');
+    await mod.startServer(0,'127.0.0.1');
+    port = mod.httpServer.address().port;
+
+    // --- Pool: 2 peers in 1 room, test everything ---
+    const rid = 't-'+Date.now();
+    const p1 = await c(), p2 = await c();
+
+    // Room + join
+    await j(p1, rid, 'a'); await j(p2, rid, 'b'); p1._m.length = p2._m.length = 0;
+
+    // Relay
+    s(p1,'play',{currentTime:10}); await w(p2,'play');
+    s(p1,'pause',{currentTime:20}); await w(p2,'pause');
+    s(p1,'seek',{currentTime:30}); await w(p2,'seek');
+
+    // Force Sync
+    s(p1,'force_sync_prepare',{targetTime:0}); await w(p2,'force_sync_prepare');
+    s(p1,'force_sync_ack',{}); await w(p2,'force_sync_ack');
+    s(p1,'force_sync_execute',{}); await w(p2,'force_sync_execute');
+
+    // EVENT_ACK
+    s(p2,'event_ack',{targetId:'a',actionTimestamp:Date.now()}); await w(p1,'event_ack');
+
+    // Lobby
+    s(p1,'episode_lobby',{expectedTitle:'S01E01'}); await w(p2,'episode_lobby');
+
+    // Leave
+    s(p1,'leave_room',{}); const [ev,d]=await a(p2); assert.equal(ev,'peer_status');assert.equal(d.status,'left');
+
+    close();
+
+    // --- Password room ---
+    const prid = 'pw-'+Date.now();
+    const pw1 = await c(); await j(pw1, prid, 'admin', 's3cret');
+    const pw2 = await c();
+    s(pw2,'join_room',{roomId:prid,password:'BAD',peerId:'bad',protocolVersion:'1.0.0'});
+    assert.equal((await a(pw2))[0],'error','wrong pw');
+    const pw3 = await c();
+    s(pw3,'join_room',{roomId:prid,password:'s3cret',peerId:'good',protocolVersion:'1.0.0'});
+    assert.equal((await a(pw3))[0],'room_data','correct pw');
+    close();
+
+    // --- Protocol check + Ping + GET_ROOMS + Health ---
+    const x = await c();
+    s(x,'join_room',{roomId:'v-'+Date.now(),peerId:'old',protocolVersion:'0.0.1'});
+    await w(x,'error'); // version mismatch
+    x._m.length = 0;
+    s(x,'ping',{t:Date.now()}); await w(x,'pong');
+    await j(x,'lst-'+Date.now(),'l1');
+    x._m.length = 0;
+    s(x,'get_rooms',{}); await w(x,'room_list');
+    close();
+
+    // Dedup
+    const did = 'dup-'+Date.now();
+    const d1 = await c(), d2 = await c();
+    await j(d1, did, 'dup'); d1._m.length = 0;
+    s(d2,'join_room',{roomId:did,peerId:'dup',protocolVersion:'1.0.0'});
+    assert.equal((await a(d2))[0],'room_data','dedup');
+    close();
+
+    // Health HTTP (no conn needed)
+    const [st,body] = await new Promise(r => http.get(`http://127.0.0.1:${port}/`, res => {
+        let d=''; res.on('data',c=>d+=c); res.on('end',()=>r([res.statusCode,JSON.parse(d)])); }));
+    assert.equal(st,200); assert.equal(body.status,'online');
+
+    console.log('All 13 WebSocket integration tests passed');
+} catch(e) {
+    console.error('FAILED:', e.message);
+    process.exitCode=1;
+} finally {
+    close();
+    if (mod?.stopServerForTests) await mod.stopServerForTests();
+}
@@ -17,7 +17,7 @@ const enDict = JSON.parse(fs.readFileSync(enPath, 'utf8'));
 const enKeys = Object.keys(enDict).sort();

 const localeFiles = fs.readdirSync(localesDir)
-  .filter(file => file.endsWith('.json') && file !== 'en.json')
+  .filter(file => file.endsWith('.json'))
  .sort();

 let hasError = false;
@@ -51,8 +51,24 @@ for (const file of localeFiles) {

    const missingKeys = enKeys.filter(k => !keys.includes(k));
    const extraKeys = keys.filter(k => !enKeys.includes(k));
+    const emptyKeys = keys.filter(k => {
+      if (file === 'en.json' && k === 'CANONICAL_PATH') return false;
+      return typeof dict[k] === 'string' && dict[k].trim() === '';
+    });
+    const placeholderKeys = keys.filter(k => {
+      if (typeof dict[k] !== 'string') return false;
+      const val = dict[k];
+      const lower = val.toLowerCase();
+      return (
+        lower.includes('placeholder') ||
+        lower.includes('todo:') ||
+        lower.includes('tbd:') ||
+        /\bTODO\b/.test(val) ||
+        /\bTBD\b/.test(val)
+      );
+    });

-    if (missingKeys.length > 0 || extraKeys.length > 0) {
+    if (missingKeys.length > 0 || extraKeys.length > 0 || emptyKeys.length > 0 || placeholderKeys.length > 0) {
      hasError = true;
      console.error(`❌ ${file} has inconsistencies:`);
      if (missingKeys.length > 0) {
@@ -61,6 +77,12 @@ for (const file of localeFiles) {
      if (extraKeys.length > 0) {
        console.error(`  Extra keys (${extraKeys.length}):`, extraKeys);
      }
+      if (emptyKeys.length > 0) {
+        console.error(`  Empty translation values (${emptyKeys.length}):`, emptyKeys);
+      }
+      if (placeholderKeys.length > 0) {
+        console.error(`  Placeholder/TODO values (${placeholderKeys.length}):`, placeholderKeys);
+      }
    } else {
      console.log(`✓ ${file} is fully consistent (matches all keys).`);
    }
@@ -11,21 +11,26 @@ const checks = [
  ['server routes', 'node', ['scripts/test-server-routes.mjs'], {
    env: { ADMIN_METRICS_TOKEN: 'verify-admin-token-with-more-than-32-chars' }
  }],
-  ['content video finder', 'node', ['scripts/test-content-video-finder.js']],
+  ['rate-limiter unit tests', 'node', ['scripts/test-rate-limiter.mjs']],
+  ['episode-utils unit tests', 'node', ['scripts/test-episode-utils.mjs']],
+  ['server WebSocket integration', 'node', ['scripts/test-server-ws.mjs']],
+  ['names generator', 'node', ['scripts/test-names.mjs']],
+  ['content video finder', 'node', ['scripts/test-content-video-finder.cjs']],
  ['audio settings', 'node', ['scripts/test-audio-settings.mjs']],
  ['popup refresh cooldown', 'node', ['scripts/test-popup-refresh-cooldown.mjs']],
  ['server syntax index', 'node', ['-c', 'server/index.js']],
  ['server syntax ops', 'node', ['-c', 'server/ops.js']],
+  ['server syntax rate-limiter', 'node', ['-c', 'server/rate-limiter.js']],
  ['content syntax', 'node', ['-c', 'extension/content.js']],
  ['popup syntax', 'node', ['-c', 'extension/popup.js']],
  ['background syntax', 'node', ['-c', 'extension/background.js']],
-  ['locale coverage', 'node', ['scripts/test-locales.js']],
+  ['locale coverage', 'node', ['scripts/test-locales.cjs']],
  ['website locale coverage', 'node', ['scripts/test-website-locales.mjs']],
  ['lint', 'npm', ['run', 'lint']],
  ['root production audit', 'npm', ['audit', '--omit=dev']],
  ['server production audit', 'npm', ['audit', '--omit=dev'], { cwd: path.join(repoRoot, 'server') }],
  ['extension build', 'npm', ['run', 'build:extension']],
-  ['website build', 'node', ['website/build.js']]
+  ['website build', 'node', ['website/build.cjs']]
 ];

 function runCheck([label, command, args, options = {}]) {
@@ -10,4 +10,7 @@ RUN cd server && npm install --production
 COPY server/ ./server/

 WORKDIR /app/server
+EXPOSE 3000
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:3000/health || exit 1
 CMD ["node", "index.js"]
@@ -71,3 +71,11 @@ npm start
 - **Single Source of Truth**: The server imports constants directly from the root `shared/` directory.
 - **In-Memory**: Rooms are automatically pruned after 2 hours of inactivity.
 - **Reverse Proxy Boundary**: The server trusts one reverse proxy hop for client IP detection. Keep the Node port private/firewalled so clients can only reach it through Caddy or another trusted proxy.
+
+## Module Structure
+
+| File | Purpose |
+|---|---|
+| `index.js` | Express + Socket.IO server: room management, relay loop, graceful shutdown |
+| `rate-limiter.js` | Connection, event, health, and auth rate limiting with 6 functions + cleanup intervals |
+| `ops.js` | Health endpoint helpers, metrics payload builder, auth validation |
@@ -12,6 +12,38 @@ import {
    isAdminMetricsAuthorized,
    isAdminMetricsTokenStrong
 } from './ops.js';
+import {
+    ROOM_LIST_COOLDOWN_MS,
+    HEALTH_RATE_LIMIT_PER_MINUTE,
+    ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE,
+    connectionCounts,
+    failedAuthAttempts,
+    eventCounts,
+    healthCounts,
+    adminMetricsAuthCounts,
+    roomListCooldowns,
+    rateLimitDenied,
+    checkAuthRate,
+    recordAuthFailure,
+    checkConnectionRate,
+    checkEventRate,
+    checkHealthRate,
+    checkAdminMetricsAuthRate,
+    startRateLimitCleanup,
+    stopRateLimitCleanup,
+    clearRateLimitMaps
+} from './rate-limiter.js';
+
+// Re-export for external consumers (tests, ops)
+export {
+    HEALTH_RATE_LIMIT_PER_MINUTE,
+    ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE,
+    healthCounts,
+    adminMetricsAuthCounts,
+    connectionCounts,
+    eventCounts,
+    rateLimitDenied
+};

 dotenv.config();

@@ -26,9 +58,6 @@ const MAX_ROOMS = parseInt(process.env.MAX_ROOMS) || 1000;
 const MAX_PEERS_PER_ROOM = parseInt(process.env.MAX_PEERS_PER_ROOM) || 25;
 const MIN_VERSION = process.env.MIN_VERSION || '1.0.0';
 const ADMIN_METRICS_TOKEN = process.env.ADMIN_METRICS_TOKEN || '';
-const ROOM_LIST_COOLDOWN_MS = 10000;
-export const HEALTH_RATE_LIMIT_PER_MINUTE = 10;
-export const ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE = 5;
 const HEALTH_RESPONSE_CACHE_TTL_MS = 60000;

 if (!isAdminMetricsTokenStrong(ADMIN_METRICS_TOKEN)) {
@@ -82,7 +111,8 @@ app.get('/health', (req, res) => {
                adminMetricsAuth: adminMetricsAuthCounts.size,
                authFailures: failedAuthAttempts.size,
                roomList: roomListCooldowns.size
-            }
+            },
+            rateLimitDenied
        })
    ));
 });
@@ -96,7 +126,7 @@ export const io = new Server(httpServer, {
            if (!origin || origin === 'https://sync.koalastuff.net' || origin.startsWith('chrome-extension://') || origin.startsWith('moz-extension://')) {
                callback(null, true);
            } else {
-                log('CORS', `Rejected origin: ${origin}`);
+                log('CORS', `Rejected origin: ${(origin || '').replace(/[\r\n]/g, '')}`);
                callback(new Error('Not allowed by CORS'));
            }
        },
@@ -107,6 +137,8 @@ export const io = new Server(httpServer, {
    allowUpgrades: false
 });

+startRateLimitCleanup(io);
+
 /**
 * In-memory storage
 */
@@ -114,6 +146,7 @@ export const rooms = new Map();
 const socketToRoom = new Map();
 const peerToSocket = new Map(); // peerId -> socketId (Global lookup)
 const roomCreationLocks = new Map(); // roomId -> Promise (prevents race on room creation)
+const peerJoinLocks = new Map(); // peerId -> Promise (prevents race on same peerId joins)

 function log(type, message, details = '') {
    const debugLogging = process.env.DEBUG_LOGGING === '1';
@@ -124,140 +157,6 @@ function log(type, message, details = '') {
    console.log(`[${timestamp}] [${type}] ${message}`, details);
 }

-// Rate Limiting & Security
-export const connectionCounts = new Map(); // ip -> { count, resetTime }
-const failedAuthAttempts = new Map(); // Map<IP+RoomID, {count, lastAttempt}>
-
-function checkAuthRate(ip, roomId) {
-    const key = `${ip}:${roomId}`;
-    const now = Date.now();
-    const record = failedAuthAttempts.get(key) || { count: 0, lastAttempt: 0 };
-    
-    // Block for 15 mins if 5 fails in 2 mins
-    if (record.count >= 5 && (now - record.lastAttempt) < 15 * 60 * 1000) {
-        return false;
-    }
-    
-    // Reset if last attempt was long ago
-    if ((now - record.lastAttempt) > 2 * 60 * 1000) {
-        record.count = 0;
-    }
-    
-    return true;
-}
-
-function recordAuthFailure(ip, roomId) {
-    if (failedAuthAttempts.size > 50000) {
-        const now = Date.now();
-        // 1. Clear expired entries (> 15 mins)
-        for (const [key, record] of failedAuthAttempts.entries()) {
-            if (now - record.lastAttempt > 15 * 60 * 1000) {
-                failedAuthAttempts.delete(key);
-            } else {
-                break; // Since entries are insertion-ordered by time, all subsequent entries are newer
-            }
-        }
-        
-        // 2. If still over 50k, perform LRU-style eviction on the oldest 10,000 entries (first items in Map order)
-        if (failedAuthAttempts.size > 50000) {
-            log('SECURITY', 'failedAuthAttempts size exceeded 50000. Performing insertion-order eviction.');
-            for (const [key] of failedAuthAttempts.entries()) {
-                if (failedAuthAttempts.size <= 40000) {
-                    break;
-                }
-                failedAuthAttempts.delete(key);
-            }
-        }
-    }
-    const key = `${ip}:${roomId}`;
-    const record = failedAuthAttempts.get(key) || { count: 0, lastAttempt: 0 };
-    record.count++;
-    record.lastAttempt = Date.now();
-    failedAuthAttempts.delete(key); // Remove first to update insertion order (moves key to the end of iteration)
-    failedAuthAttempts.set(key, record);
-}
-
-// Periodically clean up old auth failure records (every 15 minutes)
-const authFailureCleanupInterval = setInterval(() => {
-    const now = Date.now();
-    for (const [key, record] of failedAuthAttempts.entries()) {
-        if (now - record.lastAttempt > 15 * 60 * 1000) {
-            failedAuthAttempts.delete(key);
-        }
-    }
-}, 15 * 60 * 1000);
-
-export const eventCounts = new Map(); // socketId -> { count, resetTime }
-export const healthCounts = new Map(); // ip -> { count, resetTime }
-export const adminMetricsAuthCounts = new Map(); // ip -> { count, resetTime }
-const roomListCooldowns = new Map(); // socketId -> last allowed timestamp
-
-// Clean up connection counts and event counts to prevent memory leak
-const rateLimitCleanupInterval = setInterval(() => {
-    const now = Date.now();
-    for (const [ip, entry] of connectionCounts.entries()) {
-        if (now > entry.resetTime) {
-            connectionCounts.delete(ip);
-        }
-    }
-    for (const [socketId, entry] of eventCounts.entries()) {
-        if (now > entry.resetTime || !io.sockets.sockets.has(socketId)) {
-            eventCounts.delete(socketId);
-        }
-    }
-    for (const [ip, entry] of healthCounts.entries()) {
-        if (now > entry.resetTime) {
-            healthCounts.delete(ip);
-        }
-    }
-    for (const [ip, entry] of adminMetricsAuthCounts.entries()) {
-        if (now > entry.resetTime) {
-            adminMetricsAuthCounts.delete(ip);
-        }
-    }
-    for (const [socketId] of roomListCooldowns.entries()) {
-        if (!io.sockets.sockets.has(socketId)) {
-            roomListCooldowns.delete(socketId);
-        }
-    }
-}, 60000);
-
-function checkConnectionRate(ip) {
-    const now = Date.now();
-    const entry = connectionCounts.get(ip) || { count: 0, resetTime: now + 60000 };
-    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
-    entry.count++;
-    connectionCounts.set(ip, entry);
-    return entry.count <= 10;
-}
-
-function checkEventRate(socketId) {
-    const now = Date.now();
-    const entry = eventCounts.get(socketId) || { count: 0, resetTime: now + 10000 };
-    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 10000; }
-    entry.count++;
-    eventCounts.set(socketId, entry);
-    return entry.count <= 30;
-}
-
-function checkHealthRate(ip) {
-    const now = Date.now();
-    const entry = healthCounts.get(ip) || { count: 0, resetTime: now + 60000 };
-    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
-    entry.count++;
-    healthCounts.set(ip, entry);
-    return entry.count <= HEALTH_RATE_LIMIT_PER_MINUTE;
-}
-
-function checkAdminMetricsAuthRate(ip) {
-    const now = Date.now();
-    const entry = adminMetricsAuthCounts.get(ip) || { count: 0, resetTime: now + 60000 };
-    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
-    entry.count++;
-    adminMetricsAuthCounts.set(ip, entry);
-    return entry.count <= ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE;
-}
-
 /**
 * Central peer teardown. Removes a socket from all room state and notifies
 * remaining peers. Call this from every disconnect/leave/reaper/dedupe path.
@@ -451,7 +350,20 @@ io.on('connection', (socket) => {
                return;
            }

-            if (!createdByMe) {
+            let peerLockPromise = peerJoinLocks.get(peerId);
+            if (peerLockPromise) {
+                await peerLockPromise;
+                room = rooms.get(roomId);
+                if (!room) {
+                    socket.emit(EVENTS.ERROR, { message: "Room no longer exists" });
+                    return;
+                }
+            }
+            let resolvePeerLock;
+            peerLockPromise = new Promise(resolve => { resolvePeerLock = resolve; });
+            peerJoinLocks.set(peerId, peerLockPromise);
+            try {
+                if (!createdByMe) {
                if (room.passwordHash) {
                    if (!password || hashPassword(password) !== room.passwordHash) {
                        recordAuthFailure(ip, roomId);
@@ -509,6 +421,10 @@ io.on('connection', (socket) => {
                activeLobby: room.activeLobby || null
            });
            log('ROOM', `Peer ${peerId} joined: ${roomId.substring(0, 3)}***`);
+            } finally {
+                peerJoinLocks.delete(peerId);
+                resolvePeerLock();
+            }
        } catch (err) {
            log('ERROR', `Join error for ${socket.id}`, err);
            if (socket.connected) {
@@ -585,7 +501,7 @@ io.on('connection', (socket) => {
                    socket.to(mapping.roomId).emit(eventName, relayPayload);

                    // --- Side-effects: Server-side Episode Lobby Tracking ---
-                    if (eventName === EVENTS.EPISODE_LOBBY && relayPayload.expectedTitle) {
+                    if (eventName === EVENTS.EPISODE_LOBBY && relayPayload.expectedTitle && !room.activeLobby) {
                        room.activeLobby = {
                            expectedTitle: relayPayload.expectedTitle,
                            initiatorPeerId: mapping.peerId,
@@ -613,6 +529,7 @@ io.on('connection', (socket) => {
            return;
        }
        if (!checkCooldown(roomListCooldowns, socket.id, ROOM_LIST_COOLDOWN_MS)) {
+            rateLimitDenied.roomList++;
            socket.emit(EVENTS.ERROR, { message: 'Room list refresh is rate limited. Try again in a few seconds.' });
            return;
        }
@@ -625,10 +542,14 @@ io.on('connection', (socket) => {
    });

    socket.on(EVENTS.LEAVE_ROOM, () => {
-        const mapping = socketToRoom.get(socket.id);
-        if (mapping) {
-            socket.leave(mapping.roomId);
-            removePeerFromRoom(socket.id, mapping.roomId, 'leave');
+        try {
+            const mapping = socketToRoom.get(socket.id);
+            if (mapping) {
+                socket.leave(mapping.roomId);
+                removePeerFromRoom(socket.id, mapping.roomId, 'leave');
+            }
+        } catch (err) {
+            log('ERROR', 'removePeerFromRoom failed in leave', err);
        }
    });

@@ -657,15 +578,58 @@ io.on('connection', (socket) => {
        }
    });

+    socket.on(EVENTS.PING, (data) => {
+        if (!checkEventRate(socket.id)) {
+            socket.disconnect(true);
+            return;
+        }
+        if (!data || typeof data.t !== 'number' || !Number.isFinite(data.t)) return;
+
+        if (typeof data.target === 'string' && data.target.length > 0) {
+            const targetSocketId = peerToSocket.get(data.target);
+            const senderMapping = socketToRoom.get(socket.id);
+            if (targetSocketId && senderMapping && data.target !== senderMapping.peerId) {
+                const targetMapping = socketToRoom.get(targetSocketId);
+                if (targetMapping && targetMapping.roomId === senderMapping.roomId) {
+                    io.to(targetSocketId).emit(EVENTS.PING, { t: data.t, sender: senderMapping.peerId });
+                    return;
+                }
+            }
+        }
+
+        socket.emit(EVENTS.PONG, { t: data.t });
+    });
+
+    socket.on(EVENTS.PONG, (data) => {
+        if (!checkEventRate(socket.id)) {
+            socket.disconnect(true);
+            return;
+        }
+        if (!data || typeof data.target !== 'string' || data.target.length === 0) return;
+        if (typeof data.t !== 'number' || !Number.isFinite(data.t)) return;
+
+        const senderMapping = socketToRoom.get(socket.id);
+        if (!senderMapping || data.target === senderMapping.peerId) return;
+
+        const targetSocketId = peerToSocket.get(data.target);
+        if (!targetSocketId) return;
+
+        const targetMapping = socketToRoom.get(targetSocketId);
+        if (targetMapping && targetMapping.roomId === senderMapping.roomId) {
+            io.to(targetSocketId).emit(EVENTS.PONG, { t: data.t });
+        }
+    });
+
    socket.on('disconnect', () => {
        eventCounts.delete(socket.id);
        roomListCooldowns.delete(socket.id);
        const mapping = socketToRoom.get(socket.id);
        if (mapping) {
-            // Socket is already disconnected — no need to call socket.leave().
-            // removePeerFromRoom uses io.to() for notifications, which correctly
-            // excludes this dead socket since it has already left all rooms.
-            removePeerFromRoom(socket.id, mapping.roomId, 'disconnect');
+            try {
+                removePeerFromRoom(socket.id, mapping.roomId, 'disconnect');
+            } catch (err) {
+                log('ERROR', 'removePeerFromRoom failed in disconnect', err);
+            }
        }
    });
 });
@@ -690,12 +654,14 @@ const roomCleanupInterval = setInterval(() => {
            }
        }
        for (const sid of staleSids) {
-            // Gracefully evict the socket from the Socket.IO room if it is
-            // still technically connected (zombie with no heartbeat).
            const deadSocket = io.sockets?.sockets?.get(sid);
            if (deadSocket) deadSocket.leave(roomId);
            log('CLEANUP', `Pruning dead peer from room ${roomId.substring(0, 3)}***`);
-            removePeerFromRoom(sid, roomId, 'reaper');
+            try {
+                removePeerFromRoom(sid, roomId, 'reaper');
+            } catch (err) {
+                log('ERROR', 'removePeerFromRoom failed in reaper', err);
+            }
        }

        // 2. Prune empty or inactive rooms
@@ -736,7 +702,7 @@ export function startServer(port = PORT, host) {
 function gracefulShutdown(signal) {
    log('SERVER', `${signal} received — starting graceful shutdown...`);
    // 1. Notify all connected clients so they can display a meaningful message
-    io.emit(EVENTS.ERROR, { message: 'Server is restarting. Please reconnect in a moment.' });
+    io.emit(EVENTS.ERROR, { message: 'Server is restarting. Reconnecting automatically...' });
    // 2. Stop accepting new HTTP connections
    httpServer.close(() => {
        log('SERVER', 'HTTP server closed. Exiting.');
@@ -750,22 +716,18 @@ function gracefulShutdown(signal) {
 }

 export async function stopServerForTests() {
-    clearInterval(authFailureCleanupInterval);
-    clearInterval(rateLimitCleanupInterval);
+    stopRateLimitCleanup();
    clearInterval(roomCleanupInterval);
    rooms.clear();
    socketToRoom.clear();
    peerToSocket.clear();
    roomCreationLocks.clear();
-    connectionCounts.clear();
-    failedAuthAttempts.clear();
-    eventCounts.clear();
-    healthCounts.clear();
-    adminMetricsAuthCounts.clear();
-    roomListCooldowns.clear();
+    peerJoinLocks.clear();
+    clearRateLimitMaps();
    healthResponseCache.clear();
    io.removeAllListeners();
    io.disconnectSockets(true);
+    Object.assign(rateLimitDenied, { connections: 0, events: 0, health: 0, adminMetricsAuth: 0, roomList: 0 });
    if (!httpServer.listening) return;
    await new Promise((resolve, reject) => {
        httpServer.close((err) => err ? reject(err) : resolve());
@@ -785,8 +747,19 @@ if (isMainModule) {
        process.exit(1);
    });

+    let unhandledRejectionCount = 0;
+    let unhandledRejectionReset = Date.now();
    process.on('unhandledRejection', (reason) => {
-        log('ERROR', `Unhandled rejection: ${reason}`);
-        process.exit(1);
+        log('ERROR', `Unhandled rejection: ${reason}`, reason?.stack || '');
+        const now = Date.now();
+        if (now - unhandledRejectionReset > 60000) {
+            unhandledRejectionCount = 0;
+            unhandledRejectionReset = now;
+        }
+        unhandledRejectionCount++;
+        if (unhandledRejectionCount >= 5) {
+            log('ERROR', `Too many unhandled rejections (${unhandledRejectionCount}/min) — aborting`);
+            process.exit(1);
+        }
    });
 }
@@ -33,8 +33,17 @@ export function isAdminMetricsAuthorized(authHeader, adminToken) {
    const expectedBuffer = Buffer.from(adminToken);
    const providedBuffer = Buffer.from(provided);

-    if (expectedBuffer.length !== providedBuffer.length) return false;
-    return crypto.timingSafeEqual(expectedBuffer, providedBuffer);
+    // Always run timingSafeEqual to prevent length-based timing leaks.
+    // timingSafeEqual throws on different-length buffers, so when lengths
+    // differ we compare against a zeroed buffer of the provided length
+    // (guaranteed mismatch, constant time).
+    // NOTE: timingSafeEqual must be evaluated eagerly (assigned to const)
+    // before the && short-circuit, otherwise it's skipped on length mismatch
+    // and the timing leak remains.
+    const sameLength = expectedBuffer.length === providedBuffer.length;
+    const compareBuf = sameLength ? expectedBuffer : Buffer.alloc(providedBuffer.length);
+    const equal = crypto.timingSafeEqual(compareBuf, providedBuffer);
+    return sameLength && equal;
 }

 export function isAdminMetricsTokenStrong(adminToken, minLength = 32) {
@@ -48,7 +57,8 @@ export function buildHealthPayload({
    now = Date.now(),
    uptime = 0,
    memoryUsage = () => process.memoryUsage(),
-    rateLimitSizes = {}
+    rateLimitSizes = {},
+    rateLimitDenied = {}
 }) {
    const payload = {
        status: 'ok',
@@ -60,28 +70,42 @@ export function buildHealthPayload({

    if (!includeMetrics) return payload;

-    const roomValues = Array.from(rooms.values());
-    const roomSizes = roomValues.map(room => room.peers?.size || 0);
-    const peers = roomSizes.reduce((sum, size) => sum + size, 0);
-    const maxPeersInRoom = roomSizes.length > 0 ? Math.max(...roomSizes) : 0;
-    const avgPeersPerRoom = roomSizes.length > 0
-        ? Math.round((peers / roomSizes.length) * 100) / 100
+    let peers = 0;
+    let maxPeersInRoom = 0;
+    let roomsWithLobby = 0;
+    for (const room of rooms.values()) {
+        const size = room.peers?.size || 0;
+        peers += size;
+        if (size > maxPeersInRoom) maxPeersInRoom = size;
+        if (room.activeLobby) roomsWithLobby++;
+    }
+    const avgPeersPerRoom = rooms.size > 0
+        ? Math.round((peers / rooms.size) * 100) / 100
        : 0;
    const mem = memoryUsage();

    return {
        ...payload,
        peers,
-        roomsWithLobby: roomValues.filter(room => !!room.activeLobby).length,
+        roomsWithLobby,
        avgPeersPerRoom,
        maxPeersInRoom,
-        rateLimitEntries: {
-            connections: rateLimitSizes.connections || 0,
-            events: rateLimitSizes.events || 0,
-            health: rateLimitSizes.health || 0,
-            adminMetricsAuth: rateLimitSizes.adminMetricsAuth || 0,
-            authFailures: rateLimitSizes.authFailures || 0,
-            roomList: rateLimitSizes.roomList || 0
+        rateLimits: {
+            trackedClients: {
+                connections: rateLimitSizes.connections || 0,
+                events: rateLimitSizes.events || 0,
+                health: rateLimitSizes.health || 0,
+                adminMetricsAuth: rateLimitSizes.adminMetricsAuth || 0,
+                authFailures: rateLimitSizes.authFailures || 0,
+                roomList: rateLimitSizes.roomList || 0
+            },
+            denied: {
+                connections: rateLimitDenied.connections || 0,
+                events: rateLimitDenied.events || 0,
+                health: rateLimitDenied.health || 0,
+                adminMetricsAuth: rateLimitDenied.adminMetricsAuth || 0,
+                roomList: rateLimitDenied.roomList || 0
+            }
        },
        memory: {
            rss: mem.rss,
@@ -256,9 +256,9 @@
      }
    },
    "node_modules/engine.io": {
-      "version": "6.6.8",
-      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.6.8.tgz",
-      "integrity": "sha512-2agL3ueZhqxoVrfmntO8yuVj+uNSlIOnhykYHk3Cq0ShYPdUjjUiSJrQvXjq01I9jAuI0Zl2YO8Evv5Mqytm5g==",
+      "version": "6.6.9",
+      "resolved": "https://registry.npmjs.org/engine.io/-/engine.io-6.6.9.tgz",
+      "integrity": "sha512-clKkw4C7nJ22mGgoVcCg6V/W/TxdNyIOTr89k2ONZu81qqkddPFDF0LXcbAwhzPD8DjkiRCjzuiO6Y+fkpD4vg==",
      "license": "MIT",
      "dependencies": {
        "@types/cors": "^2.8.12",
@@ -270,7 +270,7 @@
        "cors": "~2.8.5",
        "debug": "~4.4.1",
        "engine.io-parser": "~5.2.1",
-        "ws": "~8.20.1"
+        "ws": "~8.21.0"
      },
      "engines": {
        "node": ">=10.2.0"
@@ -941,13 +941,13 @@
      }
    },
    "node_modules/socket.io-adapter": {
-      "version": "2.5.7",
-      "resolved": "https://registry.npmjs.org/socket.io-adapter/-/socket.io-adapter-2.5.7.tgz",
-      "integrity": "sha512-e0LyK91f3cUxTmv95/KzoLg47+zF+s/sbxRGDNsyG4dmIP8ZSX8ax6byOxfJXeNNtS/8AZlfD+uP7gBeR7DLlg==",
+      "version": "2.5.8",
+      "resolved": "https://registry.npmjs.org/socket.io-adapter/-/socket.io-adapter-2.5.8.tgz",
+      "integrity": "sha512-6Oy52pbg+kvdCVvjcN+FnY7BvxZ7cIHNScbvztT/It5d0vbwoJoVZmF2gjJmnV0/4WlXRfG15zc45ySk9Ah8bw==",
      "license": "MIT",
      "dependencies": {
        "debug": "~4.4.1",
-        "ws": "~8.20.1"
+        "ws": "~8.21.0"
      }
    },
    "node_modules/socket.io-parser": {
@@ -1069,9 +1069,9 @@
      "license": "ISC"
    },
    "node_modules/ws": {
-      "version": "8.20.1",
-      "resolved": "https://registry.npmjs.org/ws/-/ws-8.20.1.tgz",
-      "integrity": "sha512-It4dO0K5v//JtTXuPkfEOaI3uUN87iYPnqo/ZzqCoG3g8uhA66QUMs/SrM0YK7/NAu+r4LMh/9dq2A7k+rHs+w==",
+      "version": "8.21.0",
+      "resolved": "https://registry.npmjs.org/ws/-/ws-8.21.0.tgz",
+      "integrity": "sha512-Vsp28b7DRcimFQvrqu2Wek3z1iYxDCWqHYB8Qsnk/S4RfaCQzPGPyBNuVjJV3cd6UiKtUtp6sNM77gWvzcCH+g==",
      "license": "MIT",
      "engines": {
        "node": ">=10.0.0"
@@ -4,6 +4,7 @@
  "description": "",
  "main": "index.js",
  "scripts": {
+    "start": "node index.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
@@ -0,0 +1,164 @@
+/**
+ * KoalaSync Rate Limiter
+ * Connection, event, health, and auth rate limiting for the relay server.
+ */
+
+export const ROOM_LIST_COOLDOWN_MS = 10000;
+export const HEALTH_RATE_LIMIT_PER_MINUTE = 10;
+export const ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE = 5;
+
+export const connectionCounts = new Map(); // ip -> { count, resetTime }
+export const failedAuthAttempts = new Map(); // Map<IP+RoomID, {count, lastAttempt}>
+export const eventCounts = new Map(); // socketId -> { count, resetTime }
+export const healthCounts = new Map(); // ip -> { count, resetTime }
+export const adminMetricsAuthCounts = new Map(); // ip -> { count, resetTime }
+export const roomListCooldowns = new Map(); // socketId -> last allowed timestamp
+
+export const rateLimitDenied = {
+    connections: 0,
+    events: 0,
+    health: 0,
+    adminMetricsAuth: 0,
+    roomList: 0
+};
+
+let authCleanupId = null;
+let rateLimitCleanupId = null;
+
+export function checkAuthRate(ip, roomId) {
+    const key = `${ip}:${roomId}`;
+    const now = Date.now();
+    const record = failedAuthAttempts.get(key) || { count: 0, lastAttempt: 0 };
+
+    if (record.count >= 5 && (now - record.lastAttempt) < 15 * 60 * 1000) {
+        return false;
+    }
+
+    if ((now - record.lastAttempt) > 2 * 60 * 1000) {
+        record.count = 0;
+    }
+
+    return true;
+}
+
+export function recordAuthFailure(ip, roomId) {
+    if (failedAuthAttempts.size > 200000) {
+        const now = Date.now();
+        for (const [key, record] of failedAuthAttempts.entries()) {
+            if (now - record.lastAttempt > 15 * 60 * 1000) {
+                failedAuthAttempts.delete(key);
+            } else {
+                break;
+            }
+        }
+
+        if (failedAuthAttempts.size > 200000) {
+            console.warn('SECURITY: failedAuthAttempts size exceeded 200000. Performing insertion-order eviction.');
+            for (const [key] of failedAuthAttempts.entries()) {
+                if (failedAuthAttempts.size <= 190000) {
+                    break;
+                }
+                failedAuthAttempts.delete(key);
+            }
+        }
+    }
+    const key = `${ip}:${roomId}`;
+    const record = failedAuthAttempts.get(key) || { count: 0, lastAttempt: 0 };
+    record.count++;
+    record.lastAttempt = Date.now();
+    failedAuthAttempts.delete(key);
+    failedAuthAttempts.set(key, record);
+}
+
+export function checkConnectionRate(ip) {
+    const now = Date.now();
+    const entry = connectionCounts.get(ip) || { count: 0, resetTime: now + 60000 };
+    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
+    entry.count++;
+    connectionCounts.set(ip, entry);
+    if (entry.count <= 10) return true;
+    rateLimitDenied.connections++;
+    return false;
+}
+
+export function checkEventRate(socketId) {
+    const now = Date.now();
+    const entry = eventCounts.get(socketId) || { count: 0, resetTime: now + 10000 };
+    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 10000; }
+    entry.count++;
+    eventCounts.set(socketId, entry);
+    if (entry.count <= 30) return true;
+    rateLimitDenied.events++;
+    return false;
+}
+
+export function checkHealthRate(ip) {
+    const now = Date.now();
+    const entry = healthCounts.get(ip) || { count: 0, resetTime: now + 60000 };
+    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
+    entry.count++;
+    healthCounts.set(ip, entry);
+    if (entry.count <= HEALTH_RATE_LIMIT_PER_MINUTE) return true;
+    rateLimitDenied.health++;
+    return false;
+}
+
+export function checkAdminMetricsAuthRate(ip) {
+    const now = Date.now();
+    const entry = adminMetricsAuthCounts.get(ip) || { count: 0, resetTime: now + 60000 };
+    if (now > entry.resetTime) { entry.count = 0; entry.resetTime = now + 60000; }
+    entry.count++;
+    adminMetricsAuthCounts.set(ip, entry);
+    if (entry.count <= ADMIN_METRICS_AUTH_RATE_LIMIT_PER_MINUTE) return true;
+    rateLimitDenied.adminMetricsAuth++;
+    return false;
+}
+
+export function startRateLimitCleanup(io) {
+    if (authCleanupId !== null || rateLimitCleanupId !== null) return; // guard double-start
+    // Clean up old auth failure records (every 15 minutes)
+    authCleanupId = setInterval(() => {
+        const now = Date.now();
+        for (const [key, record] of failedAuthAttempts.entries()) {
+            if (now - record.lastAttempt > 15 * 60 * 1000) {
+                failedAuthAttempts.delete(key);
+            }
+        }
+    }, 15 * 60 * 1000);
+
+    // Clean up rate-limit maps to prevent memory leaks (every 60 seconds)
+    rateLimitCleanupId = setInterval(() => {
+        const now = Date.now();
+        for (const [ip, entry] of connectionCounts.entries()) {
+            if (now > entry.resetTime) connectionCounts.delete(ip);
+        }
+        for (const [socketId, entry] of eventCounts.entries()) {
+            if (now > entry.resetTime || !io.sockets.sockets.has(socketId)) {
+                eventCounts.delete(socketId);
+            }
+        }
+        for (const [ip, entry] of healthCounts.entries()) {
+            if (now > entry.resetTime) healthCounts.delete(ip);
+        }
+        for (const [ip, entry] of adminMetricsAuthCounts.entries()) {
+            if (now > entry.resetTime) adminMetricsAuthCounts.delete(ip);
+        }
+        for (const [socketId] of roomListCooldowns.entries()) {
+            if (!io.sockets.sockets.has(socketId)) roomListCooldowns.delete(socketId);
+        }
+    }, 60000);
+}
+
+export function stopRateLimitCleanup() {
+    if (authCleanupId) { clearInterval(authCleanupId); authCleanupId = null; }
+    if (rateLimitCleanupId) { clearInterval(rateLimitCleanupId); rateLimitCleanupId = null; }
+}
+
+export function clearRateLimitMaps() {
+    connectionCounts.clear();
+    failedAuthAttempts.clear();
+    eventCounts.clear();
+    healthCounts.clear();
+    adminMetricsAuthCounts.clear();
+    roomListCooldowns.clear();
+}
@@ -4,7 +4,7 @@ This directory contains constants and protocol definitions used by both the exte

 ## Syncing with the Extension
 > [!IMPORTANT]
-> Every time this directory is modified, you must run `node scripts/build-extension.js` to keep the extension's copy up to date.
+> Every time this directory is modified, you must run `node scripts/build-extension.cjs` to keep the extension's copy up to date.

 Because Browser Extensions (Manifest V3) cannot load files outside their root directory, all files in this directory must be copied to `extension/shared/` whenever they are modified. The build script handles this automatically.

@@ -2,7 +2,7 @@
 * blacklist.js
 * 
 * ⚠️ WARNING: This is the SINGLE SOURCE OF TRUTH.
- * If you edit this file, you MUST run: node scripts/build-extension.js
+ * If you edit this file, you MUST run: node scripts/build-extension.cjs
 * to propagate changes to the extension and relay server.
 * 
 * Domains to be filtered out from the tab selection dropdown to reduce "noise".
@@ -2,12 +2,12 @@
 * KoalaSync Shared Constants & Protocol Definitions
 * 
 * ⚠️ WARNING: This is the SINGLE SOURCE OF TRUTH.
- * If you edit this file, you MUST run: node scripts/build-extension.js
+ * If you edit this file, you MUST run: node scripts/build-extension.cjs
 * to propagate changes to the extension and relay server.
 */

 export const PROTOCOL_VERSION = "1.0.0";
-export const APP_VERSION = "1.9.0";
+export const APP_VERSION = "2.4.1";

 export const OFFICIAL_SERVER_URL = 'wss://syncserver.koalastuff.net';
 export const OFFICIAL_LANDING_PAGE_URL = 'https://sync.koalastuff.net';
@@ -51,7 +51,11 @@ export const EVENTS = {
    // Episode Auto-Sync
    EPISODE_LOBBY: "episode_lobby",     // Broadcast: waiting for everyone on this episode
    EPISODE_READY: "episode_ready",      // Response: loaded the episode and paused at 0:00
-    EPISODE_LOBBY_CANCEL: "episode_lobby_cancel" // Broadcast: cancel active lobby and resume
+    EPISODE_LOBBY_CANCEL: "episode_lobby_cancel", // Broadcast: cancel active lobby and resume
+
+    // Ping / Latency
+    PING: "ping",  // { t: timestamp, target?: peerId } — empty target = server echo
+    PONG: "pong"   // server responds with same { t } for client RTT calculation
 };

 export const HEARTBEAT_INTERVAL = 15000; // 15s
@@ -2,7 +2,7 @@
 * KoalaSync Shared Name Generation & Emoji Mapping
 *
 * ⚠️ WARNING: This is the SINGLE SOURCE OF TRUTH.
- * If you edit this file, you MUST run: node scripts/build-extension.js
+ * If you edit this file, you MUST run: node scripts/build-extension.cjs
 * to propagate changes to the extension.
 *
 * The emoji map covers every animal/creature that has a Unicode emoji.
@@ -21,7 +21,7 @@ export const USERNAME_ADJECTIVES = [
    'Cosmic', 'Neon', 'Shadow', 'Crystal', 'Thunder', 'Silent', 'Golden',
    'Fierce', 'Noble', 'Mystic', 'Frozen', 'Blazing', 'Sapphire', 'Iron', 'Crimson',
    'Turbo', 'Zen', 'Pixel', 'Cyber', 'Solar', 'Lunar', 'Astro', 'Hyper',
-    'Steel', 'Rogue', 'Alpha', 'Omega', 'Royal', 'Pixel', 'Warp', 'Frost',
+    'Steel', 'Rogue', 'Alpha', 'Omega', 'Royal', 'Nitro', 'Warp', 'Frost',
 ];

 export const USERNAME_NOUNS = [
@@ -39,7 +39,7 @@ export const USERNAME_NOUNS = [
    'Mouse', 'Pig', 'Boar', 'Polar', 'Orangutan', 'Mammoth',
    'Crow', 'Duck', 'Swan', 'Penguin', 'Parrot', 'Peacock',
    'Dove', 'Dodo', 'Turkey', 'Flamingo', 'Chicken', 'Rooster', 'Goose',
-    'Dolphin', 'Whale', 'Crab', 'Lobster', 'Octopus', 'Squid',
+    'Dolphin', 'Whale', 'Crab', 'Lobster', 'Octopus', 'Opossum', 'Squid',
    'Jellyfish', 'Turtle',
    'Crocodile', 'Lizard', 'Snake', 'Frog', 'Toad', 'Gecko',
    'Bee', 'Ant', 'Spider', 'Scorpion', 'Butterfly', 'Ladybug',
@@ -102,7 +102,7 @@ export const ANIMAL_EMOJI_MAP = {
    'mammoth': '🦣',
    'meerkat': '🦦',
    'octopus': '🐙',
-    'opposum': '🐭',
+    'opossum': '🐭',
    'ostrich': '🐦',
    'panther': '🐆',
    'pelican': '🦩',
@@ -5,7 +5,7 @@ This directory contains the KoalaSync website. It serves a dual purpose: it is b
 ## Core Roles

 ### 1. Marketing & Onboarding
-Provides a premium, multi-language (EN/DE/FR/ES/PT-BR/RU) overview of features, setup instructions, and direct links to the extension stores.
+Provides a premium, multi-language (EN/DE/FR/ES/PT-BR/RU/IT/PL/TR/NL/JA/KO/PT) overview of features, setup instructions, and direct links to the extension stores.

 ### 2. The Invitation Bridge (`join.html`)
 The website handles incoming invitation links. When a user clicks a link like `sync.koalastuff.net/join.html#join:roomID:pass`, the website:
@@ -16,8 +16,8 @@ The website handles incoming invitation links. When a user clicks a link like `s
 ## Architecture

 The website is 100% **Static HTML, CSS, and JS**. 
- **Static i18n Compiler**: The site uses a lightweight, zero-dependency Node.js compiler (`build.js`) to parse dictionary files inside `/locales/` against a single source-of-truth template (`template.html`), outputting the fully deployable static folder to `/www/`.
- **Build-time Minification**: `build.js` automatically minifies CSS and JS during compilation using a built-in state-machine tokenizer (no npm dependencies). Source files are written unminified (`style.css`, `app.js`, `lang-init.js`) — always edit source files, never the generated `.min.*` files in `www/`.
+- **Static i18n Compiler**: The site uses a lightweight, zero-dependency Node.js compiler (`build.cjs`) to parse dictionary files inside `/locales/` against a single source-of-truth template (`template.html`), outputting the fully deployable static folder to `/www/`.
+- **Build-time Minification**: `build.cjs` automatically minifies CSS and JS during compilation using a built-in state-machine tokenizer (no npm dependencies). Source files are written unminified (`style.css`, `app.js`, `lang-init.js`) — always edit source files, never the generated `.min.*` files in `www/`.
 - **Zero Backend**: No Node.js, PHP, or databases are required to host the compiled website.
 - **Zero Tracking**: All assets (fonts, icons) are self-hosted to prevent third-party tracking.
 - **Responsive**: Fully optimized for mobile with a native-feel hamburger menu.
@@ -62,7 +62,7 @@ sync.koalastuff.net {

 1. Run the compilation script from the repository root to generate the `/website/www` folder:
   ```bash
-   node website/build.js
+   node website/build.cjs
   ```
 2. Serve the compiled `/www` directory using any local development server:
   ```bash
@@ -71,4 +71,4 @@ sync.koalastuff.net {
 3. To test the invitation flow locally, navigate to `http://localhost:5000/join.html#join:test-room:test-pass`.

 > [!IMPORTANT]
-> **Never edit files inside `website/www/` directly.** This directory is fully auto-generated by `build.js`. Always edit source files (`template.html`, `style.css`, `app.js`, `lang-init.js`, locale files in `locales/`) and re-run `node website/build.js` to apply changes. CSS and JS are output as `style.min.css`, `app.min.js`, and `lang-init.min.js` — the `.min.*` naming makes it visually obvious these are build artifacts. Editing minified files in `www/` will result in lost changes on the next build.
+> **Never edit files inside `website/www/` directly.** This directory is fully auto-generated by `build.cjs`. Always edit source files (`template.html`, `style.css`, `app.js`, `lang-init.js`, locale files in `locales/`) and re-run `node website/build.cjs` to apply changes. CSS and JS are output as `style.min.css`, `app.min.js`, and `lang-init.min.js` — the `.min.*` naming makes it visually obvious these are build artifacts. Editing minified files in `www/` will result in lost changes on the next build.
@@ -1,194 +0,0 @@
-# KoalaSync Translation & Localization Guide
-
-Welcome to the **KoalaSync** translation and internationalization framework! This document provides clear, professional instructions for developers and contributors looking to maintain, audit, or add new languages to the official KoalaSync website.
-
---
-
-## 🏛️ Architecture Overview
-
-The KoalaSync website utilizes a custom, high-performance, zero-dependency static site generator built in Node.js. Instead of using complex client-side translation runtimes or bulky frameworks, localized pages are compiled ahead-of-time (AOT) to maintain lightning-fast page speeds and strict data sovereignty.
-
-*   **Template Source:** [`website/template.html`](file:///Users/koala/Documents/KoalaPlay/website/template.html) (Single Source of Truth)
-*   **Locales Source:** `/website/locales/[lang].json` (Structured JSON translation dictionaries)
-*   **Build Pipeline:** [`website/build.js`](file:///Users/koala/Documents/KoalaPlay/website/build.js) (Pure Node.js script that compiles pages into `/website/www/`)
-
---
-
-## 📊 Supported Languages Dashboard
-
-We divide supported languages into two tiers: **Core Languages** (fully hand-crafted and audited by native speakers) and **Extended Languages** (auto-generated using translation models to expand initial coverage).
-
-> [!TIP]
-> **Help Us Improve!**
-> We welcome community contributions to audit "Auto-Generated" translations and elevate them to "Verified" status.
-
-| Language Code | Language Name | Verification Status | Rationale / Context |
-| :--- | :--- | :--- | :--- |
-| `en` | 🇬🇧 **English** | `100% Manually Verified` | Primary developer language and system default |
-| `de` | 🇩🇪 **German** | `100% Manually Verified` | Core market and compliance baseline |
-| `fr` | 🇫🇷 **French** | `Auto-Generated` | Needs manual native review and polishing |
-| `es` | 🇪🇸 **Spanish** | `Auto-Generated` | Needs manual native review and polishing |
-| `pt-BR` | 🇧🇷 **Portuguese (Brasil)** | `Auto-Generated` | Needs manual native review and polishing |
-| `ru` | 🇷🇺 **Russian** | `Auto-Generated` | Needs manual native review and polishing |
-| `it` | 🇮🇹 **Italian** | `Auto-Generated` | Needs manual native review and polishing |
-| `pl` | 🇵🇱 **Polish** | `Auto-Generated` | Needs manual native review and polishing |
-| `tr` | 🇹🇷 **Turkish** | `Auto-Generated` | Needs manual native review and polishing |
-| `nl` | 🇳🇱 **Dutch** | `Auto-Generated` | Needs manual native review and polishing |
-| `ja` | 🇯🇵 **Japanese** | `Auto-Generated` | Needs manual native review and polishing |
-| `ko` | 🇰🇷 **Korean** | `Auto-Generated` | Needs manual native review and polishing |
-| `pt` | 🇵🇹 **European Portuguese** | `Auto-Generated` | Needs manual native review and polishing |
-
-> [!WARNING]
-> **Autogeneration Quality Rule**
-> Any newly contributed languages must be committed as `"Auto-Generated"` until fully reviewed and signed off by a native speaker in a pull request.
-
---
-
-## ⚖️ Strict Legal Exclusion Rule
-
-Our legal pages have strict constraints to protect user privacy and avoid regulatory liabilities.
-
-> [!IMPORTANT]
-> **DO NOT TRANSLATE LEGAL DOCUMENTS**
-> The legal notice ([impressum.html](file:///Users/koala/Documents/KoalaPlay/website/impressum.html)) and privacy policy ([datenschutz.html](file:///Users/koala/Documents/KoalaPlay/website/datenschutz.html)) **MUST remain exclusively in English and German**.
-> 
-> *   **Rationale:** Legal compliance under the European Union General Data Protection Regulation (GDPR) and the German Digital Services Act (DDG). Offering automated translations of legally binding notices introduces compliance risks due to potential mistranslations of liability limits.
-> *   **Technical Fallback:** The dynamic initializer script (`lang-init.js`) is configured to automatically fallback to **English** for legal pages if a user visits them with a French, Spanish, or other unsupported language preference, keeping their dynamic dropdown choice intact for homepage links.
-
---
-
-## 🛠️ Step-by-Step: Adding a New Language
-
-Adding a new language (e.g., Italian - `it`) is straightforward. Follow these four structured steps:
-
-### Step 1: Create the Translation Dictionary
-Create a new JSON file inside the locales directory named `[lang].json` (e.g., `website/locales/it.json`).
-1. Copy the structure of [`website/locales/en.json`](file:///Users/koala/Documents/KoalaPlay/website/locales/en.json) to use as your baseline.
-2. Translate all string values while keeping the JSON keys identical.
-3. Configure the language metadata keys at the top of the file:
-   ```json
-   {
-     "LANG_CODE": "it",
-     "HTML_CLASS": "lang-it",
-     "CANONICAL_PATH": "it/",
-     "LANG_TOGGLE_URL": "../",
-     "LANG_TOGGLE_TEXT": "EN"
-   }
-   ```
-
-### Step 2: Register in the Compiler
-Open the static site generator script [`website/build.js`](file:///Users/koala/Documents/KoalaPlay/website/build.js) and append your new language code to the active `languages` array:
-```javascript
-// Add 'it' to the array
-const languages = ['en', 'de', 'fr', 'es', 'pt-BR', 'ru', 'it'];
-```
-
-### Step 3: Run the Build Script
-Execute the compiler from the root of the repository:
-```bash
-node website/build.js
-```
-The compiler will automatically:
-1. Load the new JSON translation file.
-2. Create the target subdirectory `/website/www/it/`.
-3. Generate the compiled `/website/www/it/index.html` landing page, injecting correct relative assets and canonical metadata.
-
-### Step 4: Update the Dashboard
-Open this `TRANSLATION.md` file and add your language to the **Supported Languages Dashboard** table, marking it as `Auto-Generated` (unless manually verified).
-
---
-
-## 🔮 Future Roadmap: Dynamic Utility Pages
-
-For pages that require fully dynamic, client-side interactions (like the room invitation bridge [`join.html`](file:///Users/koala/Documents/KoalaPlay/website/join.html)), we need to scale to unlimited languages without bloating the HTML size or polluting the URL.
-
-### Clean Client-Side i18n Architecture
-
-To maintain zero URL pollution (e.g. keeping invitation links clean as `/join.html#join:roomID:password`), we propose an **asynchronous JSON dictionary injection architecture**:
-
-#### 1. Page Lifecycle Flow
-1. **User Landing:** The guest enters `/join.html` with a shared hash.
-2. **Language Resolution:** `lang-init.js` immediately reads their saved preference (`localStorage` or `navigator.language`) and applies the active class (e.g. `html.lang = "es"`).
-3. **Async Fetching:** A client-side loader script (`i18n-client.js`) runs asynchronously, downloading the correct dictionary (`fetch("/locales/es.json")`).
-4. **DOM Translation:** The script scans the page for elements carrying a `data-i18n` attribute and safely updates their text content at runtime, avoiding dual-text nodes and stylesheet recalculations.
-
-#### 2. Declarative HTML Markup
-Elements are defined with custom data attributes specifying translation keys. English text is placed as the static HTML fallback:
-```html
-<h1 data-i18n="JOIN_TITLE">Ready to sync?</h1>
-<p id="join-desc" data-i18n="JOIN_SUBTITLE">You've been invited to join a session.</p>
-```
-
-#### 3. Zero-Dependency Engine (`i18n-client.js`)
-```javascript
-document.addEventListener('DOMContentLoaded', async () => {
-    // 1. Recover the language determined during early initialization
-    const activeLang = document.documentElement.lang || 'en';
-    if (activeLang === 'en') return; // Default markup is already in English
-    
-    // 2. Fetch the corresponding locale JSON asynchronously
-    try {
-        const response = await fetch(`locales/${activeLang}.json`);
-        if (!response.ok) throw new Error('Locale file unavailable');
-        const dictionary = await response.json();
-        
-        // 3. Scan and translate data-i18n attributes
-        document.querySelectorAll('[data-i18n]').forEach(el => {
-            const key = el.getAttribute('data-i18n');
-            if (dictionary[key]) {
-                if (el.tagName === 'IMG') {
-                    el.alt = dictionary[key];
-                } else {
-                    el.textContent = dictionary[key];
-                }
-            }
-        });
-    } catch (err) {
-        console.warn('Dynamic i18n loading failed. Defaulting to English:', err);
-    }
-});
-```
-
-#### Core Benefits
-*   **Zero URL Pollution:** Keeps invitation hashes private and avoids messy query parameters (`?lang=de`), protecting user privacy.
-*   **Optimal Performance:** Eliminates duplicate hidden text blocks, cutting page weight in half and ensuring smooth rendering.
-*   **Infinite Scale:** Adding new languages to dynamic pages requires zero edits to HTML markup; the engine simply fetches new JSON dictionaries on-demand.
-
---
-
-## 🔌 Extension Internationalization (i18n)
-
-In **v2.0**, we extended full internationalization support to the **Browser Extension itself**. The architecture mirrors our web-based dynamic localization model to maintain complete parity.
-
-*   **Locales Directory:** [`extension/locales/`](file:///Users/koala/Documents/KoalaPlay/extension/locales/)
-*   **Active Dictionaries:**
-    *   [`en.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/en.json) (🇬🇧 Baseline English)
-    *   [`de.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/de.json) (🇩🇪 German)
-    *   [`fr.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/fr.json) (🇫🇷 French)
-    *   [`es.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/es.json) (🇪🇸 Spanish)
-    *   [`pt-BR.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/pt-BR.json) (🇧🇷 Portuguese (Brasil))
-    *   [`ru.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/ru.json) (🇷🇺 Russian)
-    *   [`it.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/it.json) (🇮🇹 Italian)
-    *   [`pl.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/pl.json) (🇵🇱 Polish)
-    *   [`tr.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/tr.json) (🇹🇷 Turkish)
-    *   [`nl.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/nl.json) (🇳🇱 Dutch)
-    *   [`ja.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/ja.json) (🇯🇵 Japanese)
-    *   [`ko.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/ko.json) (🇰🇷 Korean)
-    *   [`pt.json`](file:///Users/koala/Documents/KoalaPlay/extension/locales/pt.json) (🇵🇹 European Portuguese)
-*   **Translation Engine:** [`extension/i18n.js`](file:///Users/koala/Documents/KoalaPlay/extension/i18n.js)
-*   **Validation Script:** [`scripts/test-locales.js`](file:///Users/koala/Documents/KoalaPlay/scripts/test-locales.js)
-
-### ⚙️ How it Works inside the Extension
-
-1. **System Locale Auto-Detection**: On first run, the extension detects the browser system language using `navigator.language` or `chrome.i18n.getUILanguage()`.
-2. **On-the-Fly Redraws**: When the user selects a different language in the settings tab (`#langSelector`), the selection is stored in `chrome.storage.sync` and the translation engine immediately triggers `translateDOM()`. The interface, empty state cards, tooltips, dynamic onboarding tutorial guides, and status badges re-render instantly without reloading the popup.
-3. **Localized System Notifications**: On play, pause, or seek commands, `background.js` retrieves the user's active locale preference from storage, loads the correct dictionary, and pushes native OS notifications fully translated.
-
-### 🧪 Auditing & Sync Checks
-
-To ensure that no language dictionary falls out of sync (causing missing labels or blank interfaces), developers must run the locale auditor tool before packaging releases:
-```bash
-node scripts/test-locales.js
-```
-This script asserts that all JSON dictionary files under `extension/locales/` share exactly the same set of keys as the English baseline (`en.json`).
-
@@ -19,20 +19,39 @@ document.addEventListener('DOMContentLoaded', () => {

    // Scroll Reveal Logic (IntersectionObserver for performance)
    const revealElements = document.querySelectorAll('[data-reveal]');
-    
-    const revealObserver = new IntersectionObserver((entries) => {
-        entries.forEach(entry => {
-            if (entry.isIntersecting) {
-                entry.target.classList.add('revealed');
-                revealObserver.unobserve(entry.target);
-            }
-        });
-    }, {
-        rootMargin: '0px 0px -150px 0px',
-        threshold: 0.1
-    });

-    revealElements.forEach(el => revealObserver.observe(el));
+    if ('IntersectionObserver' in window) {
+        const revealObserver = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                if (entry.isIntersecting) {
+                    entry.target.classList.add('revealed');
+                    revealObserver.unobserve(entry.target);
+                }
+            });
+        }, {
+            rootMargin: '0px 0px -150px 0px',
+            threshold: 0.1
+        });
+
+        revealElements.forEach(el => revealObserver.observe(el));
+    } else {
+        // Fallback: without IntersectionObserver support, reveal everything
+        // immediately so no content can ever stay hidden.
+        revealElements.forEach(el => el.classList.add('revealed'));
+    }
+
+    // Auto-update URL hash as user scrolls through sections
+    // (preserves position across language switches)
+    if ('IntersectionObserver' in window) {
+        const sectionObserver = new IntersectionObserver((entries) => {
+            entries.forEach(entry => {
+                if (entry.isIntersecting) {
+                    history.replaceState(null, null, '#' + entry.target.id);
+                }
+            });
+        }, { threshold: 0.3 });
+        document.querySelectorAll('section[id], header[id]').forEach(el => sectionObserver.observe(el));
+    }

    // Navbar scroll effect
    const nav = document.querySelector('nav');
@@ -46,20 +65,6 @@ document.addEventListener('DOMContentLoaded', () => {
        }
    });

-    // Smooth scroll for anchors
-    document.querySelectorAll('a[href^="#"]').forEach(anchor => {
-        anchor.addEventListener('click', function (e) {
-            e.preventDefault();
-            const target = document.querySelector(this.getAttribute('href'));
-            if (target) {
-                target.scrollIntoView({
-                    behavior: 'smooth',
-                    block: 'start'
-                });
-            }
-        });
-    });
-
    // Invite Detection & Bridge
    const checkInvite = () => {
        const isJoinPage = window.location.pathname.includes('join');
@@ -508,7 +513,7 @@ document.addEventListener('DOMContentLoaded', () => {
                target = hasHtml ? 'imprint.html' : 'imprint';
                if (path.includes('/de/')) target = hasHtml ? '../imprint.html' : '../imprint';
            }
-            window.location.href = target;
+            window.location.href = target + window.location.hash;
            return;
        } else if (isLegalPrivacy) {
            let target;
@@ -520,7 +525,7 @@ document.addEventListener('DOMContentLoaded', () => {
                target = hasHtml ? 'privacy.html' : 'privacy';
                if (path.includes('/de/')) target = hasHtml ? '../privacy.html' : '../privacy';
            }
-            window.location.href = target;
+            window.location.href = target + window.location.hash;
            return;
        }
        
@@ -549,7 +554,7 @@ document.addEventListener('DOMContentLoaded', () => {
                }
            }
            
-            window.location.href = targetPath;
+            window.location.href = targetPath + window.location.hash;
        } else {
            // Dynamic page: Toggle classes and update elements dynamically without navigating away
            const html = document.documentElement;
@@ -689,7 +694,7 @@ document.addEventListener('DOMContentLoaded', () => {
                    if (!isInstalled) {
                        btn.classList.add('install-breathe');
                        btn.style.cursor = 'pointer';
-                        btn.onclick = () => window.open('https://addons.mozilla.org/de/firefox/addon/koalasync/', '_blank');
+                        btn.onclick = () => window.open('https://addons.mozilla.org/de/firefox/addon/koalasync/', '_blank', 'noopener');
                    }
                });
                illusChrome.forEach(btn => {
@@ -702,7 +707,7 @@ document.addEventListener('DOMContentLoaded', () => {
                    if (!isInstalled) {
                        btn.classList.add('install-breathe');
                        btn.style.cursor = 'pointer';
-                        btn.onclick = () => window.open('https://chromewebstore.google.com/detail/koalasync/obbnmkmlaaddodakcbdljknjpagklifc', '_blank');
+                        btn.onclick = () => window.open('https://chromewebstore.google.com/detail/koalasync/obbnmkmlaaddodakcbdljknjpagklifc', '_blank', 'noopener');
                    }
                });
                illusFirefox.forEach(btn => {
@@ -241,6 +241,14 @@ async function compile() {
        console.log('  Assets copied.');
    }

+    // Copy apple-touch-icon to www root (browsers/iOS request these at /)
+    const appleTouchSrc = path.join(destAssets, 'apple-touch-icon.png');
+    if (fs.existsSync(appleTouchSrc)) {
+        fs.copyFileSync(appleTouchSrc, path.join(wwwDir, 'apple-touch-icon.png'));
+        fs.copyFileSync(appleTouchSrc, path.join(wwwDir, 'apple-touch-icon-precomposed.png'));
+        console.log('  ✓ Apple touch icons copied to www root.');
+    }
+
    // ── 7. Convert all WebP to AVIF (quality 70) ──
    console.log('Converting WebP → AVIF...');
    let avifCount = 0;
@@ -7,7 +7,7 @@
    <link rel="preload" href="../style.min.css" as="style">
    <link rel="stylesheet" href="../style.min.css">
    <link rel="icon" type="image/webp" href="../assets/NewLogoIcon_64.webp">
-    <meta name="robots" content="noindex">
+    <meta name="robots" content="index, follow">

    <script type="application/ld+json">
    {
@@ -45,7 +45,7 @@
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="width: 16px; height: 16px; display: block;"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>
                    <span>Startseite</span>
                </a>
-                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" style="display: inline-flex; align-items: center; gap: 6px;">
+                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" rel="noopener" style="display: inline-flex; align-items: center; gap: 6px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="16" height="16" aria-hidden="true" style="display: block;"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
                    GitHub
                </a>
@@ -97,7 +97,7 @@
                    KoalaSync verzichtet bewusst auf Analyse-Tools, Tracking-Cookies oder Werbenetzwerke. Wir laden keine Ressourcen von Drittanbietern (wie Google Fonts) nach, um Ihre Privatsphäre maximal zu schützen.
                </p>
                <p style="margin-top: 0.5rem;">
-                    Da KoalaSync vollständig Open Source ist, kann zudem jede Zeile Code auf unserem <a href="https://github.com/shik3i/KoalaSync" target="_blank" style="color: var(--accent);">GitHub-Repository</a> öffentlich eingesehen und auf Sicherheit geprüft werden.
+                    Da KoalaSync vollständig Open Source ist, kann zudem jede Zeile Code auf unserem <a href="https://github.com/shik3i/KoalaSync" target="_blank" rel="noopener" style="color: var(--accent);">GitHub-Repository</a> öffentlich eingesehen und auf Sicherheit geprüft werden.
                </p>
            </section>

@@ -155,7 +155,7 @@
            <div style="margin-top: 1.5rem; font-size: 0.8rem; display: flex; justify-content: center; align-items: center; gap: 1.5rem; flex-wrap: wrap;">
                <a href="impressum" style="color: var(--text-muted); text-decoration: none;">Impressum</a>
                <a href="datenschutz" style="color: var(--text-muted); text-decoration: none;">Datenschutz</a>
-                <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
+                <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="14" height="14" aria-hidden="true" style="display: block;"><path d="M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z"/></svg>
                    Mastodon
                </a>
@@ -7,7 +7,7 @@
    <link rel="preload" href="../style.min.css" as="style">
    <link rel="stylesheet" href="../style.min.css">
    <link rel="icon" type="image/webp" href="../assets/NewLogoIcon_64.webp">
-    <meta name="robots" content="noindex">
+    <meta name="robots" content="index, follow">

    <script type="application/ld+json">
    {
@@ -45,7 +45,7 @@
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="width: 16px; height: 16px; display: block;"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>
                    <span>Startseite</span>
                </a>
-                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" style="display: inline-flex; align-items: center; gap: 6px;">
+                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" rel="noopener" style="display: inline-flex; align-items: center; gap: 6px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="16" height="16" aria-hidden="true" style="display: block;"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
                    GitHub
                </a>
@@ -92,11 +92,11 @@
                </p>
                <p style="margin-top: 0.75rem;">
                    <span style="opacity: 0.6;">🔒 Private Nachricht:</span>
-                    <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--accent); text-decoration: none;">@koalastuff auf Mastodon</a>
+                    <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--accent); text-decoration: none;">@koalastuff auf Mastodon</a>
                </p>
                <p style="margin-top: 0.5rem;">
                    <span style="opacity: 0.6;">🐛 Active Bedenken / Bug Reports:</span>
-                    <a href="https://github.com/Shik3i/KoalaSync/issues" target="_blank" style="color: var(--accent); text-decoration: none;">GitHub Issues</a>
+                    <a href="https://github.com/Shik3i/KoalaSync/issues" target="_blank" rel="noopener" style="color: var(--accent); text-decoration: none;">GitHub Issues</a>
                </p>
            </section>

@@ -142,7 +142,7 @@
            <div style="margin-top: 1.5rem; font-size: 0.8rem; display: flex; justify-content: center; align-items: center; gap: 1.5rem; flex-wrap: wrap;">
                <a href="impressum" style="color: var(--text-muted); text-decoration: none;">Impressum</a>
                <a href="datenschutz" style="color: var(--text-muted); text-decoration: none;">Datenschutz</a>
-                <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
+                <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="14" height="14" aria-hidden="true" style="display: block;"><path d="M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z"/></svg>
                    Mastodon
                </a>
@@ -7,7 +7,7 @@
    <link rel="preload" href="style.min.css" as="style">
    <link rel="stylesheet" href="style.min.css">
    <link rel="icon" type="image/webp" href="assets/NewLogoIcon_64.webp">
-    <meta name="robots" content="noindex">
+    <meta name="robots" content="index, follow">

    <script type="application/ld+json">
    {
@@ -45,7 +45,7 @@
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="width: 16px; height: 16px; display: block;"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>
                    <span>Home</span>
                </a>
-                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" style="display: inline-flex; align-items: center; gap: 6px;">
+                <a href="https://github.com/Shik3i/KoalaSync" target="_blank" rel="noopener" style="display: inline-flex; align-items: center; gap: 6px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="16" height="16" aria-hidden="true" style="display: block;"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
                    GitHub
                </a>
@@ -92,11 +92,11 @@
                </p>
                <p style="margin-top: 0.75rem;">
                    <span style="opacity: 0.6;">🔒 Private message:</span>
-                    <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--accent); text-decoration: none;">@koalastuff on Mastodon</a>
+                    <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--accent); text-decoration: none;">@koalastuff on Mastodon</a>
                </p>
                <p style="margin-top: 0.5rem;">
                    <span style="opacity: 0.6;">🐛 Active concerns / Bug reports:</span>
-                    <a href="https://github.com/Shik3i/KoalaSync/issues" target="_blank" style="color: var(--accent); text-decoration: none;">GitHub Issues</a>
+                    <a href="https://github.com/Shik3i/KoalaSync/issues" target="_blank" rel="noopener" style="color: var(--accent); text-decoration: none;">GitHub Issues</a>
                </p>
            </section>

@@ -140,7 +140,7 @@
            <div style="margin-top: 1.5rem; font-size: 0.8rem; display: flex; justify-content: center; align-items: center; gap: 1.5rem; flex-wrap: wrap;">
                <a href="imprint" style="color: var(--text-muted); text-decoration: none;">Legal Notice</a>
                <a href="privacy" style="color: var(--text-muted); text-decoration: none;">Privacy Policy</a>
-                <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
+                <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="14" height="14" aria-hidden="true" style="display: block;"><path d="M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z"/></svg>
                    Mastodon
                </a>
@@ -49,7 +49,7 @@
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true" style="width: 16px; height: 16px; display: block;"><path d="m3 9 9-7 9 7v11a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2z"></path><polyline points="9 22 9 12 15 12 15 22"></polyline></svg>
                    <span lang="de">Startseite</span><span lang="en">Home</span>
                </a>
-                <a href="https://github.com/shik3i/KoalaSync" target="_blank" style="display: inline-flex; align-items: center; gap: 6px;">
+                <a href="https://github.com/shik3i/KoalaSync" target="_blank" rel="noopener" style="display: inline-flex; align-items: center; gap: 6px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="16" height="16" aria-hidden="true" style="display: block;"><path d="M12 0c-6.626 0-12 5.373-12 12 0 5.302 3.438 9.8 8.207 11.387.599.111.793-.261.793-.577v-2.234c-3.338.726-4.033-1.416-4.033-1.416-.546-1.387-1.333-1.756-1.333-1.756-1.089-.745.083-.729.083-.729 1.205.084 1.839 1.237 1.839 1.237 1.07 1.834 2.807 1.304 3.492.997.107-.775.418-1.305.762-1.604-2.665-.305-5.467-1.334-5.467-5.931 0-1.311.469-2.381 1.236-3.221-.124-.303-.535-1.524.117-3.176 0 0 1.008-.322 3.301 1.23.957-.266 1.983-.399 3.003-.404 1.02.005 2.047.138 3.006.404 2.291-1.552 3.297-1.23 3.297-1.23.653 1.653.242 2.874.118 3.176.77.84 1.235 1.911 1.235 3.221 0 4.609-2.807 5.624-5.479 5.921.43.372.823 1.102.823 2.222v3.293c0 .319.192.694.801.576 4.765-1.589 8.199-6.086 8.199-11.386 0-6.627-5.373-12-12-12z"/></svg>
                    GitHub
                </a>
@@ -119,7 +119,7 @@
            <div style="margin-top: 1.5rem; font-size: 0.8rem; display: flex; justify-content: center; align-items: center; gap: 1.5rem; flex-wrap: wrap;">
                <a href="impressum" style="color: var(--text-muted); text-decoration: none;"><span lang="en">Legal Notice</span><span lang="de">Impressum</span></a>
                <a href="datenschutz" style="color: var(--text-muted); text-decoration: none;"><span lang="en">Privacy Policy</span><span lang="de">Datenschutz</span></a>
-                <a href="https://mastodon.social/@koalastuff" rel="me" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
+                <a href="https://mastodon.social/@koalastuff" rel="me noopener" target="_blank" style="color: var(--text-muted); text-decoration: none; display: inline-flex; align-items: center; gap: 4px;">
                    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="currentColor" width="14" height="14" aria-hidden="true" style="display: block;"><path d="M23.268 5.313c-.35-2.578-2.617-4.61-5.304-5.004C17.51.242 15.792 0 11.813 0h-.03c-3.98 0-4.835.242-5.288.309C3.882.692 1.496 2.518.917 5.127.64 6.412.61 7.837.661 9.143c.074 1.874.088 3.745.26 5.611.118 1.24.325 2.47.62 3.68.55 2.237 2.777 4.098 4.96 4.857 2.336.792 4.849.923 7.256.38.265-.061.527-.132.786-.213.585-.184 1.27-.39 1.774-.753a.057.057 0 0 0 .023-.043v-1.809a.052.052 0 0 0-.02-.041.053.053 0 0 0-.046-.01 20.282 20.282 0 0 1-4.709.545c-2.73 0-3.463-1.284-3.674-1.818a5.593 5.593 0 0 1-.319-1.433.053.053 0 0 1 .066-.054c1.517.363 3.072.546 4.632.546.376 0 .75 0 1.125-.01 1.57-.044 3.224-.124 4.768-.422.038-.008.077-.015.11-.024 2.435-.464 4.753-1.92 4.989-5.604.008-.145.03-1.52.03-1.67.002-.512.167-3.63-.024-5.545zm-3.748 9.195h-2.561V8.29c0-1.309-.55-1.976-1.67-1.976-1.23 0-1.846.79-1.846 2.35v3.403h-2.546V8.663c0-1.56-.617-2.35-1.848-2.35-1.112 0-1.668.668-1.67 1.977v6.218H4.822V8.102c0-1.31.337-2.35 1.011-3.12.696-.77 1.608-1.164 2.74-1.164 1.311 0 2.302.5 2.962 1.498l.638 1.06.638-1.06c.66-.999 1.65-1.498 2.96-1.498 1.13 0 2.043.395 2.74 1.164.675.77 1.012 1.81 1.012 3.12z"/></svg>
                    Mastodon
                </a>
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Schaue Netflix, Emby, Jellyfin, YouTube, Twitch und fast jedes HTML5-Video perfekt synchronisiert mit Freunden. Datenschutzfreundliche Browser-Erweiterung für Chrome und Firefox.",
  "NAV_FEATURES": "Funktionen",
  "NAV_HOW_IT_WORKS": "So funktioniert's",
-  "HERO_TITLE": "Gemeinsam schauen.<br>Perfekt synchron.",
+  "HERO_TITLE": "Gemeinsam schauen.<span class='hero-line2'>Perfekt synchron.</span>",
  "HERO_SUBTITLE": "Dein Kino-Abend auf Distanz. Keine Lags, keine Anmeldung. Einfach Link teilen und zusammen schauen.",
  "HERO_MASCOT_ALT": "Ein niedlicher Koala steht da und schaut nach unten auf die Download-Buttons",
  "ADD_TO_CHROME": "Zu Chrome hinzufügen",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Keine Accounts / Datenschutz",
  "FEATURE_3_DESC": "Kein Login. Keine Daten. Einfach Link teilen und schauen. Der Server läuft flüchtig im RAM und löscht deinen Raum komplett nach dem Verlassen.",
  "FEATURE_4_TITLE": "Universeller HTML5-Support",
-  "FEATURE_4_DESC": "Unterstützt YouTube, Twitch, Netflix, Jellyfin, Emby und fast jede beliebige Webseite mit einem HTML5-Video-Tag. Ideal auch für eigene Medienbibliotheken.",
+  "FEATURE_4_DESC": "Unterstützt YouTube, Twitch, Netflix, Jellyfin, Emby und fast jede beliebige Webseite mit einem HTML5-Video-Tag. Ideal auch für eigene Medienbibliotheken. Es werden keinerlei Videodaten an unsere Server gesendet — nur Synchronisations-Metadaten.",
  "FEATURE_5_TITLE": "Self-Hostable & Docker-Ready",
  "FEATURE_5_DESC": "Unsere Server sind kostenlos und schnell, aber du kannst auch die volle Kontrolle übernehmen, wenn du willst. Starte dein eigenes privates Relay in Sekunden via Docker.",
  "FEATURE_6_TITLE": "Direkte Einladungen & 1-Klick Beitritt",
  "FEATURE_6_DESC": "Keine lästigen IPs oder Passwörter austauschen. Teile einfach einen Einladungslink mit deinen Freunden, um sie mit einem Klick in den Raum zu holen.",
+  "FEATURE_7_TITLE": "Lautstärke Angleichen / Audio Compressor",
+  "FEATURE_7_DESC": "Nie wieder am Lautstärkeregler spielen. Der eingebaute Audio Compressor verstärkt leise Dialoge und zähmt laute Explosionen. Funktioniert auf Netflix, Prime Video, Disney+, YouTube und jedem HTML5-Video. Komplett lokal — keine Audiodaten verlassen deinen Computer.",
+  "FEATURE_8_TITLE": "Open Source (MIT-Lizenz)",
+  "FEATURE_8_DESC": "Der gesamte Quellcode ist auf GitHub öffentlich einsehbar. Keine Black Boxes, keine proprietären Teile — 100 % Transparenz vom Relay-Server bis zur Browser-Erweiterung.",
  "COMP_TITLE": "KoalaSync vs. Teleparty",
  "COMP_SUBTITLE": "Erfahre, warum Open Source, Werbefreiheit und echter Datenschutz die bessere Wahl für gemeinsames Schauen sind.",
  "COMP_COL_FEATURE": "Funktion",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Verfügbare Oberflächensprachen und Übersetzungsunterstützung.",
  "COMP_FEAT_6_KOALA": "13 Sprachen (wachsend)",
  "COMP_FEAT_6_TELE": "Nur Englisch",
+  "COMP_FEAT_7_NAME": "Audio Compressor / Lautstärke Angleichen",
+  "COMP_FEAT_7_DESC": "Integrierte Audionormalisierung für leise Dialoge und laute Effekte",
+  "COMP_FEAT_7_KOALA": "Ja (4 Presets, Dry/Wet-Regelung)",
+  "COMP_FEAT_7_TELE": "Nein",
  "COMP_FOOTNOTE_1": "Stand des Vergleichs: Mai 2026.",
  "COMP_FOOTNOTE_2": "Details zu Preisen und unterstützten Netzwerken von Teleparty Premium:",
  "COMP_FOOTNOTE_3": "Datenschutzerklärung und Tracker-Erfassung von Teleparty:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Ja, jeder Teilnehmer braucht KoalaSync — aber ohne Anmeldung oder Kontoerstellung. Einfach auf den Einladungslink klicken, die Erweiterung installieren (falls nicht vorhanden) und du bist automatisch im Raum.",
  "FAQ_Q6": "Sind meine Daten sicher? Was, wenn ich dem offiziellen Server nicht traue?",
  "FAQ_A6": "Absolut sicher. Der KoalaSync Relay-Server läuft ausschließlich im RAM — alle Sitzungsdaten werden sofort gelöscht, sobald du den Raum verlässt. Keine Datenbank, keine Protokolle, keine Analysen, keine Benutzerkonten. Wenn du volle Kontrolle möchtest: hoste deinen eigenen privaten Relay-Server via Docker in wenigen Minuten. Der gesamte Quellcode ist Open Source und auf GitHub einsehbar.",
+  "FAQ_Q7": "Kann ich leise Dialoge und laute Explosionen beim Videoschauen im Browser ausgleichen?",
+  "FAQ_A7": "Ja. KoalaSync 2.2.0 enthält einen eingebauten Audio Compressor, der den Unterschied zwischen lauten und leisen Passagen reduziert. Er läuft lokal über die Web Audio API — keine Audiodaten verlassen deinen Computer. Öffne das Popup, erstelle einen Raum, gehe zu Einstellungen → Audio Processing, schalte den Compressor ein und wähle ein Preset. Funktioniert auf Netflix, Prime Video, Disney+, YouTube und allen HTML5-Video-Seiten.",
  "HOWTO_TITLE": "So synchronisierst du Videos mit Freunden mit KoalaSync",
  "HOWTO_DESC": "Schaue Videos perfekt synchron mit Freunden auf YouTube, Netflix, Twitch und mehr. Keine Anmeldung, kein Tracking.",
  "HOWTO_STEP_1_NAME": "Browser-Erweiterung installieren",
@@ -164,5 +174,6 @@
  "MOCK_32": "LÖSCHEN",
  "FOOTER_LEGAL_LINK": "de/impressum",
  "FOOTER_PRIVACY_LINK": "de/datenschutz",
+  "FOOTER_DISCLAIMER": "KoalaSync ist nicht mit Netflix, Disney+, Amazon, YouTube, Twitch oder anderen Streaming-Plattformen verbunden, wird von diesen nicht unterstützt oder steht in keiner Beziehung zu diesen. Alle Markenrechte liegen bei ihren jeweiligen Inhabern.",
  "FOOTER_SUPPORT": "Kauf mir einen Kaffee auf Ko-Fi"
 }
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Watch Netflix, Emby, Jellyfin, YouTube, Twitch and almost any HTML5 video in perfect sync with friends. Privacy-first, open-source browser extension for Chrome and Firefox.",
  "NAV_FEATURES": "Features",
  "NAV_HOW_IT_WORKS": "How it works",
-  "HERO_TITLE": "Watch Together.<br>Sync Perfectly.",
+  "HERO_TITLE": "Watch Together.<span class='hero-line2'>Sync Perfectly.</span>",
  "HERO_SUBTITLE": "Your remote movie night without lags. No registration, no data collection. Just share a link and watch together.",
  "HERO_MASCOT_ALT": "A cute koala standing and looking down at the download buttons",
  "ADD_TO_CHROME": "Add to Chrome",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Zero Accounts / Pure Privacy",
  "FEATURE_3_DESC": "No registration, no tracking, no persistency footprints. The server runs entirely in ephemeral RAM and purges your room when you leave.",
  "FEATURE_4_TITLE": "Universal HTML5 Support",
-  "FEATURE_4_DESC": "Works on YouTube, Twitch, Netflix, Jellyfin, Emby, and almost any standard webpage containing a HTML5 video element. Also compatible with custom self-hosted setups.",
+  "FEATURE_4_DESC": "Works on YouTube, Twitch, Netflix, Jellyfin, Emby, and almost any standard webpage containing a HTML5 video element. Also compatible with custom self-hosted setups. No video data is ever sent to our servers — only synchronization metadata.",
  "FEATURE_5_TITLE": "Self-Hostable & Docker-Ready",
  "FEATURE_5_DESC": "Our official servers are free and fast, but you can take full ownership if you want to. Launch your own private relay server in seconds via Docker.",
  "FEATURE_6_TITLE": "Instant Invites / 1-Click Join",
  "FEATURE_6_DESC": "No IP addresses or passwords to exchange. Share a generated invite link with your friends to let them join your room automatically with a single click.",
+  "FEATURE_7_TITLE": "Volume Leveling / Audio Compressor",
+  "FEATURE_7_DESC": "No more riding the volume knob. Built-in audio compressor boosts quiet dialogue and tames loud explosions. Works on Netflix, Prime Video, Disney+, YouTube, and any HTML5 video. Completely local — no audio data leaves your computer.",
+  "FEATURE_8_TITLE": "Open Source (MIT License)",
+  "FEATURE_8_DESC": "The entire codebase is publicly auditable on GitHub. No black boxes, no proprietary blobs — 100% transparency from the relay server to the browser extension.",
  "COMP_TITLE": "KoalaSync vs. Teleparty",
  "COMP_SUBTITLE": "See why open source, ad-free and privacy-first is the superior way to watch together.",
  "COMP_COL_FEATURE": "Feature",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Available interface languages and translation support.",
  "COMP_FEAT_6_KOALA": "13 Languages (and growing)",
  "COMP_FEAT_6_TELE": "English only",
+  "COMP_FEAT_7_NAME": "Audio Compressor / Volume Leveling",
+  "COMP_FEAT_7_DESC": "Built-in audio normalization to balance quiet dialogue and loud effects",
+  "COMP_FEAT_7_KOALA": "Yes (4 presets, dry/wet control)",
+  "COMP_FEAT_7_TELE": "No",
  "COMP_FOOTNOTE_1": "Comparison state: May 2026.",
  "COMP_FOOTNOTE_2": "Official Teleparty Premium pricing and supported networks details:",
  "COMP_FOOTNOTE_3": "Teleparty privacy policies and tracking data collection:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Yes, each participant needs KoalaSync installed — but there's no sign-up or account creation. Simply click the invitation link, install the extension if you haven't already, and you'll join the room automatically in seconds.",
  "FAQ_Q6": "Is my data safe? What if I don't trust the official server?",
  "FAQ_A6": "Completely safe. KoalaSync's relay server is RAM-only — all session data is permanently deleted the moment you leave the room. No database, no logging, no analytics, no accounts. And if you prefer full control: you can self-host your own private relay server via Docker in minutes. The entire codebase is open source and auditable on GitHub.",
+  "FAQ_Q7": "Can I fix quiet dialogue and loud explosions when watching videos in the browser?",
+  "FAQ_A7": "Yes. KoalaSync 2.2.0 includes a built-in audio compressor that reduces the gap between quiet and loud parts of your video. It runs locally via the Web Audio API — no audio data ever leaves your computer. Open the popup, create a room, go to Settings → Audio Processing, toggle the compressor on, and pick a preset. Works on Netflix, Prime Video, Disney+, YouTube, and any HTML5 video site.",
  "HOWTO_TITLE": "How to synchronize videos with friends using KoalaSync",
  "HOWTO_DESC": "Watch any video in perfect sync with friends across YouTube, Netflix, Twitch and more. No sign-up, no tracking.",
  "HOWTO_STEP_1_NAME": "Install the browser extension",
@@ -164,5 +174,6 @@
  "MOCK_32": "CLEAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync is not affiliated with, endorsed by, or associated with Netflix, Disney+, Amazon, YouTube, Twitch, or any other streaming platform. All trademarks are property of their respective owners.",
  "FOOTER_SUPPORT": "Buy me a coffee on Ko-Fi"
 }
@@ -6,15 +6,15 @@
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "es_ES",
  "META_TITLE": "KoalaSync | Sincroniza Netflix, YouTube y cualquier video con amigos",
-  "META_DESCRIPTION": "Mira Netflix, YouTube, Twitch y cualquier video HTML5 en perfecta sincronización con amigos. Extensión de navegador gratuita y de código abierto. Sin registro.",
+  "META_DESCRIPTION": "Mira Netflix, YouTube, Twitch y cualquier video HTML5 en perfecta sincronización con amigos. Extensión de navegador gratuita, de código abierto y sin necesidad de registro.",
  "OG_TITLE": "KoalaSync | Sincroniza Netflix, Emby, Jellyfin y casi cualquier video con amigos",
  "OG_DESCRIPTION": "Mira Netflix, Emby, Jellyfin, YouTube, Twitch y casi cualquier video HTML5 en perfecta sincronización. Extensión de navegador de código abierto y respetuosa con la privacidad para Chrome y Firefox.",
  "TWITTER_TITLE": "KoalaSync | Sincroniza Netflix, Emby, Jellyfin y casi cualquier video con amigos – Extensión de navegador",
  "TWITTER_DESCRIPTION": "Mira Netflix, Emby, Jellyfin, YouTube, Twitch y casi cualquier video HTML5 en perfecta sincronización con amigos. Extensión de navegador de código abierto y respetuosa con la privacidad para Chrome y Firefox.",
  "NAV_FEATURES": "Características",
  "NAV_HOW_IT_WORKS": "Cómo funciona",
-  "HERO_TITLE": "Miren juntos.<br>Sincronización perfecta.",
-  "HERO_SUBTITLE": "Tu noche de películas a distancia sin retrasos. Sin registro ni recopilación de datos. Solo comparte un enlace y miren juntos.",
+  "HERO_TITLE": "Miren juntos.<span class='hero-line2'>Sincronización perfecta.</span>",
+  "HERO_SUBTITLE": "Tu noche de películas a distancia sin retrasos. Sin registros ni recopilación de datos. Solo comparte un enlace y miren juntos.",
  "HERO_MASCOT_ALT": "Un lindo koala de pie mirando hacia abajo a los botones de descarga",
  "ADD_TO_CHROME": "Añadir a Chrome",
  "ADD_TO_FIREFOX": "Añadir a Firefox",
@@ -25,36 +25,40 @@
  "USE_CASES_SUBTITLE": "Ya sea cerca o lejos, KoalaSync une a las personas en torno a sus videos favoritos.",
  "USE_CASE_1_ALT": "Dos lindos koalas sentados juntos compartiendo un cubo de palomitas de maíz",
  "USE_CASE_1_TITLE": "Noche de películas con amigos",
-  "USE_CASE_1_DESC": "Sincroniza tus películas en tiempo real y habla por Discord, Zoom o tu aplicación de llamada de voz favorita. Es como estar en la misma habitación.",
+  "USE_CASE_1_DESC": "Sincroniza tus películas en tiempo real y habla por Discord, Zoom o tu aplicación de voz favorita. Es como estar en la misma habitación.",
  "USE_CASE_2_ALT": "Un profesor koala presentando en una pantalla a dos estudiantes koala remotos",
  "USE_CASE_2_TITLE": "Aprendizaje a distancia",
-  "USE_CASE_2_DESC": "Analiza tutoriales en línea, conferencias o transmisiones de capacitación de desarrolladores con compañeros o colegas. Pausa y discute pasos complejos en perfecta armonía.",
+  "USE_CASE_2_DESC": "Analiza tutoriales en línea, conferencias o directos de programación con compañeros o colegas. Pausa y discute pasos complejos en perfecta armonía.",
  "USE_CASE_3_ALT": "Una linda pareja de koalas viendo juntos de forma remota; uno está sentado frente a una PC y el otro en la cama con una computadora portátil, con corazones volando entre ellos",
  "USE_CASE_3_TITLE": "Relaciones a larga distancia",
-  "USE_CASE_3_DESC": "Reduce la distancia y disfruta de noches de citas. Experimenta cada giro de la trama, ríete de los mismos chistes y comparte momentos emotivos en el mismo milisegundo exacto.",
+  "USE_CASE_3_DESC": "Reduce la distancia y disfruta de noches de citas. Vive cada giro de la trama, ríete de los mismos chistes y comparte momentos emotivos en el mismo milisegundo exacto.",
  "WHY_TITLE": "¿Por qué KoalaSync?",
-  "WHY_SUBTITLE": "Diseñado para una sincronización confiable, privacidad y una configuración sencilla.",
+  "WHY_SUBTITLE": "Diseñado para una sincronización confiable, con la privacidad como prioridad y una configuración sencilla.",
  "FEATURE_1_TITLE": "Control total / Sincronización instantánea",
-  "FEATURE_1_DESC": "Uno pausa, todos pausan. Uno avanza, todos siguen. Nuestro protocolo de sincronización en dos fases coordina la reproducción en tiempo real para todos los participantes.",
+  "FEATURE_1_DESC": "Si uno pausa, todos pausan. Si uno avanza, todos le siguen. Nuestro protocolo de sincronización en dos fases coordina la reproducción en tiempo real para todos los participantes.",
  "FEATURE_2_TITLE": "Maratones sin fin",
-  "FEATURE_2_DESC": "Reproducción automática sincronizada. KoalaSync detecta automáticamente transiciones de episodios y suspende la reproducción hasta que todos los participantes hayan cargado el siguiente video.",
+  "FEATURE_2_DESC": "Reproducción automática sincronizada. KoalaSync detecta automáticamente los cambios de episodio y detiene la reproducción hasta que todos los participantes hayan cargado el siguiente video.",
  "FEATURE_3_TITLE": "Sin cuentas / Privacidad absoluta",
-  "FEATURE_3_DESC": "Sin registros, sin seguimiento, sin almacenamiento de datos. El servidor funciona completamente en RAM efímera y elimina tu sala tan pronto como sales.",
+  "FEATURE_3_DESC": "Sin registros, sin seguimiento y sin dejar huella. El servidor funciona completamente en RAM efímera y elimina tu sala en cuanto te vas.",
  "FEATURE_4_TITLE": "Soporte universal HTML5",
-  "FEATURE_4_DESC": "Funciona en YouTube, Twitch, Netflix, Jellyfin, Emby y casi cualquier página web estándar que contenga un elemento de video HTML5. También es compatible con configuraciones personalizadas.",
+  "FEATURE_4_DESC": "Funciona en YouTube, Twitch, Netflix, Jellyfin, Emby y casi cualquier página web estándar con un reproductor HTML5. También es compatible con configuraciones propias. Nunca enviamos datos de vídeo a nuestros servidores, solo metadatos de sincronización.",
  "FEATURE_5_TITLE": "Auto-alojable y listo para Docker",
-  "FEATURE_5_DESC": "Nuestros servidores oficiales son gratuitos y rápidos, pero puedes tomar el control total si lo deseas. Inicia tu propio servidor de retransmisión privado en segundos a través de Docker.",
-  "FEATURE_6_TITLE": "Invitaciones al instante / Unirse en 1 clic",
-  "FEATURE_6_DESC": "Sin direcciones IP o contraseñas que intercambiar. Comparte un enlace de invitación generado para permitir que tus amigos se unan automáticamente a tu sala con un solo clic.",
+  "FEATURE_5_DESC": "Nuestros servidores oficiales son gratuitos y rápidos, pero puedes tomar el control total si lo deseas. Inicia tu propio servidor de retransmisión privado en segundos mediante Docker.",
+  "FEATURE_6_TITLE": "Invitaciones al instante / Unirse con un clic",
+  "FEATURE_6_DESC": "Sin intercambio de direcciones IP o contraseñas. Comparte un enlace de invitación generado para que tus amigos se unan automáticamente a tu sala con un solo clic.",
+  "FEATURE_7_TITLE": "Nivelación de volumen / Compresor de audio",
+  "FEATURE_7_DESC": "Se acabó el tener que ajustar el volumen constantemente. El compresor de audio integrado realza los diálogos bajos y suaviza las explosiones fuertes. Funciona en Netflix, Prime Video, Disney+, YouTube y cualquier video HTML5. Funciona de forma local: ningún dato de audio sale de tu equipo.",
+  "FEATURE_8_TITLE": "Código Abierto (Licencia MIT)",
+  "FEATURE_8_DESC": "Todo el código fuente es público y auditable en GitHub. Sin cajas negras ni software propietario: transparencia total desde el servidor de retransmisión hasta la extensión del navegador.",
  "COMP_TITLE": "KoalaSync vs Teleparty",
-  "COMP_SUBTITLE": "Descubre por qué una herramienta de código abierto, sin anuncios y respetuosa con la privacidad es la mejor opción para ver juntos.",
+  "COMP_SUBTITLE": "Descubre por qué una herramienta de código abierto, sin anuncios y privada es la mejor opción para ver contenido juntos.",
  "COMP_COL_FEATURE": "Característica",
-  "COMP_FEAT_1_NAME": "Costo / Funciones de pago",
+  "COMP_FEAT_1_NAME": "Coste / Funciones de pago",
  "COMP_FEAT_1_DESC": "Suscripciones premium, tarifas ocultas o funciones bloqueadas.",
  "COMP_FEAT_1_KOALA": "100% Gratis",
-  "COMP_FEAT_1_TELE": "Suscripciones de pago / Bloqueos Premium",
-  "COMP_FEAT_2_NAME": "Licence / Code auditable",
-  "COMP_FEAT_2_DESC": "Si el código fuente es abierto y libremente auditable.",
+  "COMP_FEAT_1_TELE": "Niveles de pago / Funciones Premium",
+  "COMP_FEAT_2_NAME": "Licencia / Código auditable",
+  "COMP_FEAT_2_DESC": "Indica si el código fuente es abierto y libremente auditable.",
  "COMP_FEAT_2_KOALA": "Código Abierto (MIT)",
  "COMP_FEAT_2_TELE": "Propietario",
  "COMP_FEAT_3_NAME": "Auto-alojamiento",
@@ -65,104 +69,111 @@
  "COMP_FEAT_4_DESC": "Requisitos de registro, cookies de seguimiento y análisis.",
  "COMP_FEAT_4_KOALA": "Sin persistencia (solo RAM)",
  "COMP_FEAT_4_TELE": "Google Analytics y Cookies",
-  "COMP_FEAT_5_NAME": "Compatibilidad del sitio",
+  "COMP_FEAT_5_NAME": "Compatibilidad de sitios",
  "COMP_FEAT_5_DESC": "Sitios web compatibles y compatibilidad de reproductores.",
  "COMP_FEAT_5_KOALA": "Casi cualquier video HTML5",
  "COMP_FEAT_5_TELE": "Solo sitios compatibles",
  "COMP_FEAT_6_NAME": "Localización / Traducción",
  "COMP_FEAT_6_DESC": "Idiomas de interfaz disponibles y soporte de traducción.",
-  "COMP_FEAT_6_KOALA": "13 idiomas (y creciendo)",
+  "COMP_FEAT_6_KOALA": "13 idiomas (y sumando)",
  "COMP_FEAT_6_TELE": "Solo inglés",
+  "COMP_FEAT_7_NAME": "Compresor de Audio / Nivelación de Volumen",
+  "COMP_FEAT_7_DESC": "Normalización de audio integrada para equilibrar diálogos bajos y efectos fuertes",
+  "COMP_FEAT_7_KOALA": "Sí (4 ajustes, control dry/wet)",
+  "COMP_FEAT_7_TELE": "No",
  "COMP_FOOTNOTE_1": "Estado de la comparación: mayo de 2026.",
  "COMP_FOOTNOTE_2": "Detalles oficiales de precios de Teleparty Premium y redes compatibles:",
-  "COMP_FOOTNOTE_3": "Políticas de privacidad y recopilación de datos de seguimiento de Teleparty:",
-  "COMP_FOOTNOTE_4": "Funciona en sitios web que permiten inyecciones de scripts en etiquetas de video HTML5 estándar. Los sitios con políticas de seguridad de contenido (CSP) muy estrictas, protección de copia DRM o contenedores de reproductores fuertemente ocultos (como DOMs de sombra complejos) pueden restringir el control automatizado o la inyección.",
+  "COMP_FOOTNOTE_3": "Políticas de privacidad y recopilación de datos de Teleparty:",
+  "COMP_FOOTNOTE_4": "Funciona en sitios web que permiten inyecciones de scripts en etiquetas de video HTML5 estándar. Los sitios con políticas de seguridad (CSP) muy estrictas, protección DRM o reproductores ofuscados (como DOMs de sombra complejos) pueden restringir el control automático.",
  "STEPS_TITLE": "Cómo empezar",
  "STEP_1_TITLE": "Instalar la extensión",
-  "STEP_1_DESC": "Añade KoalaSync a tu navegador desde Chrome Web Store, complementos de Firefox o descarga el último archivo ZIP de desarrollador desde GitHub.",
-  "STEP_1_ILLUS_DESC": "Sincronizador de video respetuoso con la privacidad",
+  "STEP_1_DESC": "Añade KoalaSync a tu navegador desde la Chrome Web Store, complementos de Firefox o descarga el archivo ZIP para desarrolladores desde GitHub.",
+  "STEP_1_ILLUS_DESC": "Sincronizador de video privado",
  "STEP_1_ILLUS_DL_CHROME": "Descargar para Chrome",
  "STEP_1_ILLUS_DL_FIREFOX": "Descargar para Firefox",
  "STEP_1_ILLUS_ACTIVE": "Extensión activa",
  "STEP_1_ILLUS_READY": "¡Listo para ver juntos!",
  "STEP_2_TITLE": "Crear una sala",
-  "STEP_2_DESC": "Abre la ventana de la extensión y haz clic en '+ Crear nueva sala'. KoalaSync genera automáticamente un identificador de sala y una contraseña seguros, se conecta y copia el enlace de invitación a tu portapapeles.",
+  "STEP_2_DESC": "Abre el menú de la extensión y haz clic en '+ Crear nueva sala'. KoalaSync generará automáticamente un ID de sala y una contraseña seguros, se conectará y copiará el enlace al portapapeles.",
  "STEP_2_ILLUS_ROOM": "Sala",
  "STEP_2_ILLUS_SYNC": "Sincro",
-  "STEP_2_ILLUS_SETTINGS": "Opciones",
+  "STEP_2_ILLUS_SETTINGS": "Ajustes",
  "STEP_2_ILLUS_CREATE": "+ Crear nueva sala",
  "STEP_2_ILLUS_MANUAL": "Conexión manual / Avanzado",
  "STEP_2_ILLUS_COPIED": "¡Enlace de invitación copiado!",
  "STEP_3_TITLE": "Compartir y Sincronizar",
-  "STEP_3_DESC": "Envía el enlace de invitación a tus amigos. Tan pronto como se unan, selecciona tu pestaña de video y disfruta de la reproducción sincronizada.",
+  "STEP_3_DESC": "Envía el enlace de invitación a tus amigos. Una vez que se unan, selecciona tu pestaña de video y disfrutad de la reproducción sincronizada.",
  "STEP_3_ILLUS_IN_SYNC": "SINCRONIZADO",
  "SELF_TITLE": "Para auto-alojadores",
-  "SELF_SUBTITLE": "¿No confías en nuestro servidor? Mantén la soberanía total de los datos. Despliega tu propio servidor de retransmisión en minutos.",
-  "SELF_MASCOT_ALT": "Un lindo koala sentado frente a una computadora portátil desplegando un contenedor Docker para auto-alojamiento",
+  "SELF_SUBTITLE": "¿No te fías de nuestro servidor? Mantén la soberanía total de tus datos. Despliega tu propio servidor de retransmisión en minutos.",
+  "SELF_MASCOT_ALT": "Un lindo koala sentado frente a un portátil desplegando un contenedor Docker",
  "SELF_COPY_CODE": "Copiar código",
-  "SELF_GITHUB_PACKAGES": "Ver todas las etiquetas de imágenes en GitHub Packages",
+  "SELF_GITHUB_PACKAGES": "Ver todas las versiones en GitHub Packages",
  "BOTTOM_TITLE": "¿Aún no te convence? Compruébalo tú mismo.",
-  "BOTTOM_SUBTITLE": "KoalaSync es 100% de código abierto, sin anuncios y sin seguimiento. Audita nuestra base de código en GitHub o instala la extensión del navegador directamente.",
-  "BOTTOM_MASCOT_ALT": "Un lindo koala sosteniendo una página de repositorio de GitHub junto a Octocat, la mascota de GitHub",
+  "BOTTOM_SUBTITLE": "KoalaSync es 100% de código abierto, sin anuncios y sin rastreadores. Audita nuestro código en GitHub o instala la extensión directamente.",
+  "BOTTOM_MASCOT_ALT": "Un lindo koala junto a Octocat, la mascota de GitHub",
  "FAQ_TITLE": "Preguntas frecuentes",
-  "FAQ_SUBTITLE": "Todo lo que necesitas saber para ver videos juntos en perfecta sincronía.",
+  "FAQ_SUBTITLE": "Todo lo que necesitas saber para ver vídeos en perfecta sincronía.",
  "FAQ_Q1": "¿Puedo ver Netflix, Emby o Jellyfin sincronizado con amigos?",
-  "FAQ_A1": "¡Sí! KoalaSync funciona con Netflix, YouTube, Twitch y cualquier sitio con reproductor de video HTML5 — incluyendo Emby, Jellyfin y servidores multimedia propios. Instala la extensión, crea una sala, comparte el enlace y todos miran en perfecta sincronía.",
+  "FAQ_A1": "¡Sí! KoalaSync funciona en Netflix, YouTube, Twitch y cualquier web con reproductor HTML5, incluyendo Emby, Jellyfin y servidores multimedia propios. Instala la extensión, crea una sala, comparte el enlace y todos veréis lo mismo al mismo tiempo.",
  "FAQ_Q2": "¿Es KoalaSync una alternativa gratuita a Teleparty?",
-  "FAQ_A2": "100% gratuito y de código abierto bajo licencia MIT. Sin niveles premium, sin funciones bloqueadas, sin anuncios. A diferencia de Teleparty, el servidor relay de KoalaSync solo usa RAM — sin recolección de datos ni cuentas de usuario.",
-  "FAQ_Q3": "¿Funciona KoalaSync con Emby, Jellyfin y servidores multimedia propios?",
-  "FAQ_A3": "Sí. KoalaSync detecta cualquier elemento de video HTML5, por lo que funciona con Emby, Jellyfin, Plex y cualquier configuración de streaming personalizada. También puedes alojar tu propio servidor relay con Docker.",
-  "FAQ_Q4": "¿Qué navegadores y plataformas son compatibles con KoalaSync?",
-  "FAQ_A4": "Google Chrome, Mozilla Firefox, Microsoft Edge, Opera, Brave y todos los navegadores basados en Chromium. Instálalo desde Chrome Web Store o Firefox Add-ons.",
-  "FAQ_Q5": "¿Todos mis amigos necesitan instalar la extensión?",
-  "FAQ_A5": "Sí, cada participante necesita KoalaSync — pero sin registro ni creación de cuenta. Solo haz clic en el enlace de invitación, instala la extensión si es necesario y te unes automáticamente a la sala.",
+  "FAQ_A2": "Es 100% gratuito y de código abierto (Licencia MIT). Sin suscripciones, sin funciones bloqueadas y sin anuncios. A diferencia de Teleparty, el servidor de KoalaSync solo usa RAM: no hay bases de datos ni cuentas de usuario.",
+  "FAQ_Q3": "¿Funciona KoalaSync con Emby, Jellyfin y servidores propios?",
+  "FAQ_A3": "Sí. KoalaSync detecta cualquier elemento de video HTML5 estándar, por lo que es perfecto para Emby, Jellyfin, Plex y cualquier plataforma de streaming personalizada. También puedes alojar tu propio servidor con Docker.",
+  "FAQ_Q4": "¿Qué navegadores y plataformas son compatibles?",
+  "FAQ_A4": "Google Chrome, Mozilla Firefox, Microsoft Edge, Opera, Brave y todos los navegadores basados en Chromium. Instálalo directamente desde las tiendas oficiales sin configuraciones manuales.",
+  "FAQ_Q5": "¿Todos mis amigos necesitan tener la extensión instalada?",
+  "FAQ_A5": "Sí, cada participante necesita KoalaSync, pero no hace falta registrarse. Solo hay que hacer clic en el enlace, instalar la extensión si no se tiene y la unión a la sala es automática.",
  "FAQ_Q6": "¿Están seguros mis datos? ¿Y si no confío en el servidor oficial?",
-  "FAQ_A6": "Totalmente seguro. El servidor relay de KoalaSync usa solo RAM — todos los datos de sesión se eliminan al salir de la sala. Sin base de datos, sin registros, sin análisis, sin cuentas. Si prefieres control total: aloja tu propio servidor relay privado con Docker en minutos. El código fuente es completamente abierto y auditable en GitHub.",
+  "FAQ_A6": "Totalmente seguros. El servidor de KoalaSync funciona solo en RAM: todos los datos de la sesión se borran permanentemente en cuanto sales de la sala. Sin registros ni analíticas. Si prefieres el control total, puedes auto-alojar tu propio servidor privado mediante Docker.",
+  "FAQ_Q7": "¿Puedo arreglar los diálogos bajos y las explosiones fuertes al ver vídeos?",
+  "FAQ_A7": "Sí. KoalaSync incluye un compresor de audio integrado que equilibra las partes bajas y altas del sonido. Funciona localmente mediante la Web Audio API: ningún dato de audio sale de tu equipo. Ve a Configuración → Procesamiento de audio y activa el compresor.",
  "HOWTO_TITLE": "Cómo sincronizar videos con amigos usando KoalaSync",
-  "HOWTO_DESC": "Mira videos en perfecta sincronía con amigos en YouTube, Netflix, Twitch y más. Sin registro, sin seguimiento.",
-  "HOWTO_STEP_1_NAME": "Instalar la extensión",
-  "HOWTO_STEP_1_TEXT": "Añade KoalaSync a tu navegador desde Chrome Web Store o Firefox Add-ons. Funciona en cualquier sitio con un elemento de video.",
-  "HOWTO_STEP_2_NAME": "Crear una sala",
-  "HOWTO_STEP_2_TEXT": "Abre la extensión y haz clic en Crear nueva sala. El enlace de invitación se copia automáticamente al portapapeles.",
-  "HOWTO_STEP_3_NAME": "Compartir y sincronizar",
-  "HOWTO_STEP_3_TEXT": "Envía el enlace de invitación a tus amigos. Selecciona una pestaña de video y disfruta de reproducción sincronizada en tiempo real.",
+  "HOWTO_DESC": "Mira cualquier video en sincronía con amigos en YouTube, Netflix, Twitch y más. Sin registros ni rastreo.",
+  "HOWTO_STEP_1_NAME": "Instala la extensión",
+  "HOWTO_STEP_1_TEXT": "Añade KoalaSync a tu navegador desde la Chrome Web Store o Firefox Add-ons. Funciona en cualquier web con reproductor de vídeo.",
+  "HOWTO_STEP_2_NAME": "Crea una sala",
+  "HOWTO_STEP_2_TEXT": "Abre la extensión y haz clic en 'Crear nueva sala'. El enlace de invitación se copiará automáticamente.",
+  "HOWTO_STEP_3_NAME": "Comparte y sincroniza",
+  "HOWTO_STEP_3_TEXT": "Envía el enlace a tus amigos. Selecciona la pestaña del video y disfrutad de la reproducción en tiempo real.",
  "FOOTER_MIT": "Código abierto bajo la Licencia MIT.",
-  "FOOTER_RAM": "No se almacenan datos en nuestros servidores. Retransmisión solo en RAM.",
-  "FOOTER_LEGAL": "Legal Notice",
-  "FOOTER_PRIVACY": "Privacy Policy",
+  "FOOTER_RAM": "No almacenamos datos. Retransmisión pura basada en RAM.",
+  "FOOTER_LEGAL": "Aviso Legal",
+  "FOOTER_PRIVACY": "Política de Privacidad",
  "MOCK_01": "Sala activa",
  "MOCK_02": "Servidor oficial",
  "MOCK_03": "Enlace de invitación",
-  "MOCK_04": "Participantes",
+  "MOCK_04": "Participantes en la sala",
  "MOCK_05": "TÚ",
  "MOCK_06": "Reproduciendo",
-  "MOCK_07": "Compañero",
-  "MOCK_08": "Salir",
+  "MOCK_07": "Participante",
+  "MOCK_08": "Salir de la sala",
  "MOCK_09": "Seleccionar video",
  "MOCK_10": "Control remoto",
  "MOCK_11": "Reproducir",
-  "MOCK_12": "Pausa",
-  "MOCK_13": "Saltar a otros",
-  "MOCK_14": "Última actividad",
-  "MOCK_15": "Esperando a 1 compañero (KoalaPC)...",
-  "MOCK_16": "Saltar y reproducir",
-  "MOCK_17": "Tu nombre",
-  "MOCK_18": "Ocultar pestañas",
-  "MOCK_19": "Auto-sync siguiente episodio",
-  "MOCK_20": "Auto-copiar enlace",
-  "MOCK_21": "Notificaciones",
-  "MOCK_22": "Solución de problemas",
-  "MOCK_23": "Regenerar ID",
-  "MOCK_24": "Usa esto si ves error de \"Identidad duplicada\".",
-  "MOCK_25": "Estado de conexión",
-  "MOCK_26": "Conectado",
-  "MOCK_27": "Copiar logs",
-  "MOCK_28": "Info de depuración de video",
-  "MOCK_29": "Historial completo",
-  "MOCK_30": "Registros (últimos 50)",
-  "MOCK_31": "BORRAR",
-  "MOCK_32": "CLEAR",
+  "MOCK_12": "Pausar",
+  "MOCK_13": "SINCRO",
+  "MOCK_14": "Ir a la posición de otros",
+  "MOCK_15": "Estado de la última actividad",
+  "MOCK_16": "Esperando a 1 participante (KoalaPC)...",
+  "MOCK_17": "Omitir y reproducir ya",
+  "MOCK_18": "Tu nombre de usuario",
+  "MOCK_19": "Ocultar pestañas sin video",
+  "MOCK_20": "Sincro auto del siguiente episodio",
+  "MOCK_21": "Auto-copiar enlace",
+  "MOCK_22": "Notificaciones del navegador",
+  "MOCK_23": "Resolución de problemas",
+  "MOCK_24": "Regenerar ID de usuario",
+  "MOCK_25": "Usa esto si ves errores de \"Identidad duplicada\".",
+  "MOCK_26": "Estado de la conexión",
+  "MOCK_27": "Conectado",
+  "MOCK_28": "Copiar registros",
+  "MOCK_29": "Información de depuración de video",
+  "MOCK_30": "Historial completo",
+  "MOCK_31": "Registros (Últimos 50)",
+  "MOCK_32": "LIMPIAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync no está afiliado, respaldado ni asociado con Netflix, Disney+, Amazon, YouTube, Twitch ni ninguna otra plataforma de streaming. Todas las marcas comerciales pertenecen a sus respectivos dueños.",
  "FOOTER_SUPPORT": "Invítame a un café en Ko-Fi"
 }
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Regardez Netflix, Emby, Jellyfin, YouTube, Twitch et presque n'importe quelle vidéo HTML5 en parfaite synchronisation avec vos amis. Extension de navigateur open-source et respectueuse de la vie privée pour Chrome et Firefox.",
  "NAV_FEATURES": "Fonctionnalités",
  "NAV_HOW_IT_WORKS": "Comment ça marche",
-  "HERO_TITLE": "Regardez ensemble.<br>Synchronisation parfaite.",
+  "HERO_TITLE": "Regardez ensemble.<span class='hero-line2'>Synchronisation parfaite.</span>",
  "HERO_SUBTITLE": "Votre soirée cinéma à distance sans décalage. Pas d'inscription, pas de collecte de données. Partagez simplement un lien et regardez ensemble.",
  "HERO_MASCOT_ALT": "Un koala mignon debout et regardant vers le bas les boutons de téléchargement",
  "ADD_TO_CHROME": "Ajouter à Chrome",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Aucun compte / Vie privée garantie",
  "FEATURE_3_DESC": "Pas d'inscription, pas de suivi, pas de stockage de données. Le serveur fonctionne entièrement dans une RAM éphémère et supprime votre salon dès votre départ.",
  "FEATURE_4_TITLE": "Support HTML5 universel",
-  "FEATURE_4_DESC": "Fonctionne sur YouTube, Twitch, Netflix, Jellyfin, Emby et presque n'importe quelle page web standard contenant un élément vidéo HTML5. Également compatible avec les installations personnalisées.",
+  "FEATURE_4_DESC": "Fonctionne sur YouTube, Twitch, Netflix, Jellyfin, Emby et presque n'importe quelle page web standard contenant un élément vidéo HTML5. Également compatible avec les installations personnalisées. Aucune donnée vidéo n'est envoyée à nos serveurs — seules les métadonnées de synchronisation.",
  "FEATURE_5_TITLE": "Hébergeable soi-même & prêt pour Docker",
  "FEATURE_5_DESC": "Nos serveurs officiels sont gratuits et rapides, mais vous pouvez prendre le contrôle total si vous le souhaitez. Lancez votre propre serveur relais privé en quelques secondes via Docker.",
  "FEATURE_6_TITLE": "Invitations instantanées / Rejoindre en 1 clic",
  "FEATURE_6_DESC": "Pas d'adresses IP ou de mots de passe à échanger. Partagez un lien d'invitation généré pour permettre à vos amis de rejoindre automatiquement votre salon en un seul clic.",
+  "FEATURE_7_TITLE": "Égalisation du volume / Compresseur audio",
+  "FEATURE_7_DESC": "Fini de jouer avec le bouton du volume. Le compresseur audio intégré booste les dialogues discrets et adoucit les explosions. Fonctionne sur Netflix, Prime Video, Disney+, YouTube et toute vidéo HTML5. Entièrement local — aucune donnée audio ne quitte votre ordinateur.",
+  "FEATURE_8_TITLE": "Open Source (MIT License)",
+  "FEATURE_8_DESC": "The entire codebase is publicly auditable on GitHub. No black boxes, no proprietary blobs — 100% transparency from the relay server to the browser extension.",
  "COMP_TITLE": "KoalaSync vs Teleparty",
  "COMP_SUBTITLE": "Découvrez pourquoi un outil open-source, sans publicité et respectueux de la vie privée est le meilleur choix pour regarder ensemble.",
  "COMP_COL_FEATURE": "Fonctionnalité",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Langues d'interface disponibles et support de traduction.",
  "COMP_FEAT_6_KOALA": "13 langues (et plus à venir)",
  "COMP_FEAT_6_TELE": "Anglais uniquement",
+  "COMP_FEAT_7_NAME": "Compresseur Audio / Égalisation du Volume",
+  "COMP_FEAT_7_DESC": "Normalisation audio intégrée pour équilibrer les dialogues silencieux et les effets sonores",
+  "COMP_FEAT_7_KOALA": "Oui (4 préréglages, contrôle dry/wet)",
+  "COMP_FEAT_7_TELE": "Non",
  "COMP_FOOTNOTE_1": "État de la comparaison : mai 2026.",
  "COMP_FOOTNOTE_2": "Détails sur les tarifs officiels de Teleparty Premium et les réseaux pris en charge :",
  "COMP_FOOTNOTE_3": "Politiques de confidentialité et collecte de données de suivi de Teleparty :",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Oui, chaque participant a besoin de KoalaSync — mais sans inscription ni création de compte. Cliquez simplement sur le lien d'invitation, installez l'extension si nécessaire et vous rejoignez automatiquement le salon.",
  "FAQ_Q6": "Mes données sont-elles en sécurité ? Et si je ne fais pas confiance au serveur officiel ?",
  "FAQ_A6": "Totalement sûr. Le serveur relay de KoalaSync fonctionne uniquement en RAM — toutes les données de session sont supprimées dès que vous quittez le salon. Aucune base de données, aucun journal, aucune analyse, aucun compte. Si vous préférez un contrôle total : hébergez votre propre serveur relay privé via Docker en quelques minutes. Le code source est entièrement open source et vérifiable sur GitHub.",
+  "FAQ_Q7": "Puis-je atténuer les dialogues discrets et les explosions fortes en regardant des vidéos dans le navigateur ?",
+  "FAQ_A7": "Oui. KoalaSync 2.2.0 inclut un compresseur audio intégré qui réduit l'écart entre les parties silencieuses et bruyantes de votre vidéo. Il fonctionne localement via l'API Web Audio — aucune donnée audio ne quitte votre ordinateur. Ouvrez le popup, créez un salon, allez dans Paramètres → Audio Processing, activez le compresseur et choisissez un préréglage. Fonctionne sur Netflix, Prime Video, Disney+, YouTube et tout site vidéo HTML5.",
  "HOWTO_TITLE": "Comment synchroniser des vidéos avec des amis avec KoalaSync",
  "HOWTO_DESC": "Regardez des vidéos en parfaite synchronisation avec vos amis sur YouTube, Netflix, Twitch et plus. Sans inscription, sans pistage.",
  "HOWTO_STEP_1_NAME": "Installer l'extension",
@@ -164,5 +174,6 @@
  "MOCK_32": "CLEAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync n'est pas affilié à Netflix, Disney+, Amazon, YouTube, Twitch ou toute autre plateforme de streaming. Toutes les marques déposées appartiennent à leurs détenteurs respectifs.",
  "FOOTER_SUPPORT": "Offre-moi un café sur Ko-Fi"
 }
@@ -2,167 +2,178 @@
  "LANG_CODE": "it",
  "HTML_CLASS": "lang-it",
  "CANONICAL_PATH": "it/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "it_IT",
-  "META_TITLE": "KoalaSync | Sincronizza Netflix, YouTube e qualsiasi video con gli amici",
-  "META_DESCRIPTION": "Guarda Netflix, YouTube, Twitch e qualsiasi video HTML5 in perfetta sincronia con gli amici. Estensione del browser gratuita e open source per Chrome e Firefox. Nessuna registrazione richiesta.",
-  "OG_TITLE": "KoalaSync | Sincronizza Netflix, Emby, Jellyfin e quasi tutti i video con gli amici",
-  "OG_DESCRIPTION": "Guarda Netflix, Emby, Jellyfin, YouTube, Twitch e quasi tutti i video HTML5 in perfetta sincronia. Estensione del browser open source e attenta alla privacy per Chrome e Firefox.",
-  "TWITTER_TITLE": "KoalaSync | Sincronizza Netflix, Emby, Jellyfin e quasi tutti i video con gli amici – Estensione Browser",
-  "TWITTER_DESCRIPTION": "Guarda Netflix, Emby, Jellyfin, YouTube, Twitch e quasi tutti i video HTML5 in perfetta sincronia con gli amici. Estensione del browser open source e attenta alla privacy per Chrome e Firefox.",
+  "META_TITLE": "KoalaSync | Sincronizza Netflix, YouTube e qualsiasi video con i tuoi amici",
+  "META_DESCRIPTION": "Guarda Netflix, YouTube, Twitch e qualsiasi video HTML5 in perfetta sincronia. Estensione gratuita, open source e senza registrazione.",
+  "OG_TITLE": "KoalaSync | Sincronizza Netflix, Emby, Jellyfin e video web con i tuoi amici",
+  "OG_DESCRIPTION": "Guarda video in perfetta sincronia con i tuoi amici. Estensione open source per Chrome e Firefox incentrata sulla privacy.",
+  "TWITTER_TITLE": "KoalaSync | Sincronizza video in streaming con i tuoi amici",
+  "TWITTER_DESCRIPTION": "Guarda video insieme ai tuoi amici in perfetta sincronia. Open source e rispettoso della privacy.",
  "NAV_FEATURES": "Funzionalità",
  "NAV_HOW_IT_WORKS": "Come Funziona",
-  "HERO_TITLE": "Guarda Insieme.<br>Sincronizza Perfettamente.",
-  "HERO_SUBTITLE": "La tua serata cinema a distanza senza lag. Nessuna registrazione, nessun dato raccolto. Condividi un link e guarda insieme.",
-  "HERO_MASCOT_ALT": "Un simpatico koala in piedi che guarda in basso verso i pulsanti di download",
+  "HERO_TITLE": "Guardate Insieme.<span class='hero-line2'>Sincronia Perfetta.</span>",
+  "HERO_SUBTITLE": "La tua serata cinema a distanza senza ritardi. Nessun account, nessun dato raccolto. Condividi un link e guardate insieme.",
+  "HERO_MASCOT_ALT": "Un simpatico koala che guarda i pulsanti di download",
  "ADD_TO_CHROME": "Aggiungi a Chrome",
  "ADD_TO_FIREFOX": "Aggiungi a Firefox",
-  "COMPAT_HEADING": "Funziona sulle tue piattaforme preferite",
-  "COMPAT_MORE": "e molti altri",
-  "COMPAT_TOOLTIP": "Funziona su quasi tutti i siti con un elemento video",
-  "USE_CASES_TITLE": "Perfetto per Ogni Occasione",
+  "COMPAT_HEADING": "Compatibile con le tue piattaforme preferite",
+  "COMPAT_MORE": "e molte altre",
+  "COMPAT_TOOLTIP": "Funziona su quasi tutti i siti con video HTML5",
+  "USE_CASES_TITLE": "Perfetto per ogni occasione",
  "USE_CASES_SUBTITLE": "Vicini o lontani, KoalaSync unisce le persone attorno ai loro video preferiti.",
-  "USE_CASE_1_ALT": "Due simpatici koala seduti insieme che condividono un secchio di popcorn",
+  "USE_CASE_1_ALT": "Due koala che mangiano popcorn insieme",
  "USE_CASE_1_TITLE": "Serata Cinema con gli Amici",
-  "USE_CASE_1_DESC": "Sincronizza i tuoi film in tempo reale e parla via Discord, Zoom o la tua app di chiamata vocale preferita. Sembrerà di essere nella stessa stanza.",
-  "USE_CASE_2_ALT": "Un professore koala che presenta su uno schermo a due studenti koala a distanza",
+  "USE_CASE_1_DESC": "Sincronizza i tuoi film in tempo reale e parla su Discord o Zoom. Sembrerà di essere nella stessa stanza.",
+  "USE_CASE_2_ALT": "Un professore koala che insegna a distanza",
  "USE_CASE_2_TITLE": "Apprendimento a Distanza",
-  "USE_CASE_2_DESC": "Analizza tutorial online, lezioni o stream di formazione per sviluppatori insieme a compagni di classe o colleghi. Fai pausa e discuti i passaggi complessi in perfetta armonia.",
-  "USE_CASE_3_ALT": "Una simpatica coppia di koala che guarda insieme a distanza; uno è seduto al PC e l'altro è a letto con un laptop, con cuori che volano tra loro",
+  "USE_CASE_2_DESC": "Analizza tutorial o lezioni insieme a colleghi e compagni. Metti in pausa e discuti i passaggi più complessi in armonia.",
+  "USE_CASE_3_ALT": "Una coppia di koala che guarda video a distanza con dei cuori",
  "USE_CASE_3_TITLE": "Relazioni a Distanza",
-  "USE_CASE_3_DESC": "Supera le distanze e goditi le serate romantiche. Vivi ogni colpo di scena, ridi alle stesse battute e condividi momenti emozionanti nello stesso identico millisecondo.",
+  "USE_CASE_3_DESC": "Accorcia le distanze e goditi serate romantiche. Vivi ogni emozione e ridi alle stesse battute nello stesso identico istante.",
  "WHY_TITLE": "Perché KoalaSync?",
-  "WHY_SUBTITLE": "Progettato per una sincronizzazione affidabile, privacy al primo posto e configurazione semplice.",
-  "FEATURE_1_TITLE": "Controllo Totale / Sincronizzazione Istantanea",
-  "FEATURE_1_DESC": "Uno mette in pausa, tutti mettono in pausa. Uno cerca, tutti lo seguono. Il nostro protocollo di sincronizzazione a due fasi coordina la riproduzione in tempo reale tra tutti i partecipanti.",
-  "FEATURE_2_TITLE": "Binge-Watching Infinito",
-  "FEATURE_2_DESC": "Riproduzione automatica sincronizzata. KoalaSync rileva automaticamente i cambi di episodio e blocca la riproduzione finché tutti i partecipanti non hanno caricato il video successivo.",
-  "FEATURE_3_TITLE": "Zero Account / Massima Privacy",
-  "FEATURE_3_DESC": "Nessuna registrazione, nessun tracciamento, nessuna traccia persistente. Il server funziona interamente nella RAM effimera e cancella la tua stanza quando te ne vai.",
+  "WHY_SUBTITLE": "Sincronizzazione affidabile, massima privacy e configurazione immediata.",
+  "FEATURE_1_TITLE": "Controllo Totale / Sincro Istantanea",
+  "FEATURE_1_DESC": "Se uno mette in pausa, tutti si fermano. Se uno salta in avanti, gli altri lo seguono. Tutto in tempo reale.",
+  "FEATURE_2_TITLE": "Maratone senza interruzioni",
+  "FEATURE_2_DESC": "Riproduzione automatica sincronizzata. KoalaSync attende che tutti abbiano caricato l'episodio successivo prima di farlo partire.",
+  "FEATURE_3_TITLE": "Senza Account / Privacy Totale",
+  "FEATURE_3_DESC": "Niente registrazioni o tracciamenti. Il server non salva nulla e cancella la tua stanza appena te ne vai.",
  "FEATURE_4_TITLE": "Supporto HTML5 Universale",
-  "FEATURE_4_DESC": "Funziona su YouTube, Twitch, Netflix, Jellyfin, Emby e quasi tutte le pagine web standard contenenti un elemento video HTML5. Compatibile anche con server personalizzati.",
-  "FEATURE_5_TITLE": "Ospitabile Autonomamente e Pronto per Docker",
-  "FEATURE_5_DESC": "I nostri server ufficiali sono gratuiti e veloci, ma puoi gestirne uno tuo se preferisci. Avvia il tuo server di inoltro privato in pochi secondi tramite Docker.",
-  "FEATURE_6_TITLE": "Inviti Istantanei / Accesso con 1 Click",
-  "FEATURE_6_DESC": "Nessun indirizzo IP o password da scambiare. Condividi un link di invito generato con i tuoi amici per farli entrare nella stanza automaticamente con un solo clic.",
-  "COMP_TITLE": "KoalaSync vs. Teleparty",
-  "COMP_SUBTITLE": "Scopri perché l'open source, senza pubblicità e attento alla privacy è il modo migliore per guardare i video insieme.",
-  "COMP_COL_FEATURE": "Funzionalità",
-  "COMP_FEAT_1_NAME": "Costi / Paywall",
-  "COMP_FEAT_1_DESC": "Abbonamenti premium, costi nascosti o funzionalità bloccate.",
-  "COMP_FEAT_1_KOALA": "100% Gratuito",
-  "COMP_FEAT_1_TELE": "Piani a Pagamento / Blocchi Premium",
-  "COMP_FEAT_2_NAME": "Licenza / Codice Controllabile",
-  "COMP_FEAT_2_DESC": "Indica se il codice sorgente è aperto e liberamente controllabile.",
+  "FEATURE_4_DESC": "Funziona su YouTube, Twitch, Netflix, Jellyfin, Emby e quasi ogni pagina web. Nessun dato video viene inviato ai nostri server.",
+  "FEATURE_5_TITLE": "Ospitabile in Proprio (Docker)",
+  "FEATURE_5_DESC": "I nostri server sono veloci, ma puoi gestire il tuo server privato in pochi secondi tramite Docker.",
+  "FEATURE_6_TITLE": "Inviti Rapidi / Un clic per entrare",
+  "FEATURE_6_DESC": "Niente password complicate. Condividi il link generato e i tuoi amici entreranno automaticamente con un solo clic.",
+  "FEATURE_7_TITLE": "Volume Bilanciato / Compressore Audio",
+  "FEATURE_7_DESC": "Basta regolare il volume ogni minuto. Il compressore integrato esalta le voci e attenua i rumori forti. Tutto in locale.",
+  "FEATURE_8_TITLE": "Open Source (Licenza MIT)",
+  "FEATURE_8_DESC": "Tutto il codice è pubblico su GitHub. Trasparenza totale, senza scatole nere o software proprietario.",
+  "COMP_TITLE": "KoalaSync vs Teleparty",
+  "COMP_SUBTITLE": "Scopri perché una soluzione open source e senza pubblicità è la scelta migliore per guardare video insieme.",
+  "COMP_COL_FEATURE": "Caratteristica",
+  "COMP_FEAT_1_NAME": "Costo / Paywall",
+  "COMP_FEAT_1_DESC": "Abbonamenti premium o funzioni a pagamento.",
+  "COMP_FEAT_1_KOALA": "100% Gratis",
+  "COMP_FEAT_1_TELE": "Livelli a pagamento / Blocchi Premium",
+  "COMP_FEAT_2_NAME": "Codice Trasparente",
+  "COMP_FEAT_2_DESC": "Indica se il codice sorgente è aperto e verificabile da chiunque.",
  "COMP_FEAT_2_KOALA": "Open Source (MIT)",
  "COMP_FEAT_2_TELE": "Proprietario",
-  "COMP_FEAT_3_NAME": "Ospitare in Proprio",
-  "COMP_FEAT_3_DESC": "Possibilità di distribuire il proprio server di inoltro privato.",
-  "COMP_FEAT_3_KOALA": "Sì (Pronto per Docker)",
+  "COMP_FEAT_3_NAME": "Self-Hosting",
+  "COMP_FEAT_3_DESC": "Possibilità di avviare il proprio server privato.",
+  "COMP_FEAT_3_KOALA": "Sì (Docker)",
  "COMP_FEAT_3_TELE": "No",
-  "COMP_FEAT_4_NAME": "Privacy e Tracciamento",
-  "COMP_FEAT_4_DESC": "Requisiti di registrazione, cookie di tracciamento e analisi.",
-  "COMP_FEAT_4_KOALA": "Nessuna Persistenza (Solo RAM)",
+  "COMP_FEAT_4_NAME": "Privacy",
+  "COMP_FEAT_4_DESC": "Registrazione obbligatoria e cookie di tracciamento.",
+  "COMP_FEAT_4_KOALA": "Nessun dato salvato",
  "COMP_FEAT_4_TELE": "Google Analytics e Cookie",
-  "COMP_FEAT_5_NAME": "Compatibilità dei Siti",
-  "COMP_FEAT_5_DESC": "Siti web supportati e compatibilità dei player.",
-  "COMP_FEAT_5_KOALA": "Quasi tutti i video HTML5",
-  "COMP_FEAT_5_TELE": "Solo siti supportati",
-  "COMP_FEAT_6_NAME": "Localizzazione / Traduzione",
-  "COMP_FEAT_6_DESC": "Lingue dell'interfaccia disponibili e supporto alle traduzioni.",
+  "COMP_FEAT_5_NAME": "Compatibilità Siti",
+  "COMP_FEAT_5_DESC": "Piattaforme supportate.",
+  "COMP_FEAT_5_KOALA": "Quasi ogni video HTML5",
+  "COMP_FEAT_5_TELE": "Solo siti selezionati",
+  "COMP_FEAT_6_NAME": "Traduzione",
+  "COMP_FEAT_6_DESC": "Lingue disponibili per l'interfaccia.",
  "COMP_FEAT_6_KOALA": "13 Lingue (in crescita)",
  "COMP_FEAT_6_TELE": "Solo Inglese",
-  "COMP_FOOTNOTE_1": "Stato del confronto: Maggio 2026.",
-  "COMP_FOOTNOTE_2": "Dettagli sui prezzi di Teleparty Premium e reti supportate:",
-  "COMP_FOOTNOTE_3": "Informativa sulla privacy di Teleparty e raccolta dei dati di tracciamento:",
-  "COMP_FOOTNOTE_4": "Funziona sui siti web che consentono l'iniezione di script nei tag video HTML5 standard. I siti web con Content Security Policy (CSP) molto rigide, protezioni DRM o wrapper del player fortemente offuscati (come shadow DOM complessi) potrebbero limitare il controllo o l'iniezione.",
-  "STEPS_TITLE": "Guida Introduttiva",
+  "COMP_FEAT_7_NAME": "Compressore Audio",
+  "COMP_FEAT_7_DESC": "Bilanciamento automatico del suono per voci più chiare.",
+  "COMP_FEAT_7_KOALA": "Sì (4 impostazioni)",
+  "COMP_FEAT_7_TELE": "No",
+  "COMP_FOOTNOTE_1": "Confronto aggiornato a: Maggio 2026.",
+  "COMP_FOOTNOTE_2": "Dettagli sui prezzi premium di Teleparty:",
+  "COMP_FOOTNOTE_3": "Politiche sulla privacy di Teleparty:",
+  "COMP_FOOTNOTE_4": "Funziona su siti che permettono l'uso di script nei tag video HTML5. Alcuni siti con protezioni DRM molto rigide potrebbero limitare il controllo automatico.",
+  "STEPS_TITLE": "Inizia ora",
  "STEP_1_TITLE": "Installa l'Estensione",
-  "STEP_1_DESC": "Aggiungi KoalaSync al tuo browser dal Chrome Web Store, da Firefox Add-ons, o scarica l'ultimo ZIP per sviluppatori da GitHub.",
-  "STEP_1_ILLUS_DESC": "Sincronizzatore video attento alla privacy",
+  "STEP_1_DESC": "Aggiungi KoalaSync al tuo browser dal Chrome Web Store o dai componenti aggiuntivi di Firefox.",
+  "STEP_1_ILLUS_DESC": "Sincronizzatore video privato",
  "STEP_1_ILLUS_DL_CHROME": "Scarica per Chrome",
  "STEP_1_ILLUS_DL_FIREFOX": "Scarica per Firefox",
  "STEP_1_ILLUS_ACTIVE": "Estensione Attiva",
-  "STEP_1_ILLUS_READY": "Pronti a guardare insieme!",
+  "STEP_1_ILLUS_READY": "Pronti a guardare!",
  "STEP_2_TITLE": "Crea una Stanza",
-  "STEP_2_DESC": "Apri il popup dell'estensione e fai clic su '+ Crea Nuova Stanza'. KoalaSync genererà automaticamente un ID Stanza e una Password sicuri, entrerà nella stanza e copierà il link di invito negli appunti.",
+  "STEP_2_DESC": "Apri l'estensione e clicca su '+ Crea Nuova Stanza'. Verrà generato un link di invito automaticamente.",
  "STEP_2_ILLUS_ROOM": "Stanza",
-  "STEP_2_ILLUS_SYNC": "Sincronizza",
-  "STEP_2_ILLUS_SETTINGS": "Impostazioni",
+  "STEP_2_ILLUS_SYNC": "Sincro",
+  "STEP_2_ILLUS_SETTINGS": "Ajustes",
  "STEP_2_ILLUS_CREATE": "+ Crea Nuova Stanza",
-  "STEP_2_ILLUS_MANUAL": "Connessione Manuale / Avanzata",
-  "STEP_2_ILLUS_COPIED": "Link di invito copiato!",
-  "STEP_3_TITLE": "Condividi e Sincronizza",
-  "STEP_3_DESC": "Invia il link di invito ai tuoi amici. Una volta entrati, seleziona la scheda del tuo video e goditi la riproduzione sincronizzata.",
-  "STEP_3_ILLUS_IN_SYNC": "IN SINCRONIA",
-  "SELF_TITLE": "Per chi Ospita Autonomamente",
-  "SELF_SUBTITLE": "Non ti fidi del nostro server? Mantieni la piena sovranità sui tuoi dati. Distribuisci il tuo server di inoltro privato in pochi minuti.",
-  "SELF_MASCOT_ALT": "Un simpatico koala seduto al laptop che distribuisce un contenitore Docker per l'hosting autonomo",
+  "STEP_2_ILLUS_MANUAL": "Manuale / Avanzato",
+  "STEP_2_ILLUS_COPIED": "Link copiato!",
+  "STEP_3_TITLE": "Condividi e Guarda",
+  "STEP_3_DESC": "Invia il link ai tuoi amici. Una volta connessi, scegli il video e goditi la riproduzione sincronizzata.",
+  "STEP_3_ILLUS_IN_SYNC": "SINCRONIZZATI",
+  "SELF_TITLE": "Per utenti esperti",
+  "SELF_SUBTITLE": "Preferisci gestire i tuoi dati? Avvia il tuo server privato in pochi minuti.",
+  "SELF_MASCOT_ALT": "Un koala che configura un server Docker",
  "SELF_COPY_CODE": "Copia Codice",
-  "SELF_GITHUB_PACKAGES": "Visualizza tutti i tag delle immagini su GitHub Packages",
-  "BOTTOM_TITLE": "Non sei convinto? Guarda tu stesso.",
-  "BOTTOM_SUBTITLE": "KoalaSync è al 100% open source, senza pubblicità e senza tracciamento. Controlla il nostro codice su GitHub o installa direttamente l'estensione del browser.",
-  "BOTTOM_MASCOT_ALT": "Un simpatico koala che tiene una pagina del repository GitHub vicino alla mascotte di GitHub Octocat",
+  "SELF_GITHUB_PACKAGES": "Vedi tutte le versioni su GitHub",
+  "BOTTOM_TITLE": "Ancora dubbi?",
+  "BOTTOM_SUBTITLE": "KoalaSync è 100% open source, senza pubblicità o tracciamenti. Controlla il nostro codice su GitHub.",
+  "BOTTOM_MASCOT_ALT": "Un koala con Octocat, la mascotte di GitHub",
  "FAQ_TITLE": "Domande Frequenti",
-  "FAQ_SUBTITLE": "Tutto quello che c'è da sapere sulla visione dei video insieme in perfetta sincronia.",
-  "FAQ_Q1": "Posso guardare Netflix, Emby o Jellyfin in sincronia con gli amici?",
-  "FAQ_A1": "Sì! KoalaSync funziona su Netflix, YouTube, Twitch e qualsiasi sito web con un lettore video HTML5 — inclusi Emby, Jellyfin e server multimediali personalizzati. Installa l'estensione, crea una stanza, condividi il link di invito e tutti guarderanno in perfetta sincronia.",
-  "FAQ_Q2": "KoalaSync è un'alternativa gratuita a Teleparty?",
-  "FAQ_A2": "Gratuito al 100% e open source con licenza MIT. Nessun piano premium, nessuna funzionalità bloccata, nessuna pubblicità — tutto è incluso. A differenza di Teleparty, il server di inoltro di KoalaSync è solo in RAM, con zero raccolta dati o account utente richiesti.",
-  "FAQ_Q3": "KoalaSync funziona con Emby, Jellyfin e server multimediali ospitati in proprio?",
-  "FAQ_A3": "Sì. KoalaSync rileva qualsiasi elemento video HTML5 standard, il che significa che funziona perfettamente con Emby, Jellyfin, Plex e qualsiasi configurazione di streaming personalizzata. Puoi anche ospitare autonomamente il server di inoltro tramite Docker.",
-  "FAQ_Q4": "Quali browser e piattaforme supportano KoalaSync?",
-  "FAQ_A4": "Google Chrome, Mozilla Firefox, Microsoft Edge, Opera, Brave e tutti i browser basati su Chromium. Installalo direttamente dal Chrome Web Store o da Firefox Add-ons — non è richiesta alcuna configurazione manuale.",
-  "FAQ_Q5": "Tutti i miei amici devono avere l'estensione installata?",
-  "FAQ_A5": "Sì, ogni partecipante deve avere KoalaSync installato — ma non è richiesta alcuna registrazione o creazione di account. Fai clic sul link di invito, installa l'estensione se non l'hai già fatto ed entrerai automaticamente nella stanza in pochi secondi.",
-  "FAQ_Q6": "I miei dati sono al sicuro? E se non mi fido del server ufficiale?",
-  "FAQ_A6": "Completamente al sicuro. Il server di inoltro di KoalaSync è solo in RAM — tutti i dati della sessione vengono eliminati permanentemente nel momento in cui lasci la stanza. Nessun database, nessun log, nessuna analisi, nessun account. E se preferisci il controllo totale: puoi ospitare autonomamente il tuo server di inoltro privato tramite Docker in pochi minuti. L'intera codebase è open source e controllabile su GitHub.",
-  "HOWTO_TITLE": "Come sincronizzare i video con gli amici usando KoalaSync",
-  "HOWTO_DESC": "Guarda qualsiasi video in perfetta sincronia con gli amici su YouTube, Netflix, Twitch e altri. Nessuna registrazione, nessun tracciamento.",
-  "HOWTO_STEP_1_NAME": "Installa l'estensione del browser",
-  "HOWTO_STEP_1_TEXT": "Aggiungi KoalaSync al tuo browser dal Chrome Web Store o da Firefox Add-ons. Funziona su qualsiasi sito web con un elemento video.",
+  "FAQ_SUBTITLE": "Tutto quello che c'è da sapere per guardare video in perfetta sincronia.",
+  "FAQ_Q1": "Posso guardare Netflix o YouTube in sincronia?",
+  "FAQ_A1": "Certamente! KoalaSync funziona su Netflix, YouTube, Twitch e qualsiasi sito con video HTML5. Basta installare l'estensione, creare una stanza e condividere il link.",
+  "FAQ_Q2": "KoalaSync è gratuito?",
+  "FAQ_A2": "Sì, al 100%. È open source con licenza MIT. Non ci sono funzioni a pagamento né pubblicità. A differenza di altre app, non raccogliamo dati utente.",
+  "FAQ_Q3": "Funziona con Emby o Jellyfin?",
+  "FAQ_A3": "Sì. KoalaSync è compatibile con qualsiasi player HTML5, inclusi server multimediali come Plex, Emby e Jellyfin.",
+  "FAQ_Q4": "Quali browser sono supportati?",
+  "FAQ_A4": "Chrome, Firefox, Edge, Opera, Brave e tutti i browser basati su Chromium.",
+  "FAQ_Q5": "I miei amici devono installare l'estensione?",
+  "FAQ_A5": "Sì, ogni partecipante deve avere KoalaSync. Non serve registrarsi: basta cliccare sul link e si entra subito nella stanza.",
+  "FAQ_Q6": "I miei dati sono al sicuro?",
+  "FAQ_A6": "Assolutamente. Usiamo solo la RAM del server per inoltrare i segnali; nulla viene salvato in database o log. Quando chiudi la stanza, i dati spariscono per sempre.",
+  "FAQ_Q7": "Posso migliorare l'audio dei film?",
+  "FAQ_A7": "Sì. KoalaSync include un compressore audio che rende le voci più chiare e attenua i rumori troppo forti. Lo trovi in Impostazioni → Elaborazione Audio.",
+  "HOWTO_TITLE": "Come sincronizzare i video con gli amici",
+  "HOWTO_DESC": "Guarda video in perfetta sincronia su YouTube, Netflix e Twitch. Senza account.",
+  "HOWTO_STEP_1_NAME": "Installa l'estensione",
+  "HOWTO_STEP_1_TEXT": "Aggiungi KoalaSync al tuo browser dalle store ufficiali.",
  "HOWTO_STEP_2_NAME": "Crea una stanza",
-  "HOWTO_STEP_2_TEXT": "Apri il popup dell'estensione e fai clic su Crea Nuova Stanza. Il link di invito viene copiato automaticamente negli appunti.",
+  "HOWTO_STEP_2_TEXT": "Apri l'estensione e crea una stanza. Copia il link di invito.",
  "HOWTO_STEP_3_NAME": "Condividi e sincronizza",
-  "HOWTO_STEP_3_TEXT": "Invia il link di invito ai tuoi amici. Scegli una scheda video e goditi la riproduzione sincronizzata in tempo reale.",
-  "FOOTER_MIT": "Open source con licenza MIT.",
-  "FOOTER_RAM": "Nessun dato viene memorizzato sui nostri server. Inoltro basato esclusivamente su RAM.",
+  "HOWTO_STEP_3_TEXT": "Invia il link ai tuoi amici e godetevi il film insieme.",
+  "FOOTER_MIT": "Codice aperto con licenza MIT.",
+  "FOOTER_RAM": "Nessun dato salvato. Retrasmissione basata su RAM.",
  "FOOTER_LEGAL": "Note Legali",
-  "FOOTER_PRIVACY": "Informativa sulla Privacy",
+  "FOOTER_PRIVACY": "Privacy",
  "MOCK_01": "Stanza Attiva",
  "MOCK_02": "Server Ufficiale",
  "MOCK_03": "Link di Invito",
-  "MOCK_04": "Partecipanti nella Stanza",
-  "MOCK_05": "YOU",
-  "MOCK_06": "Playing",
-  "MOCK_07": "Peer",
-  "MOCK_08": "Lascia Stanza",
-  "MOCK_09": "Seleziona Video",
-  "MOCK_10": "Controllo Remoto",
-  "MOCK_11": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\" width=\"14\" height=\"14\" aria-hidden=\"true\"><polygon points=\"5 3 19 12 5 21 5 3\"/></svg> Play",
-  "MOCK_12": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\" width=\"14\" height=\"14\" aria-hidden=\"true\"><rect x=\"6\" y=\"4\" width=\"4\" height=\"16\"/><rect x=\"14\" y=\"4\" width=\"4\" height=\"16\"/></svg> Pause",
-  "MOCK_13": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" width=\"14\" height=\"14\" aria-hidden=\"true\"><polygon points=\"13 2 3 14 12 14 11 22 21 10 12 10 13 2\"/></svg> SYNC",
-  "MOCK_14": "Salto dagli Altri",
-  "MOCK_15": "Stato Ultima Attività",
-  "MOCK_16": "In attesa di 1 partecipante (KoalaPC)...",
-  "MOCK_17": "Salta e riproduci comunque",
-  "MOCK_18": "Tuo Nome Utente",
-  "MOCK_19": "Nascondi Schede Inutili",
-  "MOCK_20": "Auto-Sync Prossimo Episodio",
-  "MOCK_21": "Copia Automatica Invito",
-  "MOCK_22": "Notifiche del Browser",
-  "MOCK_23": "Risoluzione Problemi",
-  "MOCK_24": "Rigenera ID Peer",
-  "MOCK_25": "Usa questo se riscontri errori di \"Identità Duplicata\".",
-  "MOCK_26": "Stato Connessione",
-  "MOCK_27": "Connected",
+  "MOCK_04": "Partecipanti",
+  "MOCK_05": "TU",
+  "MOCK_06": "In riproduzione",
+  "MOCK_07": "Partecipante",
+  "MOCK_08": "Esci dalla stanza",
+  "MOCK_09": "Scegli Video",
+  "MOCK_10": "Telecomando",
+  "MOCK_11": "Play",
+  "MOCK_12": "Pausa",
+  "MOCK_13": "SINCRO",
+  "MOCK_14": "Vai dagli altri",
+  "MOCK_15": "Ultima attività",
+  "MOCK_16": "In attesa di un amico (KoalaPC)...",
+  "MOCK_17": "Salta l'attesa",
+  "MOCK_18": "Tuo Nome",
+  "MOCK_19": "Nascondi schede",
+  "MOCK_20": "Sincro auto episodi",
+  "MOCK_21": "Copia auto link",
+  "MOCK_22": "Notifiche",
+  "MOCK_23": "Risoluzione problemi",
+  "MOCK_24": "Nuovo ID Utente",
+  "MOCK_25": "Risolve errori di 'Identità duplicata'.",
+  "MOCK_26": "Connessione",
+  "MOCK_27": "Connesso",
  "MOCK_28": "Copia Log",
-  "MOCK_29": "Info Debug Video",
-  "MOCK_30": "Cronologia Azioni Completa",
-  "MOCK_31": "Log (Ultimi 50)",
+  "MOCK_29": "Debug Video",
+  "MOCK_30": "Cronologia",
+  "MOCK_31": "Log",
  "MOCK_32": "PULISCI",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync non è affiliato a Netflix, YouTube o altre piattaforme. I marchi appartengono ai rispettivi proprietari.",
  "FOOTER_SUPPORT": "Offrimi un caffè su Ko-Fi"
 }
@@ -2,7 +2,7 @@
  "LANG_CODE": "ja",
  "HTML_CLASS": "lang-ja",
  "CANONICAL_PATH": "ja/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "ja_JP",
  "META_TITLE": "KoalaSync | Netflix、YouTube、あらゆる動画を友達と同期視聴",
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Netflix、Emby、Jellyfin、YouTube、Twitch、ほぼすべてのHTML5動画を友達と完全に同期して視聴。ChromeおよびFirefox用のプライバシー優先のオープンソースブラウザ拡張機能。",
  "NAV_FEATURES": "機能",
  "NAV_HOW_IT_WORKS": "仕組み",
-  "HERO_TITLE": "一緒に観よう。<br>完璧に同期。",
+  "HERO_TITLE": "一緒に観よう。<span class='hero-line2'>完璧に同期。</span>",
  "HERO_SUBTITLE": "遅延のないリモート映画鑑賞。登録不要、データ収集なし。リンクを共有するだけで、一緒に視聴できます。",
  "HERO_MASCOT_ALT": "ダウンロードボタンを見下ろしているかわいいコアラ",
  "ADD_TO_CHROME": "Chromeに追加",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "アカウント不要 / 純粋なプライバシー",
  "FEATURE_3_DESC": "登録不要、追跡なし、履歴も残りません。サーバーは一時的なメモリ（RAM）上でのみ動作し、退出時にルームを完全に消去します。",
  "FEATURE_4_TITLE": "ユニバーサルHTML5サポート",
-  "FEATURE_4_DESC": "YouTube、Twitch、Netflix、Jellyfin、Emby、およびHTML5ビデオ要素を含むほぼすべての標準的なWebページで動作します。独自のセルフホスト設定とも互換性があります。",
+  "FEATURE_4_DESC": "YouTube、Twitch、Netflix、Jellyfin、Emby、およびHTML5ビデオ要素を含むほぼすべての標準的なWebページで動作します。独自のセルフホスト設定とも互換性があります。No video data is ever sent to our servers — only synchronization metadata.",
  "FEATURE_5_TITLE": "セルフホスト可能＆Docker対応",
  "FEATURE_5_DESC": "公式サーバーは無料で高速ですが、必要に応じて独自のサーバーを構築できます。Dockerを使用して、数秒でプライベートリレーサーバーを起動できます。",
  "FEATURE_6_TITLE": "インスタント招待 / 1クリック参加",
  "FEATURE_6_DESC": "IPアドレスやパスワードをやり取りする必要はありません。生成された招待リンクを友達に共有するだけで、1クリックで自動的にルームに参加できます。",
+  "FEATURE_7_TITLE": "音量均等化 / オーディオコンプレッサー",
+  "FEATURE_7_DESC": "音量つまみをいじる必要はもうありません。内蔵オーディオコンプレッサーが小さな会話を強調し、大きな爆発音を抑えます。Netflix、Prime Video、Disney+、YouTube、あらゆるHTML5ビデオで動作。完全にローカル処理 — オーディオデータがコンピュータから送信されることはありません。",
+  "FEATURE_8_TITLE": "オープンソース（MITライセンス）",
+  "FEATURE_8_DESC": "すべてのコードベースはGitHubで公開されており、誰でも監査可能です。ブラックボックスや独自のバイナリデータ（blob）は一切なく、中継サーバーからブラウザ拡張機能まで100%の透明性を確保しています。",
  "COMP_TITLE": "KoalaSync と Teleparty の比較",
  "COMP_SUBTITLE": "オープンソース、広告なし、プライバシー優先が、一緒に動画を観る上でいかに優れているかをご覧ください。",
  "COMP_COL_FEATURE": "機能",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "利用可能なインターフェース言語と翻訳サポート。",
  "COMP_FEAT_6_KOALA": "13の言語（今後も追加予定）",
  "COMP_FEAT_6_TELE": "英語のみ",
+  "COMP_FEAT_7_NAME": "オーディオコンプレッサー / 音量均等化",
+  "COMP_FEAT_7_DESC": "静かな会話と大きな効果音のバランスを取る内蔵オーディオノーマライゼーション",
+  "COMP_FEAT_7_KOALA": "はい（4プリセット、ドライ/ウェットコントロール）",
+  "COMP_FEAT_7_TELE": "いいえ",
  "COMP_FOOTNOTE_1": "比較時点: 2026年5月。",
  "COMP_FOOTNOTE_2": "公式 Teleparty Premium の価格設定と対応ネットワークの詳細:",
  "COMP_FOOTNOTE_3": "Telepartyのプライバシーポリシーと追跡データの収集について:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "はい、参加者全員にKoalaSyncがインストールされている必要があります。ただし、登録やアカウント作成は不要です。招待リンクをクリックし、未インストールの場合は拡張機能をインストールすれば、数秒で自動的にルームに参加できます。",
  "FAQ_Q6": "データは安全ですか？ 公式サーバーを信頼できない場合は？",
  "FAQ_A6": "完全に安全です。KoalaSyncのリレーサーバーはメモリ上のみで動作するため、ルームを退出した瞬間にすべてのセッションデータが永久に削除されます。データベース、ログ、分析、アカウントは一切ありません。さらに、完全に管理したい場合は、Dockerを介して独自のプライベートリレーサーバーを数分でセルフホストできます。コードベース全体がオープンソースであり、GitHubで監査可能です。",
+  "FAQ_Q7": "ブラウザで動画を視聴する際、小さな会話と大きな爆発音を改善できますか？",
+  "FAQ_A7": "はい。KoalaSync 2.2.0には、動画の静かな部分と騒がしい部分の差を減らす内蔵オーディオコンプレッサーが搭載されています。Web Audio APIを介してローカルで動作するため、オーディオデータがコンピュータから送信されることはありません。ポップアップを開き、ルームを作成し、設定 → Audio Processingに進み、コンプレッサーを有効にしてプリセットを選択してください。Netflix、Prime Video、Disney+、YouTube、あらゆるHTML5ビデオサイトで動作します。",
  "HOWTO_TITLE": "KoalaSyncを使用して友達とビデオを同期視聴する方法",
  "HOWTO_DESC": "YouTube、Netflix、Twitchなどで、友達と完全に同期してあらゆる動画を視聴。登録不要、追跡なし。",
  "HOWTO_STEP_1_NAME": "ブラウザ拡張機能をインストールする",
@@ -164,5 +174,6 @@
  "MOCK_32": "消去",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSyncは、Netflix、Disney+、Amazon、YouTube、Twitch、またはその他のストリーミングプラットフォームと提携、承認、または関連付けられているものではありません。すべての商標はそれぞれの所有者に帰属します。",
  "FOOTER_SUPPORT": "Ko-Fiでコーヒーをおごる"
 }
@@ -2,7 +2,7 @@
  "LANG_CODE": "ko",
  "HTML_CLASS": "lang-ko",
  "CANONICAL_PATH": "ko/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "ko_KR",
  "META_TITLE": "KoalaSync | Netflix, YouTube 및 모든 비디오를 친구와 실시간 동기화 시청",
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Netflix, Emby, Jellyfin, YouTube, Twitch 및 거의 모든 HTML5 비디오를 친구들과 완벽하게 동기화하여 시청하세요. Chrome 및 Firefox용 개인정보 보호 중심 오픈 소스 브라우저 확장 프로그램.",
  "NAV_FEATURES": "특징",
  "NAV_HOW_IT_WORKS": "작동 방식",
-  "HERO_TITLE": "함께 시청하세요.<br>완벽하게 동기화됩니다.",
+  "HERO_TITLE": "함께 시청하세요.<span class='hero-line2'>완벽하게 동기화됩니다.</span>",
  "HERO_SUBTITLE": "지연 없는 원격 영화의 밤. 회원가입도, 데이터 수집도 없습니다. 링크를 공유하고 함께 시청하세요.",
  "HERO_MASCOT_ALT": "다운로드 버튼을 내려다보고 서 있는 귀여운 코알라",
  "ADD_TO_CHROME": "Chrome에 추가",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "계정 없음 / 완전한 개인정보 보호",
  "FEATURE_3_DESC": "회원가입 없음, 추적 없음, 흔적을 남기지 않습니다. 서버는 휘발성 RAM에서만 완전히 실행되며 방을 나가면 영구히 삭제됩니다.",
  "FEATURE_4_TITLE": "범용 HTML5 지원",
-  "FEATURE_4_DESC": "YouTube, Twitch, Netflix, Jellyfin, Emby 및 HTML5 비디오 요소가 포함된 거의 모든 웹 페이지에서 작동합니다. 사용자 정의 자체 호스팅 설정과도 호환됩니다.",
+  "FEATURE_4_DESC": "YouTube, Twitch, Netflix, Jellyfin, Emby 및 HTML5 비디오 요소가 포함된 거의 모든 웹 페이지에서 작동합니다. 사용자 정의 자체 호스팅 설정과도 호환됩니다. 비디오 데이터는 당사 서버로 절대 전송되지 않으며, 동기화 메타데이터만 전송됩니다.",
  "FEATURE_5_TITLE": "자체 호스팅 가능 및 Docker 지원",
  "FEATURE_5_DESC": "공식 서버는 무료이며 빠르지만, 원하는 경우 직접 호스팅할 수도 있습니다. Docker를 통해 몇 초 만에 나만의 개인 릴레이 서버를 구축해 보세요.",
  "FEATURE_6_TITLE": "즉시 초대 / 클릭 한 번으로 참여",
  "FEATURE_6_DESC": "IP 주소나 비밀번호를 교환할 필요가 없습니다. 생성된 초대 링크를 친구들과 공유하면 클릭 한 번으로 방에 자동으로 참여할 수 있습니다.",
+  "FEATURE_7_TITLE": "볼륨 레벨링 / 오디오 압축기",
+  "FEATURE_7_DESC": "더 이상 볼륨 노브를 계속 조정하지 마세요. 내장 오디오 압축기가 조용한 대화를 증폭하고 큰 폭발음을 완화합니다. Netflix, Prime Video, Disney+, YouTube 및 모든 HTML5 비디오에서 작동합니다. 완전히 로컬에서 처리 — 오디오 데이터가 컴퓨터를 떠나지 않습니다.",
+  "FEATURE_8_TITLE": "오픈 소스 (MIT 라이선스)",
+  "FEATURE_8_DESC": "모든 코드베이스는 GitHub에서 공개적으로 검토할 수 있습니다. 블랙박스나 독점적인 블롭(blob)이 전혀 없으며, 릴레이 서버부터 브라우저 확장 프로그램까지 100% 투명성을 보장합니다.",
  "COMP_TITLE": "KoalaSync 대 Teleparty",
  "COMP_SUBTITLE": "오픈 소스, 광고 없음, 개인정보 보호 중심의 서비스가 왜 함께 시청하기에 더 우수한지 확인해 보세요.",
  "COMP_COL_FEATURE": "기능",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "제공되는 인터페이스 언어 및 번역 지원 여부.",
  "COMP_FEAT_6_KOALA": "13개 언어 지원 (추가 중)",
  "COMP_FEAT_6_TELE": "영어만 지원",
+  "COMP_FEAT_7_NAME": "오디오 압축기 / 볼륨 레벨링",
+  "COMP_FEAT_7_DESC": "조용한 대화와 큰 효과음의 균형을 맞추는 내장 오디오 노멀라이제이션",
+  "COMP_FEAT_7_KOALA": "예 (4개 프리셋, dry/wet 제어)",
+  "COMP_FEAT_7_TELE": "아니요",
  "COMP_FOOTNOTE_1": "비교 기준일: 2026년 5월.",
  "COMP_FOOTNOTE_2": "공식 Teleparty Premium 요금제 및 지원되는 네트워크 세부 정보:",
  "COMP_FOOTNOTE_3": "Teleparty 개인정보 처리방침 및 추적 데이터 수집 정보:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "네, 각 참여자 모두 KoalaSync를 설치해야 합니다. 단, 가입이나 계정 생성은 필요하지 않습니다. 초대 링크를 클릭하고, 아직 설치하지 않았다면 확장 프로그램을 설치하면 몇 초 만에 자동으로 방에 참여하게 됩니다.",
  "FAQ_Q6": "제 데이터는 안전한가요? 공식 서버를 믿지 못하겠다면 어떻게 하나요?",
  "FAQ_A6": "완전히 안전합니다. KoalaSync의 릴레이 서버는 RAM 전용으로 작동하여, 방을 나가는 즉시 모든 세션 데이터가 영구적으로 삭제됩니다. 데이터베이스도, 로그도, 분석도, 계정도 없습니다. 완전한 제어를 원하신다면 Docker를 통해 몇 분 만에 나만의 개인 릴레이 서버를 직접 호스팅할 수 있습니다. 전체 소스 코드는 오픈 소스이며 GitHub에서 확인할 수 있습니다.",
+  "FAQ_Q7": "브라우저에서 비디오를 시청할 때 조용한 대화와 큰 폭발음을 개선할 수 있나요?",
+  "FAQ_A7": "네. KoalaSync 2.2.0에는 비디오의 조용한 부분과 시끄러운 부분 간의 차이를 줄이는 내장 오디오 압축기가 포함되어 있습니다. Web Audio API를 통해 로컬에서 실행되므로 오디오 데이터가 컴퓨터를 떠나지 않습니다. 팝업을 열고, 방을 만들고, 설정 → Audio Processing으로 이동하여 압축기를 켜고 프리셋을 선택하세요. Netflix, Prime Video, Disney+, YouTube 및 모든 HTML5 비디오 사이트에서 작동합니다.",
  "HOWTO_TITLE": "KoalaSync를 사용하여 친구들과 비디오를 동기화하는 방법",
  "HOWTO_DESC": "YouTube, Netflix, Twitch 등에서 친구들과 완벽하게 동기화하여 비디오를 시청하세요. 가입 없음, 추적 없음.",
  "HOWTO_STEP_1_NAME": "브라우저 확장 프로그램 설치",
@@ -164,5 +174,6 @@
  "MOCK_32": "지우기",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync는 Netflix, Disney+, Amazon, YouTube, Twitch 또는 기타 스트리밍 플랫폼과 제휴, 보증 또는 연관되어 있지 않습니다. 모든 상표는 해당 소유자의 재산입니다.",
  "FOOTER_SUPPORT": "Ko-Fi에서 커피 한 잔 사주세요"
 }
@@ -2,7 +2,7 @@
  "LANG_CODE": "nl",
  "HTML_CLASS": "lang-nl",
  "CANONICAL_PATH": "nl/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "nl_NL",
  "META_TITLE": "KoalaSync | Synchroniseer Netflix, YouTube & elke video met vrienden",
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Bekijk Netflix, Emby, Jellyfin, YouTube, Twitch en bijna elke HTML5-video in perfecte synchronisatie met vrienden. Privacy-first, open-source browserextensie voor Chrome en Firefox.",
  "NAV_FEATURES": "Functies",
  "NAV_HOW_IT_WORKS": "Hoe het werkt",
-  "HERO_TITLE": "Samen Kijken.<br>Perfect Synchroniseren.",
+  "HERO_TITLE": "Samen Kijken.<span class='hero-line2'>Perfect Synchroniseren.</span>",
  "HERO_SUBTITLE": "Uw filmavond op afstand zonder vertraging. Geen registratie, geen gegevensverzameling. Deel gewoon een link en kijk samen.",
  "HERO_MASCOT_ALT": "Een schattige koala die staat en naar beneden kijkt naar de downloadknoppen",
  "ADD_TO_CHROME": "Toevoegen aan Chrome",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Geen accounts / Pure privacy",
  "FEATURE_3_DESC": "Geen registratie, geen tracking, geen permanente voetafdruk. De server draait volledig in het tijdelijke RAM en wist uw kamer wanneer u vertrekt.",
  "FEATURE_4_TITLE": "Universele HTML5-ondersteuning",
-  "FEATURE_4_DESC": "Werkt op YouTube, Twitch, Netflix, Jellyfin, Emby en bijna elke standaard webpagina met een HTML5-video-element. Ook compatibel met aangepaste zelfgehoste installaties.",
+  "FEATURE_4_DESC": "Werkt op YouTube, Twitch, Netflix, Jellyfin, Emby en bijna elke standaard webpagina met een HTML5-video-element. Ook compatibel met aangepaste zelfgehoste installaties. Er worden nooit videogegevens naar onze servers verzonden — alleen synchronisatiemetagegevens.",
  "FEATURE_5_TITLE": "Zelf te hosten & Docker-ready",
  "FEATURE_5_DESC": "Onze officiële servers zijn gratis en snel, maar u kunt de volledige controle nemen als u dat wilt. Start uw eigen privé-relayserver in seconden via Docker.",
  "FEATURE_6_TITLE": "Directe uitnodigingen / 1-klik deelname",
  "FEATURE_6_DESC": "Geen IP-adressen of wachtwoorden om uit te wisselen. Deel een gegenereerde uitnodigingslink met uw vrienden om ze met een enkele klik automatisch deel te laten nemen.",
+  "FEATURE_7_TITLE": "Volume egaliseren / Audiocompressor",
+  "FEATURE_7_DESC": "Niet langer aan de volumeknop zitten. De ingebouwde audiocompressor versterkt stille dialogen en dempt harde explosies. Werkt op Netflix, Prime Video, Disney+, YouTube en elke HTML5-video. Volledig lokaal — geen audiogegevens verlaten uw computer.",
+  "FEATURE_8_TITLE": "Open Source (MIT License)",
+  "FEATURE_8_DESC": "The entire codebase is publicly auditable on GitHub. No black boxes, no proprietary blobs — 100% transparency from the relay server to the browser extension.",
  "COMP_TITLE": "KoalaSync vs. Teleparty",
  "COMP_SUBTITLE": "Ontdek waarom open-source, reclamevrij en privacy-first de superieure manier is om samen te kijken.",
  "COMP_COL_FEATURE": "Functie",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Beschikbare interfacetalen en vertaalondersteuning.",
  "COMP_FEAT_6_KOALA": "13 talen (en groeiend)",
  "COMP_FEAT_6_TELE": "Alleen Engels",
+  "COMP_FEAT_7_NAME": "Audiocompressor / Volume Egaliseren",
+  "COMP_FEAT_7_DESC": "Ingebouwde audionormalisatie om stille dialogen en luide effecten in balans te brengen",
+  "COMP_FEAT_7_KOALA": "Ja (4 presets, dry/wet-regeling)",
+  "COMP_FEAT_7_TELE": "Nee",
  "COMP_FOOTNOTE_1": "Vergelijkingstijdstip: Mei 2026.",
  "COMP_FOOTNOTE_2": "Officiële Teleparty Premium-prijzen en ondersteunde netwerkdetails:",
  "COMP_FOOTNOTE_3": "Teleparty privacybeleid en trackinggegevensverzameling:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Ja, elke deelnemer moet KoalaSync geïnstalleerd hebben — maar er is geen aanmelding of accountcreatie. Klik gewoon op de uitnodigingslink, installeer de extensie als u dat nog niet hebt gedaan, en u neemt binnen enkele seconden automatisch deel aan de kamer.",
  "FAQ_Q6": "Zijn mijn gegevens veilig? Wat als ik de officiële server niet vertrouw?",
  "FAQ_A6": "Volledig veilig. De relayserver van KoalaSync is alleen in het RAM-geheugen — alle sessiegegevens worden permanent verwijderd zodra u de kamer verlaat. Geen database, geen logboeken, geen analyses, geen accounts. En als u de voorkeur geeft aan volledige controle: u kunt uw eigen privé-relayserver binnen enkele minuten zelf hosten via Docker. De volledige codebase is open-source en auditeerbaar op GitHub.",
+  "FAQ_Q7": "Kan ik stille dialogen en harde explosies oplossen bij het kijken van video's in de browser?",
+  "FAQ_A7": "Ja. KoalaSync 2.2.0 bevat een ingebouwde audiocompressor die het verschil tussen stille en luidruchtige delen van uw video verkleint. Het werkt lokaal via de Web Audio API — geen audiogegevens verlaten ooit uw computer. Open de popup, maak een kamer, ga naar Instellingen → Audio Processing, schakel de compressor in en kies een preset. Werkt op Netflix, Prime Video, Disney+, YouTube en elke HTML5-videosite.",
  "HOWTO_TITLE": "Hoe video's te synchroniseren met vrienden via KoalaSync",
  "HOWTO_DESC": "Bekijk elke video in perfecte synchronisatie met vrienden op YouTube, Netflix, Twitch en meer. Geen aanmelding, geen tracking.",
  "HOWTO_STEP_1_NAME": "Installeer de browserextensie",
@@ -164,5 +174,6 @@
  "MOCK_32": "WISSEN",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync is niet verbonden aan, goedgekeurd door of geassocieerd met Netflix, Disney+, Amazon, YouTube, Twitch of enig ander streamingplatform. Alle handelsmerken zijn eigendom van hun respectieve eigenaren.",
  "FOOTER_SUPPORT": "Trakteer op een koffie via Ko-Fi"
 }
@@ -2,7 +2,7 @@
  "LANG_CODE": "pl",
  "HTML_CLASS": "lang-pl",
  "CANONICAL_PATH": "pl/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "pl_PL",
  "META_TITLE": "KoalaSync | Synchronizuj Netflix, YouTube i dowolne wideo ze znajomymi",
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Oglądaj Netflix, Emby, Jellyfin, YouTube, Twitch i prawie każde wideo HTML5 w idealnej synchronizacji ze znajomymi. Zorientowane na prywatność rozszerzenie o otwartym kodzie dla Chrome i Firefox.",
  "NAV_FEATURES": "Funkcje",
  "NAV_HOW_IT_WORKS": "Jak to działa",
-  "HERO_TITLE": "Oglądajcie Razem.<br>Synchronizujcie Idealnie.",
+  "HERO_TITLE": "Oglądajcie Razem.<span class='hero-line2'>Synchronizujcie Idealnie.</span>",
  "HERO_SUBTITLE": "Twój zdalny wieczór filmowy bez opóźnień. Bez rejestracji, bez zbierania danych. Po prostu udostępnij link i oglądajcie razem.",
  "HERO_MASCOT_ALT": "Uroczy koala stojący i patrzący w dół na przyciski pobierania",
  "ADD_TO_CHROME": "Dodaj do Chrome",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Zero kont / Czysta prywatność",
  "FEATURE_3_DESC": "Bez rejestracji, bez śledzenia, bez trwałych śladów. Serwer działa w całości w pamięci RAM i czyści Twój pokój, gdy go opuszczasz.",
  "FEATURE_4_TITLE": "Uniwersalne wsparcie HTML5",
-  "FEATURE_4_DESC": "Działa na YouTube, Twitch, Netflix, Jellyfin, Emby i prawie każdej standardowej stronie z elementem wideo HTML5. Kompatybilny również z własnymi serwerami.",
+  "FEATURE_4_DESC": "Działa na YouTube, Twitch, Netflix, Jellyfin, Emby i prawie każdej standardowej stronie z elementem wideo HTML5. Kompatybilny również z własnymi serwerami. Żadne dane wideo nigdy nie są wysyłane na nasze serwery — jedynie metadane synchronizacji.",
  "FEATURE_5_TITLE": "Możliwość własnego hostowania i wsparcie Docker",
  "FEATURE_5_DESC": "Nasze oficjalne serwery są darmowe i szybkie, ale możesz przejąć pełną kontrolę, jeśli chcesz. Uruchom własny serwer w kilka sekund za pomocą Dockera.",
  "FEATURE_6_TITLE": "Natychmiastowe zaproszenia / Dołączanie 1 kliknięciem",
  "FEATURE_6_DESC": "Bez wymiany adresów IP czy haseł. Udostępnij wygenerowany link zaproszenia znajomym, aby mogli automatycznie dołączyć do pokoju jednym kliknięciem.",
+  "FEATURE_7_TITLE": "Wyrównywanie głośności / Kompresor audio",
+  "FEATURE_7_DESC": "Koniec z ciągłym regulowaniem głośności. Wbudowany kompresor audio wzmacnia ciche dialogi i łagodzi głośne eksplozje. Działa na Netflix, Prime Video, Disney+, YouTube i każdym filmie HTML5. W pełni lokalny — żadne dane audio nie opuszczają twojego komputera.",
+  "FEATURE_8_TITLE": "Open Source (Licencja MIT)",
+  "FEATURE_8_DESC": "Cały kod źródłowy jest publicznie dostępny i możliwy do zweryfikowania na GitHubie. Żadnych czarnych skrzynek, żadnych własnościowych obiektów blob — 100% przejrzystości od serwera przekaźnikowego (relay server) po rozszerzenie przeglądarki.",
  "COMP_TITLE": "KoalaSync vs. Teleparty",
  "COMP_SUBTITLE": "Zobacz, dlaczego otwarty kod, brak reklam i ochrona prywatności to lepszy sposób na wspólne oglądanie.",
  "COMP_COL_FEATURE": "Funkcja",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Dostępne języki interfejsu i wsparcie tłumaczeń.",
  "COMP_FEAT_6_KOALA": "13 języków (i rośnie)",
  "COMP_FEAT_6_TELE": "Tylko angielski",
+  "COMP_FEAT_7_NAME": "Kompresor Audio / Wyrównywanie Głośności",
+  "COMP_FEAT_7_DESC": "Wbudowana normalizacja dźwięku do równoważenia cichych dialogów i głośnych efektów",
+  "COMP_FEAT_7_KOALA": "Tak (4 presetów, kontrola dry/wet)",
+  "COMP_FEAT_7_TELE": "Nie",
  "COMP_FOOTNOTE_1": "Stan porównania: Maj 2026.",
  "COMP_FOOTNOTE_2": "Szczegóły oficjalnych cen Teleparty Premium i obsługiwanych sieci:",
  "COMP_FOOTNOTE_3": "Polityka prywatności Teleparty i zbieranie danych śledzenia:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Tak, każdy uczestnik musi mieć zainstalowane KoalaSync — ale nie ma rejestracji ani tworzenia kont. Po prostu kliknij link zaproszenia, zainstaluj rozszerzenie, jeśli jeszcze tego nie zrobiłeś, a dołączysz do pokoju automatycznie w kilka sekund.",
  "FAQ_Q6": "Czy moje dane są bezpieczne? Co jeśli nie ufam oficjalnemu serwerowi?",
  "FAQ_A6": "Całkowicie bezpieczne. Serwer KoalaSync działa tylko w pamięci RAM — wszystkie dane sesji są trwale usuwane w momencie opuszczenia pokoju. Brak bazy danych, brak logowania, brak analityki, brak kont. A jeśli wolisz pełną kontrolę: możesz samodzielmente uruchomić własny serwer przez Dockera w kilka minut. Cały kod źródłowy jest otwarty i dostępny na GitHubie.",
+  "FAQ_Q7": "Czy mogę naprawić ciche dialogi i głośne eksplozje podczas oglądania filmów w przeglądarce?",
+  "FAQ_A7": "Tak. KoalaSync 2.2.0 zawiera wbudowany kompresor audio, który zmniejsza różnicę między cichymi a głośnymi częściami filmu. Działa lokalnie przez Web Audio API — żadne dane audio nie opuszczają twojego komputera. Otwórz popup, utwórz pokój, przejdź do Ustawienia → Audio Processing, włącz kompresor i wybierz preset. Działa na Netflix, Prime Video, Disney+, YouTube i każdej stronie z wideo HTML5.",
  "HOWTO_TITLE": "Jak synchronizować wideo ze znajomymi za pomocą KoalaSync",
  "HOWTO_DESC": "Oglądaj dowolne wideo w idealnej synchronizacji ze znajomymi na YouTube, Netflix, Twitch i innych. Bez rejestracji, bez śledzenia.",
  "HOWTO_STEP_1_NAME": "Zainstaluj rozszerzenie przeglądarki",
@@ -164,5 +174,6 @@
  "MOCK_32": "WYCZYŚĆ",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync nie jest powiązany, wspierany ani stowarzyszony z Netflix, Disney+, Amazon, YouTube, Twitch ani żadną inną platformą streamingową. Wszystkie znaki towarowe są własnością ich odpowiednich właścicieli.",
  "FOOTER_SUPPORT": "Postaw kawę na Ko-Fi"
 }
@@ -6,163 +6,174 @@
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "pt_BR",
  "META_TITLE": "KoalaSync | Sincronize Netflix, YouTube e qualquer vídeo com amigos",
-  "META_DESCRIPTION": "Assista Netflix, YouTube, Twitch e qualquer vídeo HTML5 em perfeita sincronia com amigos. Extensão de navegador gratuita e de código aberto. Sem registro.",
-  "OG_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e quase qualquer vídeo com amigos",
-  "OG_DESCRIPTION": "Assista à Netflix, Emby, Jellyfin, YouTube, Twitch e quase qualquer vídeo HTML5 em perfeita sincronia. Extensão de navegador de código aberto e focada em privacidade para Chrome e Firefox.",
-  "TWITTER_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e quase qualquer vídeo com amigos – Extensão de navegador",
-  "TWITTER_DESCRIPTION": "Assista à Netflix, Emby, Jellyfin, YouTube, Twitch e quase qualquer vídeo HTML5 em perfeita sincronia com amigos. Extensão de navegador de código aberto e focada em privacidade para Chrome e Firefox.",
+  "META_DESCRIPTION": "Assista Netflix, YouTube, Twitch e qualquer vídeo HTML5 em perfeita sincronia. Extensão de navegador gratuita e open source. Sem cadastro.",
+  "OG_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e vídeos com amigos",
+  "OG_DESCRIPTION": "Assista a vídeos em perfeita sincronia com seus amigos. Extensão open source e focada em privacidade.",
+  "TWITTER_TITLE": "KoalaSync | Sincronize vídeos online com seus amigos",
+  "TWITTER_DESCRIPTION": "Assista a vídeos junto com seus amigos em sincronia perfeita. Open source e seguro.",
  "NAV_FEATURES": "Recursos",
-  "NAV_HOW_IT_WORKS": "Como funciona",
-  "HERO_TITLE": "Assistam juntos.<br>Sincronia perfeita.",
-  "HERO_SUBTITLE": "Sua noite de cinema à distância sem atrasos. Sem registro, sem coleta de dados. Apenas compartilhe o link e assistam juntos.",
-  "HERO_MASCOT_ALT": "Um lindo coala em pé olhando para baixo em direção aos botões de download",
+  "NAV_HOW_IT_WORKS": "Como Funciona",
+  "HERO_TITLE": "Assistam Juntos.<span class='hero-line2'>Sincronia Perfeita.</span>",
+  "HERO_SUBTITLE": "Sua noite de cinema à distância sem atrasos. Sem contas, sem coleta de dados. Apenas compartilhe o link e assistam juntos.",
+  "HERO_MASCOT_ALT": "Um coala fofo olhando para os botões de download",
  "ADD_TO_CHROME": "Adicionar ao Chrome",
  "ADD_TO_FIREFOX": "Adicionar ao Firefox",
  "COMPAT_HEADING": "Funciona nas suas plataformas favoritas",
-  "COMPAT_MORE": "e muitas mais",
-  "COMPAT_TOOLTIP": "Funciona em quase qualquer site com um elemento de vídeo",
-  "USE_CASES_TITLE": "Perfeito para qualquer ocasião",
-  "USE_CASES_SUBTITLE": "Seja perto ou longe, o KoalaSync une as pessoas em torno de seus vídeos favoritos.",
-  "USE_CASE_1_ALT": "Dois coalas fofos sentados juntos e compartilhando um balde de pipoca",
-  "USE_CASE_1_TITLE": "Noite de cinema com amigos",
-  "USE_CASE_1_DESC": "Sincronize seus filmes em tempo real e converse pelo Discord, Zoom ou seu aplicativo de chamada de voz favorito. É como se estivessem na mesma sala.",
-  "USE_CASE_2_ALT": "Um professor coala fazendo uma apresentação em uma tela para dois alunos coala remotos",
-  "USE_CASE_2_TITLE": "Aprendizado remoto",
-  "USE_CASE_2_DESC": "Analise tutoriais online, palestras ou transmissões de treinamento de desenvolvedores junto com colegas de classe ou de trabalho. Pause e discuta etapas complexas em perfeita harmonia.",
-  "USE_CASE_3_ALT": "Um casal de coalas fofos assistindo juntos remotamente; um está no PC e o outro deitado com um laptop, com corações voando entre eles",
-  "USE_CASE_3_TITLE": "Relacionamentos à distância",
-  "USE_CASE_3_DESC": "Aproxime a distância e aproveite encontros virtuais. Experimente cada reviravolta, ria das mesmas piadas e compartilhe momentos emocionante no mesmo milissegundo.",
+  "COMPAT_MORE": "e muitas outras",
+  "COMPAT_TOOLTIP": "Funciona em quase qualquer site com player de vídeo HTML5",
+  "USE_CASES_TITLE": "Perfeito para Qualquer Ocasião",
+  "USE_CASES_SUBTITLE": "Seja de perto ou de longe, o KoalaSync une as pessoas através dos vídeos.",
+  "USE_CASE_1_ALT": "Dois coalas compartilhando pipoca",
+  "USE_CASE_1_TITLE": "Noite de Cinema com Amigos",
+  "USE_CASE_1_DESC": "Sincronize seus filmes em tempo real e converse pelo Discord ou Zoom. É como se estivessem na mesma sala.",
+  "USE_CASE_2_ALT": "Um professor coala dando aula online",
+  "USE_CASE_2_TITLE": "Aprendizado Remoto",
+  "USE_CASE_2_DESC": "Analise tutoriais ou aulas online com seus colegas. Pause e discuta os tópicos em harmonia.",
+  "USE_CASE_3_ALT": "Um casal de coalas assistindo a um vídeo à distância",
+  "USE_CASE_3_TITLE": "Relacionamentos à Distância",
+  "USE_CASE_3_DESC": "Aproveite as noites a dois. Ria das mesmas piadas e sinta as mesmas emoções exatamente no mesmo segundo.",
  "WHY_TITLE": "Por que o KoalaSync?",
-  "WHY_SUBTITLE": "Desenvolvido para uma sincronização confiável, privacidade em primeiro lugar e configuração simples.",
-  "FEATURE_1_TITLE": "Controle total / Sincronia instantânea",
-  "FEATURE_1_DESC": "Um pausa, todos pausam. Um avança, todos seguem. Nosso protocolo de sincronização em duas fases coordena a reprodução em tempo real entre todos os participantes.",
-  "FEATURE_2_TITLE": "Maratones sem fim",
-  "FEATURE_2_DESC": "Reprodução automática sincronizada. O KoalaSync detecta automaticamente transições de episódios e pausa a reprodução até que todos os participantes tenham carregado o próximo vídeo.",
-  "FEATURE_3_TITLE": "Sem contas / Privacidade absoluta",
-  "FEATURE_3_DESC": "Sem registro, sem rastreamento, sem armazenamento de dados. O servidor roda inteiramente em memória RAM efêmera e limpa sua sala assim que você sai.",
-  "FEATURE_4_TITLE": "Suporte universal a HTML5",
-  "FEATURE_4_DESC": "Funciona no YouTube, Twitch, Netflix, Jellyfin, Emby e em quase qualquer página web padrão com um elemento de vídeo HTML5. Também é compatível com servidores próprios.",
-  "FEATURE_5_TITLE": "Auto-hospedável e pronto para Docker",
-  "FEATURE_5_DESC": "Nossos servidores oficiais são rápidos e gratuitos, mas você pode ter controle total se desejar. Inicie seu próprio servidor de retransmissão privado em segundos via Docker.",
-  "FEATURE_6_TITLE": "Convites instantâneos / Entrada em 1 clique",
-  "FEATURE_6_DESC": "Sem troca de endereços IP ou senhas. Compartilhe um link de convite gerado para que seus amigos entrem automaticamente na sua sala com um único clique.",
+  "WHY_SUBTITLE": "Sincronização confiável, máxima privacidade e uso simples.",
+  "FEATURE_1_TITLE": "Controle Total / Sincronia Instantânea",
+  "FEATURE_1_DESC": "Se um pausa, todos pausam. Se um avança, todos seguem. Sincronização em tempo real para todos os participantes.",
+  "FEATURE_2_TITLE": "Maratonas Sem Interrupções",
+  "FEATURE_2_DESC": "O KoalaSync detecta a mudança de episódios e pausa automaticamente até que todos tenham carregado o vídeo seguinte.",
+  "FEATURE_3_TITLE": "Sem Contas / Privacidade Absoluta",
+  "FEATURE_3_DESC": "Sem cadastros ou rastreio. O servidor roda apenas na RAM e apaga sua sala assim que você sai.",
+  "FEATURE_4_TITLE": "Suporte HTML5 Universal",
+  "FEATURE_4_DESC": "Funciona no YouTube, Twitch, Netflix, Jellyfin, Emby e em qualquer site web. Nenhum dado de vídeo é enviado a nós.",
+  "FEATURE_5_TITLE": "Servidores Próprios (Docker)",
+  "FEATURE_5_DESC": "Nossos servidores são gratuitos, mas você pode assumir o controle total e iniciar seu próprio servidor privado em segundos com Docker.",
+  "FEATURE_6_TITLE": "Convites Rápidos / Entrar com 1 Clique",
+  "FEATURE_6_DESC": "Chega de senhas complicadas. Compartilhe o link e seus amigos entram na sala automaticamente.",
+  "FEATURE_7_TITLE": "Compressor de Áudio Integrado",
+  "FEATURE_7_DESC": "O compressor de áudio reforça diálogos baixos e diminui o volume de explosões. Funciona localmente, nenhum áudio sai do seu computador.",
+  "FEATURE_8_TITLE": "Open Source (Licença MIT)",
+  "FEATURE_8_DESC": "Todo o código é público no GitHub. 100% de transparência, sem softwares ocultos.",
  "COMP_TITLE": "KoalaSync vs Teleparty",
-  "COMP_SUBTITLE": "Veja por que o código aberto, sem anúncios e com privacidade em primeiro lugar é a melhor escolha para assistirem juntos.",
+  "COMP_SUBTITLE": "Descubra por que a nossa alternativa aberta e sem anúncios é melhor.",
  "COMP_COL_FEATURE": "Recurso",
-  "COMP_FEAT_1_NAME": "Custo / Bloqueios de recursos",
-  "COMP_FEAT_1_DESC": "Assinaturas premium, taxas ocultas ou recursos bloqueados.",
+  "COMP_FEAT_1_NAME": "Custos / Paywalls",
+  "COMP_FEAT_1_DESC": "Assinaturas premium ou recursos bloqueados.",
  "COMP_FEAT_1_KOALA": "100% Gratuito",
-  "COMP_FEAT_1_TELE": "Assinaturas pagas / Bloqueios Premium",
-  "COMP_FEAT_2_NAME": "Licença / Código auditável",
-  "COMP_FEAT_2_DESC": "Se o código-fonte é aberto e de livre auditoria.",
+  "COMP_FEAT_1_TELE": "Assinaturas Pagas / Bloqueios Premium",
+  "COMP_FEAT_2_NAME": "Código Aberto",
+  "COMP_FEAT_2_DESC": "Transparência do código-fonte.",
  "COMP_FEAT_2_KOALA": "Código Aberto (MIT)",
  "COMP_FEAT_2_TELE": "Proprietário",
-  "COMP_FEAT_3_NAME": "Auto-hospedagem",
-  "COMP_FEAT_3_DESC": "Capacidade de implantar seu próprio servidor de retransmissão privado.",
-  "COMP_FEAT_3_KOALA": "Sim (pronto para Docker)",
+  "COMP_FEAT_3_NAME": "Self-Hosting",
+  "COMP_FEAT_3_DESC": "Possibilidade de usar o seu próprio servidor.",
+  "COMP_FEAT_3_KOALA": "Sim (Docker)",
  "COMP_FEAT_3_TELE": "Não",
  "COMP_FEAT_4_NAME": "Privacidade e Rastreamento",
-  "COMP_FEAT_4_DESC": "Exigências de registro, cookies de rastreamento e análises.",
-  "COMP_FEAT_4_KOALA": "Sem persistência (apenas RAM)",
+  "COMP_FEAT_4_DESC": "Coleta de dados e cookies.",
+  "COMP_FEAT_4_KOALA": "Nenhum dado salvo",
  "COMP_FEAT_4_TELE": "Google Analytics e Cookies",
-  "COMP_FEAT_5_NAME": "Compatibilidade de sites",
-  "COMP_FEAT_5_DESC": "Sites suportados e compatibilidade do player.",
+  "COMP_FEAT_5_NAME": "Compatibilidade",
+  "COMP_FEAT_5_DESC": "Sites de vídeo suportados.",
  "COMP_FEAT_5_KOALA": "Quase qualquer vídeo HTML5",
-  "COMP_FEAT_5_TELE": "Apenas sites suportados",
-  "COMP_FEAT_6_NAME": "Localização / Tradução",
-  "COMP_FEAT_6_DESC": "Idiomas de interface disponíveis e suporte a tradução.",
-  "COMP_FEAT_6_KOALA": "13 idiomas (e crescendo)",
-  "COMP_FEAT_6_TELE": "Apenas inglês",
-  "COMP_FOOTNOTE_1": "Estado da comparação: maio de 2026.",
-  "COMP_FOOTNOTE_2": "Preços oficiais do Teleparty Premium e detalhes das redes suportadas:",
-  "COMP_FOOTNOTE_3": "Políticas de privacidade do Teleparty e coleta de dados de rastreamento:",
-  "COMP_FOOTNOTE_4": "Funciona em sites que permitem injeções de scripts em tags de vídeo HTML5 padrão. Sites com políticas de segurança de conteúdo (CSP) muito rígidas, proteção contra cópia DRM ou contêineres de player fortemente ocultos (como DOMs de sombra complexos) podem limitar o controle automatizado ou a injeção.",
-  "STEPS_TITLE": "Como começar",
-  "STEP_1_TITLE": "Instalar a extensão",
-  "STEP_1_DESC": "Adicione o KoalaSync ao seu navegador a partir da Chrome Web Store, Firefox Add-ons ou baixe o arquivo ZIP de desenvolvedor mais recente do GitHub.",
-  "STEP_1_ILLUS_DESC": "Sincronizador de vídeo focado em privacidade",
-  "STEP_1_ILLUS_DL_CHROME": "Baixar para o Chrome",
-  "STEP_1_ILLUS_DL_FIREFOX": "Baixar para o Firefox",
-  "STEP_1_ILLUS_ACTIVE": "Extensão ativa",
-  "STEP_1_ILLUS_READY": "Prontos para assistir juntos!",
-  "STEP_2_TITLE": "Criar uma sala",
-  "STEP_2_DESC": "Abra a janela da extensão e clique em '+ Criar nova sala'. O KoalaSync gera automaticamente um ID de sala e senha seguros, entra nela e copia o link de convite para a sua área de transferência.",
+  "COMP_FEAT_5_TELE": "Apenas sites selecionados",
+  "COMP_FEAT_6_NAME": "Traduzido",
+  "COMP_FEAT_6_DESC": "Idiomas suportados.",
+  "COMP_FEAT_6_KOALA": "13 Idiomas",
+  "COMP_FEAT_6_TELE": "Apenas Inglês",
+  "COMP_FEAT_7_NAME": "Compressor de Áudio",
+  "COMP_FEAT_7_DESC": "Melhora a clareza das vozes nos vídeos.",
+  "COMP_FEAT_7_KOALA": "Sim (4 configurações)",
+  "COMP_FEAT_7_TELE": "Não",
+  "COMP_FOOTNOTE_1": "Comparação atualizada em: Maio de 2026.",
+  "COMP_FOOTNOTE_2": "Preços oficiais do Teleparty:",
+  "COMP_FOOTNOTE_3": "Políticas de privacidade do Teleparty:",
+  "COMP_FOOTNOTE_4": "Funciona em sites que permitem injeção de scripts. Plataformas com DRM estrito podem ter limitações.",
+  "STEPS_TITLE": "Como Começar",
+  "STEP_1_TITLE": "Instalar a Extensão",
+  "STEP_1_DESC": "Adicione o KoalaSync ao seu navegador (Chrome ou Firefox).",
+  "STEP_1_ILLUS_DESC": "Extensão segura para ver vídeos",
+  "STEP_1_ILLUS_DL_CHROME": "Baixar para Chrome",
+  "STEP_1_ILLUS_DL_FIREFOX": "Baixar para Firefox",
+  "STEP_1_ILLUS_ACTIVE": "Extensão Ativa",
+  "STEP_1_ILLUS_READY": "Pronto!",
+  "STEP_2_TITLE": "Criar uma Sala",
+  "STEP_2_DESC": "Abra a extensão e clique em '+ Criar nova sala'. O link de convite é copiado automaticamente.",
  "STEP_2_ILLUS_ROOM": "Sala",
-  "STEP_2_ILLUS_SYNC": "Sincro",
-  "STEP_2_ILLUS_SETTINGS": "Opções",
+  "STEP_2_ILLUS_SYNC": "Sincronia",
+  "STEP_2_ILLUS_SETTINGS": "Configurações",
  "STEP_2_ILLUS_CREATE": "+ Criar nova sala",
-  "STEP_2_ILLUS_MANUAL": "Conexão manual / Avançado",
-  "STEP_2_ILLUS_COPIED": "Link de convite copiado!",
-  "STEP_3_TITLE": "Compartilhar e Sincronizar",
-  "STEP_3_DESC": "Envie o link de convite para seus amigos. Assim que eles entrarem, selecione a aba do seu vídeo e aproveite a reprodução sincronizada.",
-  "STEP_3_ILLUS_IN_SYNC": "SINCRONIZADO",
-  "SELF_TITLE": "Para quem hospeda próprio",
-  "SELF_SUBTITLE": "Não confia no nosso servidor? Mantenha a soberania total dos seus dados. Implante seu próprio servidor de retransmissão em minutos.",
-  "SELF_MASCOT_ALT": "Um coala fofo sentado à frente de um laptop implantando um contêiner Docker para hospedagem própria",
-  "SELF_COPY_CODE": "Copiar código",
-  "SELF_GITHUB_PACKAGES": "Ver todas as tags de imagens no GitHub Packages",
-  "BOTTOM_TITLE": "Ainda não se convenceu? Veja por si mesmo.",
-  "BOTTOM_SUBTITLE": "O KoalaSync é 100% de código aberto, livre de anúncios e sem rastreamento. Audite nosso código no GitHub ou instale a extensão do navegador diretamente.",
-  "BOTTOM_MASCOT_ALT": "Um coala fofo segurando uma página de repositório do GitHub ao lado de Octocat, a mascotte do GitHub",
-  "FAQ_TITLE": "Perguntas frequentes",
-  "FAQ_SUBTITLE": "Tudo o que você precisa saber para assistir vídeos juntos em perfeita sincronia.",
-  "FAQ_Q1": "Posso assistir Netflix, Emby ou Jellyfin sincronizado com amigos?",
-  "FAQ_A1": "Sim! O KoalaSync funciona com Netflix, YouTube, Twitch e qualquer site com player de vídeo HTML5 — incluindo Emby, Jellyfin e servidores de mídia próprios. Instale a extensão, crie uma sala, compartilhe o link e todos assistem em sincronia perfeita.",
-  "FAQ_Q2": "O KoalaSync é uma alternativa gratuita ao Teleparty?",
-  "FAQ_A2": "100% gratuito e open source sob a licença MIT. Sem níveis premium, sem recursos bloqueados, sem anúncios. Diferente do Teleparty, o servidor relay do KoalaSync opera apenas em RAM — sem coleta de dados ou contas de usuário.",
-  "FAQ_Q3": "O KoalaSync funciona com Emby, Jellyfin e servidores de mídia próprios?",
-  "FAQ_A3": "Sim. O KoalaSync detecta qualquer elemento de vídeo HTML5, funcionando perfeitamente com Emby, Jellyfin, Plex e qualquer configuração de streaming personalizada. Você também pode hospedar seu próprio servidor relay via Docker.",
-  "FAQ_Q4": "Quais navegadores e plataformas suportam o KoalaSync?",
-  "FAQ_A4": "Google Chrome, Mozilla Firefox, Microsoft Edge, Opera, Brave e todos os navegadores baseados em Chromium. Instale diretamente da Chrome Web Store ou das extensões do Firefox.",
-  "FAQ_Q5": "Todos os meus amigos precisam instalar a extensão?",
-  "FAQ_A5": "Sim, cada participante precisa do KoalaSync — mas sem cadastro ou criação de conta. Basta clicar no link de convite, instalar a extensão se necessário e você entra na sala automaticamente.",
-  "FAQ_Q6": "Meus dados estão seguros? E se eu não confiar no servidor oficial?",
-  "FAQ_A6": "Totalmente seguro. O servidor relay do KoalaSync opera apenas em RAM — todos os dados da sessão são excluídos ao sair da sala. Sem banco de dados, sem registros, sem análises, sem contas. Se preferir controle total: hospede seu próprio servidor relay privado via Docker em minutos. O código fonte é totalmente aberto e auditável no GitHub.",
-  "HOWTO_TITLE": "Como sincronizar vídeos com amigos usando o KoalaSync",
-  "HOWTO_DESC": "Assista vídeos em perfeita sincronia com amigos no YouTube, Netflix, Twitch e mais. Sem cadastro, sem rastreamento.",
-  "HOWTO_STEP_1_NAME": "Instalar a extensão",
-  "HOWTO_STEP_1_TEXT": "Adicione o KoalaSync ao seu navegador pela Chrome Web Store ou extensões do Firefox. Funciona em qualquer site com elemento de vídeo.",
-  "HOWTO_STEP_2_NAME": "Criar uma sala",
-  "HOWTO_STEP_2_TEXT": "Abra a extensão e clique em Criar nova sala. O link de convite é copiado automaticamente para sua área de transferência.",
-  "HOWTO_STEP_3_NAME": "Compartilhar e sincronizar",
-  "HOWTO_STEP_3_TEXT": "Envie o link de convite para seus amigos. Selecione uma aba de vídeo e aproveite a reprodução sincronizada em tempo real.",
+  "STEP_2_ILLUS_MANUAL": "Manual / Avançado",
+  "STEP_2_ILLUS_COPIED": "Link copiado!",
+  "STEP_3_TITLE": "Compartilhar e Assistir",
+  "STEP_3_DESC": "Envie o link aos amigos. Escolha um vídeo e aproveitem juntos.",
+  "STEP_3_ILLUS_IN_SYNC": "SINCRONIZADOS",
+  "SELF_TITLE": "Para usuários avançados",
+  "SELF_SUBTITLE": "Prefere gerenciar seus próprios dados? Inicie seu próprio servidor em minutos com Docker.",
+  "SELF_MASCOT_ALT": "Um coala configurando um servidor Docker",
+  "SELF_COPY_CODE": "Copiar Código",
+  "SELF_GITHUB_PACKAGES": "Ver pacotes no GitHub",
+  "BOTTOM_TITLE": "Ainda tem dúvidas?",
+  "BOTTOM_SUBTITLE": "O KoalaSync é 100% open source, sem anúncios e sem rastreamento. Verifique nosso código no GitHub.",
+  "BOTTOM_MASCOT_ALT": "Um coala junto do Octocat, mascote do GitHub",
+  "FAQ_TITLE": "Perguntas Frequentes",
+  "FAQ_SUBTITLE": "Tudo o que você precisa saber.",
+  "FAQ_Q1": "Posso assistir Netflix ou YouTube em sincronia com meus amigos?",
+  "FAQ_A1": "Sim! O KoalaSync funciona no Netflix, YouTube, Twitch e qualquer site com vídeo HTML5. Instale a extensão, compartilhe o link e pronto.",
+  "FAQ_Q2": "É gratuito?",
+  "FAQ_A2": "Sim, é 100% gratuito e open source. Sem recursos pagos e sem anúncios.",
+  "FAQ_Q3": "Funciona com Emby ou Jellyfin?",
+  "FAQ_A3": "Sim. Funciona perfeitamente em servidores multimídia próprios como Emby, Jellyfin e Plex.",
+  "FAQ_Q4": "Quais navegadores ele suporta?",
+  "FAQ_A4": "Google Chrome, Mozilla Firefox, Edge, Opera, Brave e outros baseados no Chromium.",
+  "FAQ_Q5": "Meus amigos precisam instalar a extensão?",
+  "FAQ_A5": "Sim, cada pessoa precisa da extensão, mas não é preciso criar conta. Basta um clique no link de convite.",
+  "FAQ_Q6": "Meus dados estão seguros?",
+  "FAQ_A6": "Sim. Nosso servidor usa apenas RAM. Não guardamos nada. Os dados são apagados quando a sala fecha.",
+  "FAQ_Q7": "Posso normalizar o áudio para ouvir melhor os diálogos?",
+  "FAQ_A7": "Sim! O KoalaSync possui um compressor de áudio que regula as vozes baixas e diminui as explosões. Ative-o nas Configurações de Processamento de Áudio.",
+  "HOWTO_TITLE": "Como usar o KoalaSync",
+  "HOWTO_DESC": "Sincronize vídeos no YouTube, Netflix e Twitch sem precisar de conta.",
+  "HOWTO_STEP_1_NAME": "Instale a extensão",
+  "HOWTO_STEP_1_TEXT": "Adicione o KoalaSync ao Chrome ou Firefox.",
+  "HOWTO_STEP_2_NAME": "Crie uma sala",
+  "HOWTO_STEP_2_TEXT": "Abra a extensão e crie uma sala. O link será copiado.",
+  "HOWTO_STEP_3_NAME": "Sincronize",
+  "HOWTO_STEP_3_TEXT": "Envie o link para os seus amigos e assistam o vídeo simultaneamente.",
  "FOOTER_MIT": "Código aberto sob a Licença MIT.",
-  "FOOTER_RAM": "Nenhum dado é armazenado em nossos servidores. Retransmissão apenas em RAM.",
-  "FOOTER_LEGAL": "Legal Notice",
-  "FOOTER_PRIVACY": "Privacy Policy",
-  "MOCK_01": "Sala ativa",
-  "MOCK_02": "Servidor oficial",
-  "MOCK_03": "Link de convite",
-  "MOCK_04": "Participantes",
+  "FOOTER_RAM": "Sem dados salvos. Baseado em RAM.",
+  "FOOTER_LEGAL": "Aviso Legal",
+  "FOOTER_PRIVACY": "Privacidade",
+  "MOCK_01": "Sala Ativa",
+  "MOCK_02": "Servidor Oficial",
+  "MOCK_03": "Link de Convite",
+  "MOCK_04": "Participantes na Sala",
  "MOCK_05": "VOCÊ",
  "MOCK_06": "Reproduzindo",
-  "MOCK_07": "Parceiro",
-  "MOCK_08": "Sair da sala",
-  "MOCK_09": "Selecionar vídeo",
-  "MOCK_10": "Controle remoto",
-  "MOCK_11": "Reproduzir",
-  "MOCK_12": "Pausar",
-  "MOCK_13": "Pular para outros",
-  "MOCK_14": "Última atividade",
-  "MOCK_15": "Aguardando 1 parceiro (KoalaPC)...",
-  "MOCK_16": "Pular e reproduzir",
-  "MOCK_17": "Seu nome",
-  "MOCK_18": "Ocultar abas confusas",
-  "MOCK_19": "Auto-sync próximo episódio",
-  "MOCK_20": "Auto-copiar convite",
-  "MOCK_21": "Notificações",
-  "MOCK_22": "Solução de problemas",
-  "MOCK_23": "Regenerar Peer ID",
-  "MOCK_24": "Use se aparecer erro \"Identidade duplicada\".",
-  "MOCK_25": "Status da conexão",
-  "MOCK_26": "Conectado",
-  "MOCK_27": "Copiar logs",
-  "MOCK_28": "Info de depuração de vídeo",
-  "MOCK_29": "Histórico completo",
-  "MOCK_30": "Logs (últimos 50)",
-  "MOCK_31": "LIMPAR",
-  "MOCK_32": "CLEAR",
+  "MOCK_07": "Participante",
+  "MOCK_08": "Sair da Sala",
+  "MOCK_09": "Selecionar Vídeo",
+  "MOCK_10": "Controle Remoto",
+  "MOCK_11": "Play",
+  "MOCK_12": "Pausa",
+  "MOCK_13": "SINCRO",
+  "MOCK_14": "Ir para a posição dos outros",
+  "MOCK_15": "Última Atividade",
+  "MOCK_16": "Aguardando 1 amigo (KoalaPC)...",
+  "MOCK_17": "Pular e reproduzir agora",
+  "MOCK_18": "Seu Nome",
+  "MOCK_19": "Ocultar abas sem vídeo",
+  "MOCK_20": "Sincro auto do próximo episódio",
+  "MOCK_21": "Copiar Convite Auto",
+  "MOCK_22": "Notificações",
+  "MOCK_23": "Solução de Problemas",
+  "MOCK_24": "Regerar ID",
+  "MOCK_25": "Corrige erros de 'Identidade Duplicada'.",
+  "MOCK_26": "Status",
+  "MOCK_27": "Conectado",
+  "MOCK_28": "Copiar Logs",
+  "MOCK_29": "Debug de Vídeo",
+  "MOCK_30": "Histórico Completo",
+  "MOCK_31": "Logs",
+  "MOCK_32": "LIMPAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
-  "FOOTER_SUPPORT": "Me pague um café no Ko-Fi"
+  "FOOTER_DISCLAIMER": "KoalaSync não é afiliado à Netflix, Disney+, YouTube, Twitch, etc. Todas as marcas registradas são de propriedade de seus respectivos donos.",
+  "FOOTER_SUPPORT": "Me pague um café"
 }
@@ -2,167 +2,178 @@
  "LANG_CODE": "pt",
  "HTML_CLASS": "lang-pt",
  "CANONICAL_PATH": "pt/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "pt_PT",
-  "META_TITLE": "KoalaSync | Sincronize Netflix, YouTube e qualquer vídeo com os amigos",
-  "META_DESCRIPTION": "Veja Netflix, YouTube, Twitch e qualquer vídeo HTML5 em sincronia perfeita com os amigos. Extensão de navegador gratuita e de código aberto para Chrome e Firefox. Sem registo necessário.",
-  "OG_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e quase qualquer vídeo com os amigos",
-  "OG_DESCRIPTION": "Veja Netflix, Emby, Jellyfin, YouTube, Twitch e quase qualquer vídeo HTML5 em sincronia perfeita. Extensão de navegador de código aberto e focada na privacidade para Chrome e Firefox.",
-  "TWITTER_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e quase qualquer vídeo com os amigos – Extensão de Navegador",
-  "TWITTER_DESCRIPTION": "Veja Netflix, Emby, Jellyfin, YouTube, Twitch e quase qualquer vídeo HTML5 em sincronia perfeita com os amigos. Extensão de navegador de código aberto e focada na privacidade para Chrome e Firefox.",
+  "META_TITLE": "KoalaSync | Sincronize Netflix, YouTube e vídeos com os amigos",
+  "META_DESCRIPTION": "Veja Netflix, YouTube, Twitch e qualquer vídeo HTML5 em sincronia perfeita. Extensão gratuita e de código aberto. Sem registo.",
+  "OG_TITLE": "KoalaSync | Sincronize Netflix, Emby, Jellyfin e vídeos com os amigos",
+  "OG_DESCRIPTION": "Veja vídeos em sincronia perfeita com os amigos. Extensão de código aberto e focada na privacidade.",
+  "TWITTER_TITLE": "KoalaSync | Sincronize vídeos em streaming com os amigos",
+  "TWITTER_DESCRIPTION": "Veja vídeos com os amigos em sincronia perfeita. Extensão de código aberto focada na privacidade.",
  "NAV_FEATURES": "Funcionalidades",
  "NAV_HOW_IT_WORKS": "Como Funciona",
-  "HERO_TITLE": "Vejam Juntos.<br>Sincronizem Perfeitamente.",
-  "HERO_SUBTITLE": "A sua noite de cinema à distância e sem atrasos. Sem registo, sem recolha de dados. Partilhe apenas um link e vejam juntos.",
-  "HERO_MASCOT_ALT": "Um coala fofo em pé e a olhar para baixo para os botões de download",
+  "HERO_TITLE": "Vejam Juntos.<span class='hero-line2'>Sincronia Perfeita.</span>",
+  "HERO_SUBTITLE": "A sua noite de cinema à distância e sem atrasos. Sem contas, sem recolha de dados. Partilhe um link e vejam juntos.",
+  "HERO_MASCOT_ALT": "Um coala fofo a olhar para os botões de download",
  "ADD_TO_CHROME": "Adicionar ao Chrome",
  "ADD_TO_FIREFOX": "Adicionar ao Firefox",
  "COMPAT_HEADING": "Funciona nas suas plataformas favoritas",
-  "COMPAT_MORE": "e muitos mais",
-  "COMPAT_TOOLTIP": "Funciona em quase todos os sites com um elemento de vídeo",
+  "COMPAT_MORE": "e muitas mais",
+  "COMPAT_TOOLTIP": "Funciona em quase todos os sites com um leitor de vídeo HTML5",
  "USE_CASES_TITLE": "Perfeito para Qualquer Ocasião",
-  "USE_CASES_SUBTITLE": "Perto ou longe, o KoalaSync junta as pessoas em redor dos seus vídeos favoritos.",
-  "USE_CASE_1_ALT": "Dois coalas fofos sentados juntos e a partilhar um balde de pipocas",
+  "USE_CASES_SUBTITLE": "Perto ou longe, o KoalaSync une as pessoas em redor dos seus vídeos favoritos.",
+  "USE_CASE_1_ALT": "Dois coalas a partilhar pipocas",
  "USE_CASE_1_TITLE": "Noite de Cinema com Amigos",
-  "USE_CASE_1_DESC": "Sincronize os seus filmes em tempo real e fale via Discord, Zoom ou a sua app de chamada de voz favorita. Parece que estão na mesma sala.",
-  "USE_CASE_2_ALT": "Um professor coala a dar uma apresentação num ecrã para dois estudantes coalas à distância",
+  "USE_CASE_1_DESC": "Sincronize os seus filmes em tempo real e fale via Discord ou Zoom. Parece que estão na mesma sala.",
+  "USE_CASE_2_ALT": "Um professor coala a dar uma aula online",
  "USE_CASE_2_TITLE": "Aprendizagem à Distância",
-  "USE_CASE_2_DESC": "Analise tutoriais online, palestras ou streams de formação com colegas. Pausa e discuta passos complexos em perfeita harmonia.",
-  "USE_CASE_3_ALT": "Um casal fofo de coalas a ver juntos à distância; um está sentado no PC e o outro está na cama com um portátil, com corações a voar entre eles",
+  "USE_CASE_2_DESC": "Analise tutoriais ou aulas online com colegas. Pause e discuta passos complexos em harmonia.",
+  "USE_CASE_3_ALT": "Um casal de coalas a ver vídeos à distância",
  "USE_CASE_3_TITLE": "Relacionamentos à Distância",
-  "USE_CASE_3_DESC": "Ponte para a distância e aproveite as noites de encontros. Experimente cada reviravolta, ria das mesmas piadas e partilhe momentos emocionantes exatamente no mesmo milissegundo.",
-  "WHY_TITLE": "Porquê KoalaSync?",
-  "WHY_SUBTITLE": "Construído para uma sincronização fiável, design focado na privacidade e configuração simples.",
-  "FEATURE_1_TITLE": "Controlo Total / Sincronização Instantânea",
-  "FEATURE_1_DESC": "Um pausa, todos pausam. Um avança, todos seguem. O nosso protocolo de sincronização a duas fases coordena a reprodução em tempo real em todos os participantes.",
-  "FEATURE_2_TITLE": "Binge-Watching Infinito",
-  "FEATURE_2_DESC": "Reprodução automática em sincronia. O KoalaSync deteta automaticamente as transições de episódios e aguarda até que todos os peers tenham carregado o vídeo seguinte.",
-  "FEATURE_3_TITLE": "Zero Contas / Privacidade Pura",
-  "FEATURE_3_DESC": "Sem registo, sem rastreio, sem pegadas de persistência. O servidor corre inteiramente em RAM e purga a sala quando você sai.",
+  "USE_CASE_3_DESC": "Aproveite as noites a dois. Ria das mesmas piadas e sinta as mesmas emoções exatamente no mesmo milissegundo.",
+  "WHY_TITLE": "Porquê o KoalaSync?",
+  "WHY_SUBTITLE": "Sincronização fiável, máxima privacidade e uso simples.",
+  "FEATURE_1_TITLE": "Controlo Total / Sincronia Instantânea",
+  "FEATURE_1_DESC": "Se um pausa, todos pausam. Se um avança, todos seguem. Sincronização em tempo real para todos os participantes.",
+  "FEATURE_2_TITLE": "Maratonas sem interrupções",
+  "FEATURE_2_DESC": "O KoalaSync deteta a mudança de episódios e pausa automaticamente até que todos tenham carregado o vídeo seguinte.",
+  "FEATURE_3_TITLE": "Sem Contas / Privacidade Absoluta",
+  "FEATURE_3_DESC": "Sem registos ou rastreios. O servidor corre apenas na RAM e apaga a sua sala assim que sair.",
  "FEATURE_4_TITLE": "Suporte HTML5 Universal",
-  "FEATURE_4_DESC": "Funciona no YouTube, Twitch, Netflix, Jellyfin, Emby e em quase todas as páginas web padrão que contenham um elemento de vídeo HTML5. Compatível também com servidores personalizados.",
-  "FEATURE_5_TITLE": "Auto-Hospedável e Pronto para Docker",
-  "FEATURE_5_DESC": "Os nossos servidores oficiais são gratuitos e rápidos, mas pode assumir o controlo total se quiser. Lance o seu próprio servidor de retransmissão privado em segundos via Docker.",
-  "FEATURE_6_TITLE": "Convites Instantâneos / Entrada com 1 Clique",
-  "FEATURE_6_DESC": "Nenhum endereço IP ou palavra-passe para trocar. Partilhe um link de convite gerado com os seus amigos para que possam entrar na sala automaticamente com um único clique.",
-  "COMP_TITLE": "KoalaSync vs. Teleparty",
-  "COMP_SUBTITLE": "Descubra porquê o código aberto, sem anúncios e focado na privacidade é a forma superior de ver vídeos juntos.",
+  "FEATURE_4_DESC": "Funciona no YouTube, Twitch, Netflix, Jellyfin, Emby e qualquer site web. Nenhum dado de vídeo é enviado para nós.",
+  "FEATURE_5_TITLE": "Servidores Próprios (Docker)",
+  "FEATURE_5_DESC": "Os nossos servidores são gratuitos, mas pode assumir o controlo total e iniciar o seu próprio servidor privado em segundos com Docker.",
+  "FEATURE_6_TITLE": "Convites Rápidos / Entrar com 1 Clique",
+  "FEATURE_6_DESC": "Nada de senhas complicadas. Partilhe o link e os seus amigos entram na sala automaticamente.",
+  "FEATURE_7_TITLE": "Compressor de Áudio Integrado",
+  "FEATURE_7_DESC": "O compressor de áudio reforça os diálogos suaves e baixa o volume das explosões. Funciona localmente, nenhum áudio sai do seu computador.",
+  "FEATURE_8_TITLE": "Código Aberto (Licença MIT)",
+  "FEATURE_8_DESC": "Todo o código é público no GitHub. 100% de transparência, sem software oculto.",
+  "COMP_TITLE": "KoalaSync vs Teleparty",
+  "COMP_SUBTITLE": "Descubra por que a nossa alternativa aberta e sem anúncios é melhor.",
  "COMP_COL_FEATURE": "Funcionalidade",
  "COMP_FEAT_1_NAME": "Custos / Paywalls",
-  "COMP_FEAT_1_DESC": "Assinaturas premium, taxas ocultas ou funcionalidades bloqueadas.",
+  "COMP_FEAT_1_DESC": "Assinaturas premium ou funcionalidades pagas.",
  "COMP_FEAT_1_KOALA": "100% Gratuito",
  "COMP_FEAT_1_TELE": "Planos Pagos / Bloqueios Premium",
-  "COMP_FEAT_2_NAME": "Licença / Código Auditável",
-  "COMP_FEAT_2_DESC": "Se o código-fonte é aberto e livremente auditável.",
+  "COMP_FEAT_2_NAME": "Código Aberto",
+  "COMP_FEAT_2_DESC": "Transparência do código fonte.",
  "COMP_FEAT_2_KOALA": "Código Aberto (MIT)",
  "COMP_FEAT_2_TELE": "Proprietário",
  "COMP_FEAT_3_NAME": "Self-Hosting",
-  "COMP_FEAT_3_DESC": "Capacidade de implementar o seu próprio servidor de retransmissão privado.",
-  "COMP_FEAT_3_KOALA": "Sim (Pronto para Docker)",
+  "COMP_FEAT_3_DESC": "Pode usar o seu próprio servidor.",
+  "COMP_FEAT_3_KOALA": "Sim (Docker)",
  "COMP_FEAT_3_TELE": "Não",
  "COMP_FEAT_4_NAME": "Privacidade e Rastreio",
-  "COMP_FEAT_4_DESC": "Requisitos de registo, cookies de rastreio e análises.",
-  "COMP_FEAT_4_KOALA": "Zero-Persistência (Apenas RAM)",
+  "COMP_FEAT_4_DESC": "Recolha de dados e cookies.",
+  "COMP_FEAT_4_KOALA": "Nenhum dado guardado",
  "COMP_FEAT_4_TELE": "Google Analytics e Cookies",
-  "COMP_FEAT_5_NAME": "Compatibilidade de Sites",
-  "COMP_FEAT_5_DESC": "Websites suportados e compatibilidade do leitor.",
+  "COMP_FEAT_5_NAME": "Compatibilidade",
+  "COMP_FEAT_5_DESC": "Sites de vídeo suportados.",
  "COMP_FEAT_5_KOALA": "Quase qualquer vídeo HTML5",
-  "COMP_FEAT_5_TELE": "Apenas sites suportados",
-  "COMP_FEAT_6_NAME": "Localização / Tradução",
-  "COMP_FEAT_6_DESC": "Idiomas de interface disponíveis e suporte de tradução.",
-  "COMP_FEAT_6_KOALA": "13 Idiomas (e a crescer)",
+  "COMP_FEAT_5_TELE": "Apenas sites selecionados",
+  "COMP_FEAT_6_NAME": "Traduzido",
+  "COMP_FEAT_6_DESC": "Idiomas suportados.",
+  "COMP_FEAT_6_KOALA": "13 Idiomas",
  "COMP_FEAT_6_TELE": "Apenas Inglês",
-  "COMP_FOOTNOTE_1": "Estado da comparação: Maio de 2026.",
-  "COMP_FOOTNOTE_2": "Preços oficiais do Teleparty Premium e detalhes das redes suportadas:",
-  "COMP_FOOTNOTE_3": "Políticas de privacidade do Teleparty e recolha de dados de rastreio:",
-  "COMP_FOOTNOTE_4": "Funciona em websites que permitam injeções de scripts nas tags de vídeo HTML5 padrão. Websites com Políticas de Segurança de Conteúdo (CSP) muito rígidas, proteção de direitos de cópia DRM ou wrappers de leitores fortemente ofuscados (como shadow DOMs complexos) podem restringir o controlo ou injeção.",
+  "COMP_FEAT_7_NAME": "Compressor de Áudio",
+  "COMP_FEAT_7_DESC": "Melhora a clareza das vozes nos vídeos.",
+  "COMP_FEAT_7_KOALA": "Sim (4 predefinições)",
+  "COMP_FEAT_7_TELE": "Não",
+  "COMP_FOOTNOTE_1": "Comparação atualizada em: Maio de 2026.",
+  "COMP_FOOTNOTE_2": "Preços oficiais do Teleparty:",
+  "COMP_FOOTNOTE_3": "Políticas de privacidade do Teleparty:",
+  "COMP_FOOTNOTE_4": "Funciona em websites que permitem a injeção de scripts. Plataformas com DRM estrito podem ter limitações.",
  "STEPS_TITLE": "Como Começar",
-  "STEP_1_TITLE": "Instalar Extensão",
-  "STEP_1_DESC": "Adicione o KoalaSync ao seu navegador a partir da Chrome Web Store, Firefox Add-ons ou transfira o ZIP de programador mais recente do GitHub.",
-  "STEP_1_ILLUS_DESC": "Sincronizador de vídeo focado na privacidade",
+  "STEP_1_TITLE": "Instalar a Extensão",
+  "STEP_1_DESC": "Adicione o KoalaSync ao seu navegador (Chrome ou Firefox).",
+  "STEP_1_ILLUS_DESC": "Extensão segura para ver vídeos",
  "STEP_1_ILLUS_DL_CHROME": "Descarregar para Chrome",
  "STEP_1_ILLUS_DL_FIREFOX": "Descarregar para Firefox",
  "STEP_1_ILLUS_ACTIVE": "Extensão Ativa",
-  "STEP_1_ILLUS_READY": "Pronto para verem juntos!",
+  "STEP_1_ILLUS_READY": "Pronto!",
  "STEP_2_TITLE": "Criar uma Sala",
-  "STEP_2_DESC": "Abra o popup da extensão e clique em '+ Criar Nova Sala'. O KoalaSync gera automaticamente um ID de Sala e Palavra-passe seguros, entra nela e copia o link de convite para a área de transferência.",
+  "STEP_2_DESC": "Abra a extensão e clique em '+ Criar Nova Sala'. O link de convite é copiado automaticamente.",
  "STEP_2_ILLUS_ROOM": "Sala",
-  "STEP_2_ILLUS_SYNC": "Sincronização",
+  "STEP_2_ILLUS_SYNC": "Sincronia",
  "STEP_2_ILLUS_SETTINGS": "Definições",
  "STEP_2_ILLUS_CREATE": "+ Criar Nova Sala",
-  "STEP_2_ILLUS_MANUAL": "Ligação Manual / Avançado",
-  "STEP_2_ILLUS_COPIED": "Link de convite copiado!",
+  "STEP_2_ILLUS_MANUAL": "Manual / Avançado",
+  "STEP_2_ILLUS_COPIED": "Link copiado!",
  "STEP_3_TITLE": "Partilhar e Sincronizar",
-  "STEP_3_DESC": "Envie o link de convite para os seus amigos. Assim que eles entrarem, selecione o seu separador do vídeo e desfrute da reprodução sincronizada.",
-  "STEP_3_ILLUS_IN_SYNC": "EM SINCRONIA",
-  "SELF_TITLE": "Para Auto-Hospedadores",
-  "SELF_SUBTITLE": "Não confia no nosso servidor? Mantenha a total soberania dos seus dados. Implemente o seu próprio servidor de retransmissão privado em minutos.",
-  "SELF_MASCOT_ALT": "Um coala fofo sentado num portátil a implementar um contentor Docker para auto-hospedagem",
+  "STEP_3_DESC": "Envie o link aos amigos. Escolha um vídeo e desfrutem da reprodução juntos.",
+  "STEP_3_ILLUS_IN_SYNC": "SINCRONIZADOS",
+  "SELF_TITLE": "Para utilizadores avançados",
+  "SELF_SUBTITLE": "Prefere gerir os seus dados? Inicie o seu próprio servidor em minutos com Docker.",
+  "SELF_MASCOT_ALT": "Um coala a configurar um servidor Docker",
  "SELF_COPY_CODE": "Copiar Código",
-  "SELF_GITHUB_PACKAGES": "Ver todas as tags de imagens no GitHub Packages",
-  "BOTTOM_TITLE": "Não está convencido? Veja por si mesmo.",
-  "BOTTOM_SUBTITLE": "O KoalaSync é 100% de código aberto, sem anúncios e sem rastreio. Audite a nossa base de código no GitHub ou instale a extensão do navegador diretamente.",
-  "BOTTOM_MASCOT_ALT": "Um coala fofo a segurar numa página de repositório GitHub ao lado da mascote do GitHub Octocat",
+  "SELF_GITHUB_PACKAGES": "Ver pacotes no GitHub",
+  "BOTTOM_TITLE": "Ainda tem dúvidas?",
+  "BOTTOM_SUBTITLE": "O KoalaSync é 100% de código aberto, sem anúncios e sem rastreio. Inspecione o nosso código no GitHub.",
+  "BOTTOM_MASCOT_ALT": "Um coala junto ao logótipo do GitHub",
  "FAQ_TITLE": "Perguntas Frequentes",
-  "FAQ_SUBTITLE": "Tudo o que precisa de saber sobre ver vídeos juntos numa sincronização perfeita.",
-  "FAQ_Q1": "Posso ver Netflix, Emby ou Jellyfin juntos em sincronia com os amigos?",
-  "FAQ_A1": "Sim! O KoalaSync funciona no Netflix, YouTube, Twitch e em qualquer website com um leitor de vídeo HTML5 — incluindo Emby, Jellyfin e servidores de media auto-hospedados. Instale a extensão, crie uma sala, partilhe o link de convite e todos assistem em perfeita sincronia.",
-  "FAQ_Q2": "O KoalaSync é uma alternativa gratuita ao Teleparty?",
-  "FAQ_A2": "100% gratuito e de código aberto sob a Licença MIT. Sem planos premium, sem funcionalidades bloqueadas, sem anúncios — tudo incluído. Ao contrário do Teleparty, o servidor do KoalaSync corre apenas em RAM, sem qualquer recolha de dados ou necessidade de contas de utilizador.",
-  "FAQ_Q3": "O KoalaSync funciona com Emby, Jellyfin e servidores de media auto-hospedados?",
-  "FAQ_A3": "Sim. O KoalaSync deteta qualquer elemento de vídeo HTML5 padrão, o que significa que funciona perfeitamente com Emby, Jellyfin, Plex e qualquer configuração de streaming personalizada. Também pode auto-hospedar o servidor de retransmissão do KoalaSync via Docker para total soberania dos dados.",
-  "FAQ_Q4": "Que navegadores e plataformas suportam o KoalaSync?",
-  "FAQ_A4": "Google Chrome, Mozilla Firefox, Microsoft Edge, Opera, Brave e todos os navegadores baseados em Chromium. Instale diretamente da Chrome Web Store ou Firefox Add-ons — sem necessidade de configuração manual.",
-  "FAQ_Q5": "Todos os meus amigos precisam de ter a extensão instalada?",
-  "FAQ_A5": "Sim, cada participante precisa de ter o KoalaSync instalado — mas não há registo ou criação de conta. Basta clicar no link de convite, instalar a extensão se ainda não o fez, e entrará na sala automaticamente em segundos.",
-  "FAQ_Q6": "Os meus dados estão seguros? E se eu não confiar no servidor oficial?",
-  "FAQ_A6": "Totalmente seguro. O servidor de retransmissão do KoalaSync corre apenas em RAM — todos os dados da sessão são permanentemente eliminados no momento em que sai da sala. Sem base de dados, sem registo, sem análises, sem contas. E se preferir o controlo total: pode auto-hospedar o seu próprio servidor de retransmissão privado via Docker em minutos. Toda a base de código é aberta e auditável no GitHub.",
-  "HOWTO_TITLE": "Como sincronizar vídeos com amigos usando o KoalaSync",
-  "HOWTO_DESC": "Veja qualquer vídeo em sincronia perfeita com os amigos no YouTube, Netflix, Twitch e mais. Sem registo, sem rastreio.",
-  "HOWTO_STEP_1_NAME": "Instale a extensão do navegador",
-  "HOWTO_STEP_1_TEXT": "Adicione o KoalaSync ao seu navegador a partir da Chrome Web Store ou Firefox Add-ons. Funciona em qualquer website com um elemento de vídeo.",
+  "FAQ_SUBTITLE": "Tudo o que precisa de saber.",
+  "FAQ_Q1": "Posso ver a Netflix ou YouTube com os meus amigos?",
+  "FAQ_A1": "Sim! O KoalaSync funciona no Netflix, YouTube, Twitch e qualquer site com vídeo HTML5. Instale a extensão, partilhe o link e está feito.",
+  "FAQ_Q2": "É gratuito?",
+  "FAQ_A2": "Sim, é 100% gratuito e de código aberto. Sem funções premium bloqueadas e sem publicidade.",
+  "FAQ_Q3": "Funciona com Emby ou Jellyfin?",
+  "FAQ_A3": "Sim. Funciona perfeitamente em servidores multimédia próprios como Emby, Jellyfin e Plex.",
+  "FAQ_Q4": "Que navegadores suporta?",
+  "FAQ_A4": "Google Chrome, Mozilla Firefox, Edge, Opera, Brave e outros baseados em Chromium.",
+  "FAQ_Q5": "Os meus amigos precisam de instalar a extensão?",
+  "FAQ_A5": "Sim, cada pessoa precisa da extensão, mas não é necessário criar uma conta. Basta um clique no link de convite.",
+  "FAQ_Q6": "Os meus dados estão seguros?",
+  "FAQ_A6": "Sim. O nosso servidor usa apenas RAM. Não guardamos nada. Os dados são eliminados quando a sala fecha.",
+  "FAQ_Q7": "Posso normalizar o áudio para ouvir melhor os diálogos?",
+  "FAQ_A7": "Sim! O KoalaSync tem um compressor de áudio que regula as vozes baixas e atenua as explosões. Ative-o nas Definições de Processamento de Áudio.",
+  "HOWTO_TITLE": "Como usar o KoalaSync",
+  "HOWTO_DESC": "Sincronize vídeos no YouTube, Netflix e Twitch sem criar conta.",
+  "HOWTO_STEP_1_NAME": "Instale a extensão",
+  "HOWTO_STEP_1_TEXT": "Adicione o KoalaSync ao Chrome ou Firefox.",
  "HOWTO_STEP_2_NAME": "Crie uma sala",
-  "HOWTO_STEP_2_TEXT": "Abra o popup da extensão e clique em Criar Nova Sala. O link de convite é copiado automaticamente para a área de transferência.",
-  "HOWTO_STEP_3_NAME": "Partilhe e sincronize",
-  "HOWTO_STEP_3_TEXT": "Envie o link de convite para os seus amigos. Escolha um separador do vídeo e desfrute da reprodução sincronizada em tempo real.",
+  "HOWTO_STEP_2_TEXT": "Abra a extensão e crie uma sala. O link será copiado.",
+  "HOWTO_STEP_3_NAME": "Sincronize",
+  "HOWTO_STEP_3_TEXT": "Envie o link aos amigos e vejam o vídeo em simultâneo.",
  "FOOTER_MIT": "Código aberto sob a Licença MIT.",
-  "FOOTER_RAM": "Nenhum dado é guardado nos nossos servidores. Transmissão baseada apenas em RAM.",
+  "FOOTER_RAM": "Sem dados guardados. Baseado em RAM.",
  "FOOTER_LEGAL": "Aviso Legal",
-  "FOOTER_PRIVACY": "Política de Privacidade",
+  "FOOTER_PRIVACY": "Privacidade",
  "MOCK_01": "Sala Ativa",
  "MOCK_02": "Servidor Oficial",
  "MOCK_03": "Link de Convite",
  "MOCK_04": "Participantes na Sala",
-  "MOCK_05": "YOU",
-  "MOCK_06": "Playing",
-  "MOCK_07": "Peer",
+  "MOCK_05": "TU",
+  "MOCK_06": "A reproduzir",
+  "MOCK_07": "Participante",
  "MOCK_08": "Sair da Sala",
  "MOCK_09": "Selecionar Vídeo",
  "MOCK_10": "Controlo Remoto",
-  "MOCK_11": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\" width=\"14\" height=\"14\" aria-hidden=\"true\"><polygon points=\"5 3 19 12 5 21 5 3\"/></svg> Play",
-  "MOCK_12": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"currentColor\" width=\"14\" height=\"14\" aria-hidden=\"true\"><rect x=\"6\" y=\"4\" width=\"4\" height=\"16\"/><rect x=\"14\" y=\"4\" width=\"4\" height=\"16\"/></svg> Pause",
-  "MOCK_13": "<svg xmlns=\"http://www.w3.org/2000/svg\" viewBox=\"0 0 24 24\" fill=\"none\" stroke=\"currentColor\" stroke-width=\"2\" stroke-linecap=\"round\" stroke-linejoin=\"round\" width=\"14\" height=\"14\" aria-hidden=\"true\"><polygon points=\"13 2 3 14 12 14 11 22 21 10 12 10 13 2\"/></svg> SYNC",
-  "MOCK_14": "Ir para os Outros",
-  "MOCK_15": "Estado da Última Atividade",
-  "MOCK_16": "A aguardar por 1 participante (KoalaPC)...",
-  "MOCK_17": "Ignorar e reproduzir mesmo assim",
-  "MOCK_18": "O seu Nome de Utilizador",
-  "MOCK_19": "Ocultar Separadores Desnecessários",
-  "MOCK_20": "Sincronização Automática do Próximo Episódio",
-  "MOCK_21": "Copiar Automaticamente o Link de Convite",
-  "MOCK_22": "Notificações do Navegador",
+  "MOCK_11": "Play",
+  "MOCK_12": "Pausa",
+  "MOCK_13": "SINCRO",
+  "MOCK_14": "Ir para a posição dos outros",
+  "MOCK_15": "Última Atividade",
+  "MOCK_16": "À espera de 1 amigo (KoalaPC)...",
+  "MOCK_17": "Ignorar e reproduzir agora",
+  "MOCK_18": "O seu Nome",
+  "MOCK_19": "Ocultar separadores sem vídeo",
+  "MOCK_20": "Sincro auto do próximo episódio",
+  "MOCK_21": "Copiar Convite Auto",
+  "MOCK_22": "Notificações",
  "MOCK_23": "Resolução de Problemas",
-  "MOCK_24": "Regerar ID do Peer",
-  "MOCK_25": "Use isto se vir erros de \"Identidade Duplicata\".",
-  "MOCK_26": "Estado da Ligação",
-  "MOCK_27": "Connected",
+  "MOCK_24": "Regerar ID",
+  "MOCK_25": "Corrige erros de 'Identidade Duplicada'.",
+  "MOCK_26": "Estado",
+  "MOCK_27": "Ligado",
  "MOCK_28": "Copiar Registos",
-  "MOCK_29": "Info de Debug de Vídeo",
-  "MOCK_30": "Histórico Completo de Ações",
-  "MOCK_31": "Registos (Últimos 50)",
+  "MOCK_29": "Debug de Vídeo",
+  "MOCK_30": "Histórico Completo",
+  "MOCK_31": "Registos",
  "MOCK_32": "LIMPAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
-  "FOOTER_SUPPORT": "Oferece um café no Ko-Fi"
+  "FOOTER_DISCLAIMER": "KoalaSync não é afiliado à Netflix, Disney+, YouTube, Twitch, etc. Todas as marcas são propriedade dos seus titulares.",
+  "FOOTER_SUPPORT": "Oferece-me um café"
 }
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Смотрите Netflix, Emby, Jellyfin, YouTube, Twitch и почти любое HTML5-видео в идеальной синхронизации с друзьями. Открытое и конфиденциальное расширение для Chrome и Firefox.",
  "NAV_FEATURES": "Функции",
  "NAV_HOW_IT_WORKS": "Как это работает",
-  "HERO_TITLE": "Смотрите вместе.<br>Синхронно на 100%.",
+  "HERO_TITLE": "Смотрите вместе.<span class='hero-line2'>Синхронно на 100%.</span>",
  "HERO_SUBTITLE": "Ваш киновечер на расстоянии без задержек. Без регистрации и сбора данных. Просто поделитесь ссылкой и смотрите вместе.",
  "HERO_MASCOT_ALT": "Милый коала стоит и смотрит вниз на кнопки загрузки",
  "ADD_TO_CHROME": "Установить в Chrome",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Без аккаунтов и хранения данных",
  "FEATURE_3_DESC": "Без регистрации, без отслеживания, без следов на диске. Сервер работает исключительно во временной RAM и полностью стирает вашу комнату при выходе.",
  "FEATURE_4_TITLE": "Универсальная поддержка HTML5",
-  "FEATURE_4_DESC": "Работает на YouTube, Twitch, Netflix, Jellyfin, Emby и почти на любой веб-странице со стандартным HTML5-видеотегом. Подходит для локальных медиатек.",
+  "FEATURE_4_DESC": "Работает на YouTube, Twitch, Netflix, Jellyfin, Emby и почти на любой веб-странице со стандартным HTML5-видеотегом. Подходит для локальных медиатек. Никакие видеоданные никогда не отправляются на наши серверы — только метаданные синхронизации.",
  "FEATURE_5_TITLE": "Self-Hosted и готов к Docker",
  "FEATURE_5_DESC": "Наши официальные серверы бесплатны и быстры, но вы можете получить полный контроль. Запустите свой собственный приватный ретранслятор в Docker за секунды.",
  "FEATURE_6_TITLE": "Быстрые приглашения в 1 клик",
  "FEATURE_6_DESC": "Не нужно обмениваться IP-адресами или паролями. Отправьте сгенерированную ссылку друзьям, чтобы они автоматически вошли в комнату в один клик.",
+  "FEATURE_7_TITLE": "Выравнивание громкости / Аудио компрессор",
+  "FEATURE_7_DESC": "Больше никакой постоянной регулировки громкости. Встроенный аудио компрессор усиливает тихие диалоги и приглушает громкие взрывы. Работает на Netflix, Prime Video, Disney+, YouTube и любом HTML5-видео. Полностью локально — никакие аудиоданные не покидают ваш компьютер.",
+  "FEATURE_8_TITLE": "Открытый исходный код (Лицензия MIT)",
+  "FEATURE_8_DESC": "Весь исходный код публично доступен для проверки на GitHub. Никаких «черных ящиков», никаких проприетарных бинарных файлов (blobs) — 100% прозрачность от relay-сервера до расширения браузера.",
  "COMP_TITLE": "KoalaSync против Teleparty",
  "COMP_SUBTITLE": "Узнайте, почему открытый исходный код, отсутствие рекламы и конфиденциальность делают нас лучшим выбором для совместного просмотра.",
  "COMP_COL_FEATURE": "Функция",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Доступные языки интерфейса и поддержка перевода.",
  "COMP_FEAT_6_KOALA": "13 языков (и расширяется)",
  "COMP_FEAT_6_TELE": "Только английский",
+  "COMP_FEAT_7_NAME": "Аудиокомпрессор / Выравнивание Громкости",
+  "COMP_FEAT_7_DESC": "Встроенная нормализация звука для баланса тихих диалогов и громких эффектов",
+  "COMP_FEAT_7_KOALA": "Да (4 пресета, управление dry/wet)",
+  "COMP_FEAT_7_TELE": "Нет",
  "COMP_FOOTNOTE_1": "Состояние сравнения: май 2026.",
  "COMP_FOOTNOTE_2": "Официальные цены Teleparty Premium и поддерживаемые сети:",
  "COMP_FOOTNOTE_3": "Политика конфиденциальности Teleparty и сбор трекеров:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Да, каждому участнику нужен KoalaSync — но без регистрации и создания учётной записи. Просто перейдите по ссылке-приглашению, установите расширение (если ещё нет) и вы автоматически в комнате.",
  "FAQ_Q6": "Мои данные в безопасности? Что, если я не доверяю официальному серверу?",
  "FAQ_A6": "Полностью безопасно. Relay-сервер KoalaSync работает только в ОЗУ — все данные сессии удаляются при выходе из комнаты. Никаких баз данных, логов, аналитики и учётных записей. Если хотите полный контроль: разверните свой приватный relay-сервер через Docker за пару минут. Исходный код полностью открыт и доступен для аудита на GitHub.",
+  "FAQ_Q7": "Можно ли исправить тихие диалоги и громкие взрывы при просмотре видео в браузере?",
+  "FAQ_A7": "Да. KoalaSync 2.2.0 включает встроенный аудио компрессор, который уменьшает разницу между тихими и громкими частями видео. Он работает локально через Web Audio API — аудиоданные никогда не покидают ваш компьютер. Откройте попап, создайте комнату, перейдите в Настройки → Audio Processing, включите компрессор и выберите пресет. Работает на Netflix, Prime Video, Disney+, YouTube и любом сайте с HTML5-видео.",
  "HOWTO_TITLE": "Как синхронизировать видео с друзьями с помощью KoalaSync",
  "HOWTO_DESC": "Смотрите видео в идеальной синхронизации с друзьями на YouTube, Netflix, Twitch и других платформах. Без регистрации, без отслеживания.",
  "HOWTO_STEP_1_NAME": "Установите расширение",
@@ -164,5 +174,6 @@
  "MOCK_32": "CLEAR",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync не связан, не спонсируется и не аффилирован с Netflix, Disney+, Amazon, YouTube, Twitch или любой другой стриминговой платформой. Все товарные знаки являются собственностью их соответствующих владельцев.",
  "FOOTER_SUPPORT": "Угости кофе на Ko-Fi"
 }
@@ -2,7 +2,7 @@
  "LANG_CODE": "tr",
  "HTML_CLASS": "lang-tr",
  "CANONICAL_PATH": "tr/",
-  "LANG_TOGGLE_URL": "",
+  "LANG_TOGGLE_URL": "../",
  "LANG_TOGGLE_TEXT": "EN",
  "OG_LOCALE": "tr_TR",
  "META_TITLE": "KoalaSync | Netflix, YouTube ve Herhangi Bir Videoyu Arkadaşlarınızla Eşitleyin",
@@ -13,7 +13,7 @@
  "TWITTER_DESCRIPTION": "Netflix, Emby, Jellyfin, YouTube, Twitch ve neredeyse tüm HTML5 videolarını arkadaşlarınızla mükemmel bir senkronizasyonla izleyin. Chrome ve Firefox için gizlilik öncelikli, açık kaynaklı tarayıcı eklentisi.",
  "NAV_FEATURES": "Özellikler",
  "NAV_HOW_IT_WORKS": "Nasıl Çalışır",
-  "HERO_TITLE": "Birlikte İzleyin.<br>Mükemmel Eşitleyin.",
+  "HERO_TITLE": "Birlikte İzleyin.<span class='hero-line2'>Mükemmel Eşitleyin.</span>",
  "HERO_SUBTITLE": "Gecikmesiz uzaktan film geceniz. Kayıt yok, veri toplama yok. Sadece bir bağlantı paylaşın ve birlikte izleyin.",
  "HERO_MASCOT_ALT": "İndirme düğmelerine bakan sevimli bir koala",
  "ADD_TO_CHROME": "Chrome'a Ekle",
@@ -41,11 +41,15 @@
  "FEATURE_3_TITLE": "Sıfır Hesap / Saf Gizlilik",
  "FEATURE_3_DESC": "Kayıt yok, takip yok, kalıcı iz yok. Sunucu tamamen geçici RAM üzerinde çalışır ve ayrıldığınızda odanızı temizler.",
  "FEATURE_4_TITLE": "Evrensel HTML5 Desteği",
-  "FEATURE_4_DESC": "YouTube, Twitch, Netflix, Jellyfin, Emby ve HTML5 video öğesi içeren neredeyse tüm standart web sayfalarında çalışır. Ayrıca özel barındırılan kurulumlarla da uyumludur.",
+  "FEATURE_4_DESC": "YouTube, Twitch, Netflix, Jellyfin, Emby ve HTML5 video öğesi içeren neredeyse tüm standart web sayfalarında çalışır. Ayrıca özel barındırılan kurulumlarla da uyumludur. Sunucularımıza hiçbir video verisi asla gönderilmez — yalnızca senkronizasyon meta verileri gönderilir.",
  "FEATURE_5_TITLE": "Kendi Kendine Barındırılabilir ve Docker Uyumlu",
  "FEATURE_5_DESC": "Resmi sunucularımız ücretsiz ve hızlıdır, ancak isterseniz tüm kontrolü elinize alabilirsiniz. Docker aracılığıyla saniyeler içinde kendi özel aktarım sunucunuzu başlatın.",
  "FEATURE_6_TITLE": "Anında Davetler / Tek Tıkla Katılım",
  "FEATURE_6_DESC": "Takas edilecek IP adresi veya şifre yok. Arkadaşlarınızın tek bir tıklamayla odanıza otomatik olarak katılması için oluşturulan bir davet bağlantısını paylaşın.",
+  "FEATURE_7_TITLE": "Ses Seviyesi Dengeleme / Ses Sıkıştırıcı",
+  "FEATURE_7_DESC": "Ses düğmesiyle sürekli oynamak yok. Dahili ses sıkıştırıcı, sessiz diyalogları güçlendirir ve yüksek patlamaları yumuşatır. Netflix, Prime Video, Disney+, YouTube ve herhangi bir HTML5 videosunda çalışır. Tamamen yerel — hiçbir ses verisi bilgisayarınızı terk etmez.",
+  "FEATURE_8_TITLE": "Açık Kaynak (MIT Lisansı)",
+  "FEATURE_8_DESC": "Tüm kod tabanı GitHub'da herkese açık olarak incelenebilir. Kapalı kutular yok, tescilli blob'lar yok — aktarma sunucusundan (relay server) tarayıcı eklentisine kadar %100 şeffaflık.",
  "COMP_TITLE": "KoalaSync vs. Teleparty",
  "COMP_SUBTITLE": "Açık kaynaklı, reklamsız ve önce gizlilik diyen yöntemin neden birlikte izlemenin en iyi yolu olduğunu görün.",
  "COMP_COL_FEATURE": "Özellik",
@@ -73,6 +77,10 @@
  "COMP_FEAT_6_DESC": "Mevcut arayüz dilleri ve çeviri desteği.",
  "COMP_FEAT_6_KOALA": "13 Dil (ve artıyor)",
  "COMP_FEAT_6_TELE": "Sadece İngilizce",
+  "COMP_FEAT_7_NAME": "Ses Kompresörü / Ses Seviyesi Dengeleme",
+  "COMP_FEAT_7_DESC": "Sessiz diyaloglar ve yüksek efektler arasında denge sağlayan yerleşik ses normalizasyonu",
+  "COMP_FEAT_7_KOALA": "Evet (4 ön ayar, dry/wet kontrolü)",
+  "COMP_FEAT_7_TELE": "Hayır",
  "COMP_FOOTNOTE_1": "Karşılaştırma durumu: Mayıs 2026.",
  "COMP_FOOTNOTE_2": "Resmi Teleparty Premium fiyatlandırması ve desteklenen ağ ayrıntıları:",
  "COMP_FOOTNOTE_3": "Teleparty gizlilik politikaları ve takip verisi toplama:",
@@ -118,6 +126,8 @@
  "FAQ_A5": "Evet, her katılımcının KoalaSync'i kurması gerekir — ancak kayıt veya hesap oluşturma yoktur. Sadece davet bağlantısına tıklayın, henüz yapmadıysanız eklentiyi kurun, saniyeler içinde odaya otomatik olarak katılacaksınız.",
  "FAQ_Q6": "Verilerim güvende mi? Ya resmi sunucuya güvenmiyorsam?",
  "FAQ_A6": "Tamamen güvende. KoalaSync'in aktarım sunucusu yalnızca RAM üzerindedir — odadan ayrıldığınız andan itibaren tüm oturum verileri kalıcı olarak silinir. Veritabanı yok, günlük kaydı yok, analitik yok, hesap yok. Ve tam kontrolü tercih ediyorsanız: Docker aracılığıyla kendi özel aktarım sunucunuzu dakikalar içinde barındırabilirsiniz. Tüm kod tabanı açık kaynaklıdır ve GitHub'da denetlenebilir.",
+  "FAQ_Q7": "Tarayıcıda video izlerken sessiz diyalogları ve yüksek patlamaları düzeltebilir miyim?",
+  "FAQ_A7": "Evet. KoalaSync 2.2.0, videonuzun sessiz ve yüksek kısımları arasındaki farkı azaltan yerleşik bir ses sıkıştırıcı içerir. Web Audio API aracılığıyla yerel olarak çalışır — hiçbir ses verisi bilgisayarınızdan çıkmaz. Popup'ı açın, bir oda oluşturun, Ayarlar → Audio Processing'e gidin, sıkıştırıcıyı açın ve bir ön ayar seçin. Netflix, Prime Video, Disney+, YouTube ve herhangi bir HTML5 video sitesinde çalışır.",
  "HOWTO_TITLE": "KoalaSync kullanarak arkadaşlarınızla videoları senkronize etme",
  "HOWTO_DESC": "YouTube, Netflix, Twitch ve daha fazlasında arkadaşlarınızla mükemmel uyum içinde herhangi bir videoyu izleyin. Kayıt yok, takip yok.",
  "HOWTO_STEP_1_NAME": "Tarayıcı eklentisini kurun",
@@ -164,5 +174,6 @@
  "MOCK_32": "TEMİZLE",
  "FOOTER_LEGAL_LINK": "imprint",
  "FOOTER_PRIVACY_LINK": "privacy",
+  "FOOTER_DISCLAIMER": "KoalaSync; Netflix, Disney+, Amazon, YouTube, Twitch veya başka herhangi bir yayın platformuna bağlı değildir, bunlar tarafından desteklenmemektedir ve bunlarla ilişkili değildir. Tüm ticari markalar ilgili sahiplerinin mülkiyetindedir.",
  "FOOTER_SUPPORT": "Ko-Fi'de bana kahve ısmarla"
 }
--- a/Show More
+++ b/Show More