@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/LICENSE +674 -0
- package/README.md +45 -111
- package/dist/NexusSync.meta.js +2 -2
- package/dist/NexusSync.user.js +317 -233
- package/package.json +6 -6
package/README.md
CHANGED
|
@@ -1,117 +1,54 @@
|
|
|
1
1
|
<div align="center">
|
|
2
2
|
|
|
3
|
-
<img src=".github/assets/banner.svg" alt="NexusSync
|
|
3
|
+
<img src=".github/assets/banner-en.svg" alt="NexusSync" width="100%">
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
**A userscript that synchronizes playback of any web video across devices, with chat, drawing and live AI subtitles.**
|
|
6
6
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
[](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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
67
|
-
</tr>
|
|
68
|
-
</table>
|
|
20
|
+
## Quick start
|
|
69
21
|
|
|
70
|
-
|
|
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
|
-
|
|
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
|
-
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
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
|
-
|
|
|
101
|
-
|
|
|
102
|
-
|
|
|
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
|
-
|
|
49
|
+
Updates are installed automatically. Keep all devices in a room on the same version.
|
|
108
50
|
|
|
109
|
-
|
|
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
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|
-
|
|
73
|
+
## Support
|
|
141
74
|
|
|
142
|
-
<a href="https://fairy.hada.io/@
|
|
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
|
-
|
|
78
|
+
## License
|
|
145
79
|
|
|
146
|
-
|
|
80
|
+
[GNU GPL v3.0](LICENSE). Development notes: [docs/DEVELOPMENT.md](docs/DEVELOPMENT.md) · [CHANGELOG](CHANGELOG.md)
|
package/dist/NexusSync.meta.js
CHANGED
|
@@ -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/@
|
|
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.
|
|
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 *://*/*
|