@kangsicj/nexussync 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,137 @@
-# 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.0-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">
+
+### [⬇️ 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/dist/NexusSync.meta.js

@@ -0,0 +1,37 @@
+// ==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
+// @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.0
+// @description  Watch-together media sync, cinema mode, live AI subtitles & translation, chat, canvas, bookmarks, presence and viewer mode.
+// @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      esm.sh
+// @connect      cdn.jsdelivr.net
+// @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
+// ==/UserScript==