DhvanilPatel/swarm-cursors

选用指南

AI 根据 README 整理 · 2026/11/5 12:22:20

使用方式

通过Chrome扩展使用，点击工具栏图标或按Alt+Shift+S启动，支持滚动、自动导览、速度调节和声音开关。

查看 README 依据

2. Open `chrome://extensions` and turn on **Developer mode** (top right). 3. Click **Load unpacked** and choose the [`swarm-rebuild/`](swarm-rebuild) folder. 4. Pin it (puzzle icon → pin). ## Use - Click the toolbar icon or press **Alt+Shift+S** on any page. - The page fades out and the cursors orbit the site's favicon, then fan out and start building. - **Scroll** and the swarm chases you, with more agents joining the faster you go. - **Tour** auto-scrolls at the pace the swarm can keep up with. Good for screen recordings. - **1× / 2× / 3×** changes build speed.

- **Sound** is on by default (🔊 in the toolbar, or press **M**). If the page hasn't been clicked yet, Chrome keeps audio locked and the button says **Tap for sound**; one click anywhere starts it. - When it's done, the cursors flock to your mouse. **Go live** fades back to the real, clickable page; **Replay** builds it again. - **Esc**, **✕**, or clicking the icon again exits at any time.

部署要求

需要Chrome浏览器，并启用开发者模式以加载未打包的扩展。

查看 README 依据

The motion design is his: the cursor set, the swarm and flocking physics, the build choreography (rects, typing, guides, duplicates), the rulers and the overall look. Large parts of the animation engine here are adapted directly from his site. What this project adds is the part that points it at *any* page: snapshotting a live DOM into a blueprint the swarm can rebuild, plus the extension around it. Go look at the original. It's better than this. ## Install It isn't on the Chrome Web Store yet, so load it unpacked: 1. Clone or download this repo.

2. Open `chrome://extensions` and turn on **Developer mode** (top right). 3. Click **Load unpacked** and choose the [`swarm-rebuild/`](swarm-rebuild) folder. 4. Pin it (puzzle icon → pin). ## Use - Click the toolbar icon or press **Alt+Shift+S** on any page. - The page fades out and the cursors orbit the site's favicon, then fan out and start building. - **Scroll** and the swarm chases you, with more agents joining the faster you go. - **Tour** auto-scrolls at the pace the swarm can keep up with. Good for screen recordings. - **1× / 2× / 3×** changes build speed.

已知限制

无法在chrome://页面、Chrome网上应用店或PDF查看器上运行；是视觉重建而非克隆，动画在点击时冻结，部分伪元素和媒体可能变为占位符；长页面有层数和像素上限。

查看 README 依据

| `store/` | Chrome Web Store listing copy, screenshots and promo tile | | `scripts/package.sh` | Builds the zip to upload to the Web Store | ## Limits - Chrome doesn't let extensions run on `chrome://` pages, the Web Store or the PDF viewer. The icon shows a red × there. - It's a visual rebuild, not a clone. Animations freeze at the moment you click, decorative pseudo-elements are skipped when their position can't be worked out, and canvases, videos and iframes below the first screen become placeholders.

- Web components are rebuilt as plain styled elements, so none of the page's scripts run inside the swarm's layer. - Very long pages are capped at about 4,000 layers / 40,000px. ## Publishing `./scripts/package.sh` writes `dist/swarm-rebuild-<version>.zip` for the [Chrome Web Store Developer Dashboard](https://chrome.google.com/webstore/devconsole). Listing text, permission justifications and assets are in [`store/`](store), and the privacy policy is [`PRIVACY.md`](PRIVACY.md). ## License