@kangsicj/nexussync 1.5.0 → 1.6.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,117 +1,54 @@
1
1
  <div align="center">
2
2
 
3
- <img src=".github/assets/banner.svg" alt="NexusSync — watch together, perfectly in sync" width="100%">
3
+ <img src=".github/assets/banner-en.svg" alt="NexusSync" width="100%">
4
4
 
5
- <br>
5
+ **A userscript that synchronizes playback of any web video across devices, with chat, drawing and live AI subtitles.**
6
6
 
7
- [![Version](https://img.shields.io/badge/version-1.5.0-7C4DFF?style=for-the-badge)](./CHANGELOG.md)
8
- [![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/)
9
- [![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)
10
- [![Sponsor](https://img.shields.io/badge/Fairy-Sponsor-FF6FB5?style=for-the-badge&logo=githubsponsors&logoColor=white)](https://fairy.hada.io/@jinny)
7
+ <a href="https://www.npmjs.com/package/@kangsicj/nexussync"><img src="https://img.shields.io/npm/v/%40kangsicj%2Fnexussync?style=flat-square&label=version" alt="Version"></a>
8
+ <img src="https://img.shields.io/badge/platform-iOS%20%C2%B7%20Android%20%C2%B7%20PC-555?style=flat-square" alt="Platform">
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-GPL--3.0-blue?style=flat-square" alt="License"></a>
11
10
 
12
- ### Miles apart, same frame.
13
-
14
- **NexusSync turns any web video into a shared movie night.**<br>
15
- Press play on your phone — it plays on theirs. Pause to laugh — everyone pauses with you.
16
-
17
- [Features](#-what-it-feels-like) · [Install](#-install) · [Quick start](#-start-in-30-seconds) · [Support](#-support) · [**한국어**](./README_ko.md)
11
+ **English** · [한국어](README_ko.md)
18
12
 
19
13
  </div>
20
14
 
21
- ---
22
-
23
- ## 🍿 What it feels like
24
-
25
- <table>
26
- <tr>
27
- <td width="50%" valign="top">
28
-
29
- ### 🎬 Truly together, down to the frame
30
- 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.
31
-
32
- </td>
33
- <td width="50%" valign="top">
34
-
35
- ### 🍿 A cinema on any site
36
- 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.
37
-
38
- </td>
39
- </tr>
40
- <tr>
41
- <td valign="top">
42
-
43
- ### 💬 Talk without leaving the movie
44
- 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 chat history (Settings → Advanced), which you can also save.
45
-
46
- </td>
47
- <td valign="top">
48
-
49
- ### 🙈 A curtain for the scary bits
50
- 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.
51
-
52
- </td>
53
- </tr>
54
- <tr>
55
- <td valign="top">
56
-
57
- ### 🖍️ Point, doodle, react
58
- 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.
15
+ <p align="center"><img src=".github/assets/cinema-en.png" alt="Cinema mode with NexusSync controls" width="49%"> <img src=".github/assets/menu-en.png" alt="NexusSync menu" width="49%"></p>
59
16
 
60
- </td>
61
- <td valign="top">
17
+ <sub>Sample video and page are original illustrations made for this README.</sub>
62
18
 
63
- ### 🧠 Live AI subtitles
64
- No subtitles on that video? Pick your language, choose **video sound** and press Start — NexusSync listens to the video itself and writes live, translated subtitles, with a glossary so names are always spelled right.
65
19
 
66
- </td>
67
- </tr>
68
- </table>
20
+ ## Quick start
69
21
 
70
- ## ✨ Little things that matter
22
+ 1. Install [`NexusSync.user.js`](https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js) in Tampermonkey or Userscripts.
23
+ 2. Open the same video on each device → **⚙️ → 🔗 Connect** → one device taps **Create a room**.
24
+ 3. Other devices enter the 6-digit PIN.
71
25
 
72
- - **Next episode, together** — move on to the next episode and you stay in the room; friends follow with one tap. Near the end, an *Up next* card counts down and opens it for you.
73
- - **Cinema by itself** — open a page with one movie or episode and it switches to cinema as soon as the video is ready, keeping the site's player so you can still pick subtitles or a server. Turn it off per site.
74
- - **Two sites, one film** — different versions (an extra logo, a longer intro)? *Sync timing* lines them up: compare both screens, mark the same scene, or let it find the difference automatically.
75
- - **Subtitles for anything** — the video's own tracks, your file, or OpenSubtitles in one tap (it finds the English title for you), up to three at once for language study, drawn in one clear style with timing and size; brightness for dark films.
76
- - **Two versions, one moment** — NexusSync notices when you play different versions of a film and lines the timing up by itself.
77
- - **Make it personal** — avatar, status message and your own eight reaction emoji; choose what reaches you and hide anyone for the room.
78
- - **See who's here** — everyone in the room is listed by name and colour, with a 💤 when someone's screen is off.
79
- - **Make it yours** — pick your name and colour; your bubbles and doodles wear it on every screen.
80
- - **Calm, never jumpy** — phones going to sleep, slow Wi-Fi or a player restarting on its own never pause the whole room.
81
- - **No accidental pauses** — tapping the chat, a doodle or a reaction never nudges the video for anyone.
82
- - **No ad interruptions** — ad boxes and links laid over the video are hidden while you watch, and ad pop-ups opened by a tap on the player are stopped.
83
- - **Invisible until needed** — the ⚙️ button appears only next to real videos, never on ordinary pages.
84
- - **Private rooms** — everything you share in a room is end-to-end encrypted; only people with the PIN can join.
26
+ ## Features
85
27
 
86
- ## 📦 Install
87
-
88
- <div align="center">
89
-
90
- <img src="assets/icon.svg" width="88" alt="NexusSync icon">
91
-
92
- ### [⬇️ Install NexusSync](https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js)
93
-
94
- <sub>Opens the install page of your userscript manager · updates arrive automatically</sub>
95
-
96
- </div>
97
-
98
- | Device | App | How |
28
+ | Feature | Description |
29
+ | --- | --- |
30
+ | Playback sync | Play, pause, seek and speed propagate to every device; continuous drift correction; per-device delay offset for Bluetooth audio |
31
+ | Cinema mode | Full-screen player with custom controls and site subtitles; edge swipe for brightness and volume on phones; auto-enables on single-video pages |
32
+ | Chat | Floating speech bubbles, quick replies, automatic translation of incoming messages, exportable history |
33
+ | Drawing and reactions | Strokes anchored to the video frame on every screen; emoji bursts; 3-2-1 countdown |
34
+ | Cover | Hides the picture on all screens for a few seconds; audio and subtitles continue; replays the cover on rewind |
35
+ | AI subtitles | Transcribes video audio into translated live subtitles; glossary for names; bring-your-own API key |
36
+ | Subtitles | Video tracks, local files or OpenSubtitles; up to 3 tracks at once |
37
+ | Timing sync | Aligns two different releases of the same film (offset by manual mark or automatic detection) |
38
+ | Next episode | Room persists across episodes; *Up next* countdown |
39
+ | Privacy | End-to-end encrypted rooms, PIN to join, rooms deleted after everyone leaves |
40
+
41
+ ## Installation
42
+
43
+ | Platform | Manager | Steps |
99
44
  | --- | --- | --- |
100
- | 🖥️ Windows · macOS · Linux | [Tampermonkey](https://www.tampermonkey.net/) | Click **Install NexusSync** and confirm. |
101
- | 📱 iPhone · iPad | [Userscripts](https://apps.apple.com/app/userscripts/id1463298887) for Safari | Open the install link in Safari and tap **Install**. |
102
- | 🤖 Android | Tampermonkey (Firefox, Edge, Kiwi …) | Same as desktop. |
103
-
104
- > [!TIP]
105
- > Keep every device in a room on the **same version** for the smoothest experience.
45
+ | Windows · macOS · Linux | [Tampermonkey](https://www.tampermonkey.net/) | Open the [install link](https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js) → **Install** |
46
+ | iPhone · iPad | [Userscripts](https://apps.apple.com/app/userscripts/id1463298887) (Safari) | Open the install link in Safari → **Install** |
47
+ | Android | Tampermonkey (Firefox, Edge, Kiwi) | Same as desktop |
106
48
 
107
- ## 🚀 Start in 30 seconds
49
+ Updates are installed automatically. Keep all devices in a room on the same version.
108
50
 
109
- 1. Open the same video on each device and tap **⚙️ → 🔗 Connect**.
110
- 2. One person taps **Create a room** and shares the 6-digit **PIN**.
111
- 3. Everyone else types the PIN. Done — enjoy the show together.
112
-
113
- <details>
114
- <summary><b>⌨️ Keyboard shortcuts</b></summary>
51
+ ## Keyboard shortcuts
115
52
 
116
53
  | Keys | Action |
117
54
  | --- | --- |
@@ -119,28 +56,25 @@ No subtitles on that video? Pick your language, choose **video sound** and press
119
56
  | <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>T</kbd> | AI subtitles |
120
57
  | <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>H</kbd> · <kbd>H</kbd> in cinema | Cover the picture for everyone |
121
58
  | <kbd>Alt</kbd>+<kbd>Shift</kbd>+<kbd>N</kbd> | Open the menu |
122
- | <kbd>Enter</kbd> | Chat bubble box (in a room) |
59
+ | <kbd>Enter</kbd> | Chat input (in a room) |
123
60
  | <kbd>Space</kbd> / <kbd>K</kbd> | Play / pause (cinema) |
124
61
  | <kbd>←</kbd> <kbd>→</kbd> · <kbd>J</kbd> <kbd>L</kbd> | Seek 5 s · 10 s |
125
62
  | <kbd>↑</kbd> <kbd>↓</kbd> · <kbd>M</kbd> | Volume · mute |
126
63
  | <kbd>F</kbd> · <kbd>Z</kbd> · <kbd>C</kbd> · <kbd>?</kbd> | Fullscreen · fit · subtitles · help |
127
64
 
128
- 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.
129
-
130
- </details>
131
-
132
- ## 🔐 Your privacy
65
+ Touch: tap for controls, double-tap a side to skip, drag to scrub, long-press to point.
133
66
 
134
- - Room messages are encrypted on your device; only people in the room can read them.
135
- - If you add your own AI key for subtitles, it stays in your userscript manager and goes only to that provider.
136
- - NexusSync never collects personal data, and rooms are cleaned up automatically after everyone leaves.
67
+ ## Privacy
137
68
 
138
- ## 💖 Support
69
+ - Room messages are encrypted on the device; only room members can decrypt them.
70
+ - A user-supplied AI key is stored in the userscript manager and sent only to that provider.
71
+ - No personal data is collected. Rooms are deleted after all members leave.
139
72
 
140
- 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.
73
+ ## Support
141
74
 
142
- <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>
75
+ <a href="https://fairy.hada.io/@kangsicj"><img src="https://img.shields.io/badge/Fairy-Support-ff6fb5?style=flat-square&logo=githubsponsors&logoColor=white" alt="Support on Fairy"></a>
76
+ <a href="https://buymeacoffee.com/kangsicj"><img src="https://img.shields.io/badge/Buy%20Me%20a%20Coffee-Support-ffdd00?style=flat-square&logo=buymeacoffee&logoColor=black" alt="Buy Me a Coffee"></a>
143
77
 
144
- <sub>Maintainers: see <a href="docs/DEVELOPMENT.md">docs/DEVELOPMENT.md</a> · what's new in the <a href="CHANGELOG.md">changelog</a>.</sub>
78
+ ## License
145
79
 
146
- <div align="right"><sub>Made with 🍿 by <a href="https://github.com/kangsicj">@kangsicj</a></sub></div>
80
+ [GNU GPL v3.0](LICENSE). Development notes: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) · [CHANGELOG](CHANGELOG.md)
@@ -4,11 +4,11 @@
4
4
  // @namespace https://github.com/kangsicj/NexusSync
5
5
  // @author kangsicj
6
6
  // @homepageURL https://github.com/kangsicj/NexusSync
7
- // @supportURL https://fairy.hada.io/@jinny
7
+ // @supportURL https://fairy.hada.io/@kangsicj
8
8
  // @icon https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/assets/icon.svg
9
9
  // @updateURL https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.meta.js
10
10
  // @downloadURL https://cdn.jsdelivr.net/npm/@kangsicj/nexussync@latest/dist/NexusSync.user.js
11
- // @version 1.5.0
11
+ // @version 1.6.1
12
12
  // @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.
13
13
  // @description:ko 어떤 웹 영상이든 완벽한 싱크로 함께 보기: 시네마 모드, 실시간 AI 자막·번역, 자동 번역 말풍선 채팅, 잠깐 그리기, 가리기, 다음 화도 함께.
14
14
  // @match *://*/*