@kangsicj/nexussync 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,139 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+<img src=".github/assets/banner.svg" alt="NexusSync — watch together, perfectly in sync" width="100%">
+
+<br>
+
+[![Version](https://img.shields.io/badge/version-1.0.1-7C4DFF?style=for-the-badge)](./CHANGELOG.md)
+[![Tampermonkey](https://img.shields.io/badge/Tampermonkey-PC%20%C2%B7%20Android-00485B?style=for-the-badge&logo=tampermonkey&logoColor=white)](https://www.tampermonkey.net/)
+[![iOS Safari](https://img.shields.io/badge/Userscripts-iPhone%20%C2%B7%20iPad-0A84FF?style=for-the-badge&logo=safari&logoColor=white)](https://apps.apple.com/app/userscripts/id1463298887)
+[![Sponsor](https://img.shields.io/badge/Fairy-Sponsor-FF6FB5?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://fairy.hada.io/@jinny)
+
+### Miles apart, same frame.
+
+**NexusSync turns any web video into a shared movie night.**<br>
+Press play on your phone — it plays on theirs. Pause to laugh — everyone pauses with you.
+
+[Features](#-what-it-feels-like) · [Install](#-install) · [Quick start](#-start-in-30-seconds) · [Support](#-support) · [**한국어**](./README_ko.md)
+
+</div>
+
+---
+
+## 🍿 What it feels like
+
+<table>
+<tr>
+<td width="50%" valign="top">
+
+### 🎬 Truly together, down to the frame
+Anyone can play, pause, seek or change speed — and every screen follows within a blink. Devices keep fine-tuning in the background so lips and laughter line up, even between a PC, an iPad and a phone. Bluetooth headphones lagging? Nudge your own device delay in a second.
+
+</td>
+<td width="50%" valign="top">
+
+### 🍿 A cinema on any site
+One tap and the player fills the screen with clean, beautiful controls, a soft ambient glow and the site's subtitles drawn crisply on top. In landscape on a phone, slide the left edge for **brightness** and the right edge for **volume** — just like your favourite video app.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 💬 Talk without leaving the movie
+Messages float up as speech bubbles and drift away on their own. Tap one to answer, or fire off a quick reply — offered in **your** language — and messages from friends abroad are translated for you automatically — in the bubbles and in the full chat.
+
+</td>
+<td valign="top">
+
+### 🙈 A curtain for the scary bits
+Watching with kids? One tap gently covers the picture on **every** screen for a few seconds while sound and subtitles carry on. NexusSync remembers the scene, so it is covered again if you rewind or rewatch.
+
+</td>
+</tr>
+<tr>
+<td valign="top">
+
+### 🖍️ Point, doodle, react
+Draw a quick circle around that actor and it glows on everyone's screen — on the exact same spot of the picture — then fades away. Burst emoji reactions from the edges, send a 💗 nudge, or start a 3-2-1 countdown together.
+
+</td>
+<td valign="top">
+
+### 🧠 Live AI subtitles
+No subtitles on that video? Turn on live speech recognition with translation into your language, with a glossary for names and terms so characters are always spelled right.
+
+</td>
+</tr>
+</table>
+
+## ✨ Little things that matter
+
+- **Next episode, together** — move on to the next episode and you stay in the room; friends follow with one tap.
+- **Make it yours** — pick your name and colour; your bubbles and doodles wear it on every screen.
+- **Calm, never jumpy** — phones going to sleep, slow Wi-Fi or a player restarting on its own never pause the whole room.
+- **No accidental pauses** — tapping the chat, a doodle or a reaction never nudges the video for anyone.
+- **Invisible until needed** — the ⚙️ button appears only next to real videos, never on ordinary pages.
+- **Private rooms** — everything you share in a room is end-to-end encrypted; only people with the PIN can join.
+
+## 📦 Install
+
+<div align="center">
+
+<img src="assets/icon.svg" width="88" alt="NexusSync icon">
+
+### [⬇️ Install NexusSync](https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js)
+
+<sub>Opens the install page of your userscript manager · updates arrive automatically</sub>
+
+</div>
+
+| Device | App | How |
+| --- | --- | --- |
+| 🖥️ Windows · macOS · Linux | [Tampermonkey](https://www.tampermonkey.net/) | Click **Install NexusSync** and confirm. |
+| 📱 iPhone · iPad | [Userscripts](https://apps.apple.com/app/userscripts/id1463298887) for Safari | Open the install link in Safari and tap **Install**. |
+| 🤖 Android | Tampermonkey (Firefox, Edge, Kiwi …) | Same as desktop. |
+
+> [!TIP]
+> Keep every device in a room on the **same version** for the smoothest experience.
+
+## 🚀 Start in 30 seconds
+
+1. Open the same video on each device and tap **⚙️ → 🔗 Connect**.
+2. One person taps **Create a room** and shares the 6-digit **PIN**.
+3. Everyone else types the PIN. Done — enjoy the show together.
+
+<details>
+<summary><b>⌨️ Keyboard shortcuts</b></summary>
+
+| Keys | Action |
+| --- | --- |
+| <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>C</kbd> | Cinema mode |
+| <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> | AI subtitles |
+| <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> · <kbd>H</kbd> in cinema | Cover the picture for everyone |
+| <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>N</kbd> | Open the menu |
+| <kbd>Enter</kbd> | Chat bubble box (in a room) |
+| <kbd>Space</kbd> / <kbd>K</kbd> | Play / pause (cinema) |
+| <kbd>←</kbd> <kbd>→</kbd> · <kbd>J</kbd> <kbd>L</kbd> | Seek 5 s · 10 s |
+| <kbd>↑</kbd> <kbd>↓</kbd> · <kbd>M</kbd> | Volume · mute |
+| <kbd>F</kbd> · <kbd>Z</kbd> · <kbd>C</kbd> · <kbd>?</kbd> | Fullscreen · fit · subtitles · help |
+
+On touch screens: tap for controls, double-tap a side to skip, drag sideways to scrub, long-press to point, and in landscape slide the edges for brightness and volume.
+
+</details>
+
+## 🔐 Your privacy
+
+- Room messages are encrypted on your device; only people in the room can read them.
+- If you add your own AI key for subtitles, it stays in your userscript manager and goes only to that provider.
+- NexusSync never collects personal data, and rooms are cleaned up automatically after everyone leaves.
+
+## 💖 Support
+
+NexusSync is made with love in spare time. If it makes your movie nights a little warmer, you can buy the developer a coffee on **Fairy** — it keeps the servers running and the features coming.
+
+<a href="https://fairy.hada.io/@jinny"><img src="https://img.shields.io/badge/%F0%9F%A7%9A%20Support%20on%20Fairy-FF6FB5?style=for-the-badge" alt="Support on Fairy"></a>
+
+<sub>Maintainers: see <a href="docs/DEVELOPMENT.md">docs/DEVELOPMENT.md</a> · what's new in the <a href="CHANGELOG.md">changelog</a>.</sub>
+
+<div align="right"><sub>Made with 🍿 by <a href="https://github.com/kangsicj">@kangsicj</a></sub></div>

package/assets/icon.svg

@@ -0,0 +1,22 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" role="img" aria-label="NexusSync">
+ <defs>
+  <linearGradient id="nxbg" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#5b2eff"/><stop offset="1" stop-color="#ff4fa3"/></linearGradient>
+  <radialGradient id="nxglow" cx="0.82" cy="0.14" r="0.7"><stop offset="0" stop-color="#7cf9ff" stop-opacity="0.55"/><stop offset="1" stop-color="#7cf9ff" stop-opacity="0"/></radialGradient>
+  <linearGradient id="nxplay" x1="0" y1="0" x2="1" y2="1"><stop offset="0" stop-color="#ffffff"/><stop offset="1" stop-color="#ffe3f1"/></linearGradient>
+  <clipPath id="nxr"><rect width="256" height="256" rx="58"/></clipPath>
+ </defs>
+ <g clip-path="url(#nxr)">
+  <rect width="256" height="256" fill="url(#nxbg)"/>
+  <rect width="256" height="256" fill="url(#nxglow)"/>
+  <!-- sync ring: two arcs chasing each other -->
+  <g fill="none" stroke="#ffffff" stroke-width="15" stroke-linecap="round">
+   <path d="M60 116 A70 70 0 0 1 178 72"/>
+   <path d="M196 140 A70 70 0 0 1 78 184"/>
+  </g>
+  <path d="M186 50 L200 92 L157 86 Z" fill="#ffffff"/>
+  <path d="M70 206 L56 164 L99 170 Z" fill="#ffffff"/>
+  <!-- play -->
+  <path d="M110 92 Q104 88 104 96 L104 160 Q104 168 110 164 L162 132 Q168 128 162 124 Z" fill="url(#nxplay)"/>
+  <circle cx="200" cy="200" r="0" fill="none"/>
+ </g>
+</svg>

package/dist/NexusSync.meta.js

@@ -0,0 +1,36 @@
+// ==UserScript==
+// @name         NexusSync Ultimate: CRDT Canvas & Media Sync
+// @name:ko      넥서스싱크 얼티밋: 캔버스 및 미디어 동기화
+// @name:nl-BE   NexusSync Ultimate: Canvas & Media Synchronisatie
+// @namespace    https://github.com/kangsicj/NexusSync
+// @author       kangsicj
+// @homepageURL  https://github.com/kangsicj/NexusSync
+// @supportURL   https://fairy.hada.io/@jinny
+// @icon         https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/assets/icon.svg
+// @updateURL    https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.meta.js
+// @downloadURL  https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js
+// @version      1.0.1
+// @description  Watch any web video together in perfect sync: cinema mode, live AI subtitles & translation, chat bubbles with auto-translation, quick ink, cover, go-together to the next episode.
+// @description:ko  어떤 웹 영상이든 완벽한 싱크로 함께 보기: 시네마 모드, 실시간 AI 자막·번역, 자동 번역 말풍선 채팅, 잠깐 그리기, 가리기, 다음 화도 함께.
+// @match        *://*/*
+// @include      *
+// @allFrames    true
+// @run-at       document-idle
+// @grant        GM_setValue
+// @grant        GM_getValue
+// @grant        GM_info
+// @grant        GM_xmlhttpRequest
+// @grant        GM_registerMenuCommand
+// @grant        GM.setValue
+// @grant        GM.getValue
+// @grant        GM.listValues
+// @grant        GM.xmlHttpRequest
+// @connect      translate.googleapis.com
+// @connect      nexussync-dd5b4-default-rtdb.asia-southeast1.firebasedatabase.app
+// @connect      api.openai.com
+// @connect      api.groq.com
+// @connect      api.anthropic.com
+// @connect      api-free.deepl.com
+// @connect      api.deepl.com
+// @require      https://cdnjs.cloudflare.com/ajax/libs/lz-string/1.5.0/lz-string.min.js#sha256=95f4d1cbf099f57161b664bc048426ec3df92637801a4c79116e83315aa787e7
+// ==/UserScript==