Skip to content

Record your screen, ship a demo. Free and open-source, GPU-accelerated, no watermarks, no subscriptions. Windows, macOS, Linux. Actively maintained.

fix(cursor): stop shipping the sweezy-cursors.com packs

EtienneLescot590fcc822a75
diff --git a/README.md b/README.md
index de72920f8..872f99144 100644
--- a/README.md
+++ b/README.md
@@ -37,7 +37,7 @@ A raw capture goes in and comes out ready to post — on X, Reddit, YouTube, a d
- Record microphone and system audio.
- Webcam overlay with picture-in-picture, eight snap positions, adjustable roundness, mirroring, and shape options.
- Auto or manual zooms with adjustable depth, duration, easing, and pixel-precise position; auto-zoom follows your cursor as you work.
-- Custom cursor size, smoothing, and click effects, with cursor themes and post-recording path smoothing.
+- Custom cursor size, smoothing, and click effects, with post-recording path smoothing.
- Automatic captions for voiceovers, transcribed on-device with no upload (works offline), with an editable transcript you can cut from and optional subtitle translation.
- AI editing assistant: describe the edit you want in chat and it applies to the timeline — cuts, zooms, speed ramps, annotations, camera framing. Bring your own key (Claude, OpenAI, Gemini, Mistral, OpenRouter, MiniMax, or any OpenAI-compatible endpoint); nothing is enabled by default.
- Wallpapers, solid colors, gradients, or your own background image.
@@ -176,7 +176,7 @@ You may need to grant screen recording permissions depending on your desktop env
Everything in the editor and export is the same on macOS, Windows, and Linux: zooms, backgrounds, motion blur, crop/trim/speed, blur regions, annotations, auto-captions, AI editing, projects, export, and all languages. All three now record through a native capture pipeline; the remaining differences are narrower than they used to be:
- **Native recording**: macOS (ScreenCaptureKit), Windows (Windows Graphics Capture), and Linux (PipeWire via the ScreenCast portal) all record through a native pipeline for higher quality and clean window-level capture. On Linux the browser pipeline stays as an automatic fallback if the helper isn't available.
-- **Custom cursors**: on macOS and Windows the real cursor is captured with shape, type, and clicks. Linux captures position and cursor shape through the portal, so cursor themes and the editable cursor overlay work there too. Click effects work on Linux as well, but not through the portal — Wayland exposes no portal for mouse buttons, so the capture helper reads the left button from evdev, which needs your user in the `input` group. Without that, recording is unaffected and every cursor sample is simply a move.
+- **Custom cursors**: on macOS and Windows the real cursor is captured with shape, type, and clicks. Linux captures position and cursor shape through the portal, so the editable cursor overlay works there too. Click effects work on Linux as well, but not through the portal — Wayland exposes no portal for mouse buttons, so the capture helper reads the left button from evdev, which needs your user in the `input` group. Without that, recording is unaffected and every cursor sample is simply a move.
- **Webcam**: every platform saves the webcam as a separate file next to the screen recording. Windows captures it natively in the recording helper; macOS and Linux record it in the app. It works as a picture-in-picture overlay on all three.
- **System audio** support varies by OS:
- **macOS**: works on every supported version. On macOS 14.2+ you'll be prompted to grant audio capture permission.
diff --git a/docs/3d-effects-v2.md b/docs/3d-effects-v2.md
index 57c6c6613..5e68938fd 100644
--- a/docs/3d-effects-v2.md
+++ b/docs/3d-effects-v2.md
@@ -384,8 +384,7 @@ de la pastille ; plus rien après sa fenêtre.
### B.7 Limites
-- Seul le thème par défaut est modélisé ; les thèmes sweezy (art de 128 px, bords non
- détourés) restent plats.
+- Seul le thème par défaut est modélisé ; un thème de curseur ajouté plus tard resterait plat.
- Un pointeur basculé montre le flanc de sa queue, de la couleur de son bord : la main qui
pointe gagne un liseré noir au bas de la paume. C'est la 3D, pas un défaut.
- Un dessus plat (curseur centré) reçoit 0,88 de la lumière : son blanc sort gris clair (226),
diff --git a/electron/native-bridge/services/compositorViewService.test.ts b/electron/native-bridge/services/compositorViewService.test.ts
index f479912be..aa3b88a1d 100644
--- a/electron/native-bridge/services/compositorViewService.test.ts
+++ b/electron/native-bridge/services/compositorViewService.test.ts
@@ -449,8 +449,8 @@ describe("resolveSceneAssetPaths", () => {
if (!themed) return;
const sprites = resolved({ cursor: { theme: themed.id } }).cursor.cursorSprites;
- // The sweezy packs only carry an arrow and a pointer, but a recording walks through
- // far more states than that — each one still has to get its own sprite.
+ // A pack may carry only an arrow and a pointer, but a recording walks through far
+ // more states than that — each one still has to get its own sprite.
expect(sprites.text.path).toBe(path.join(resources, "cursors", "default", "text.png"));
expect(sprites["resize-ew"].path).toContain(path.join("cursors", "default"));
expect(Object.keys(sprites).sort()).toEqual(Object.keys(DEFAULT_CURSOR_SPRITES).sort());
diff --git a/public/cursors/among-us-sus-knife-and-red-animated/arrow.png b/public/cursors/among-us-sus-knife-and-red-animated/arrow.png
deleted file mode 100644
index 84e9a3b34..000000000
Binary files a/public/cursors/among-us-sus-knife-and-red-animated/arrow.png and /dev/null differ
diff --git a/public/cursors/among-us-sus-knife-and-red-animated/pointer.png b/public/cursors/among-us-sus-knife-and-red-animated/pointer.png
deleted file mode 100644
index b4212f732..000000000
Binary files a/public/cursors/among-us-sus-knife-and-red-animated/pointer.png and /dev/null differ
diff --git a/public/cursors/black-and-rainbow-stroke-gradient-animated/arrow.png b/public/cursors/black-and-rainbow-stroke-gradient-animated/arrow.png
deleted file mode 100644
index adfcec8dc..000000000
Binary files a/public/cursors/black-and-rainbow-stroke-gradient-animated/arrow.png and /dev/null differ
diff --git a/public/cursors/black-and-rainbow-stroke-gradient-animated/pointer.png b/public/cursors/black-and-rainbow-stroke-gradient-animated/pointer.png
deleted file mode 100644
index 2a0ebf08f..000000000
Binary files a/public/cursors/black-and-rainbow-stroke-gradient-animated/pointer.png and /dev/null differ
diff --git a/public/cursors/black-pixel/arrow.png b/public/cursors/black-pixel/arrow.png
deleted file mode 100644
index ec2d6a315..000000000
Binary files a/public/cursors/black-pixel/arrow.png and /dev/null differ
diff --git a/public/cursors/black-pixel/pointer.png b/public/cursors/black-pixel/pointer.png
deleted file mode 100644
index ffd561641..000000000
Binary files a/public/cursors/black-pixel/pointer.png and /dev/null differ
diff --git a/public/cursors/christmas-miles-morales/arrow.png b/public/cursors/christmas-miles-morales/arrow.png
deleted file mode 100644
index 6931394ec..000000000
Binary files a/public/cursors/christmas-miles-morales/arrow.png and /dev/null differ
diff --git a/public/cursors/christmas-miles-morales/pointer.png b/public/cursors/christmas-miles-morales/pointer.png
deleted file mode 100644
index 049a68e2e..000000000
Binary files a/public/cursors/christmas-miles-morales/pointer.png and /dev/null differ
diff --git a/public/cursors/hello-kitty-watermelon/arrow.png b/public/cursors/hello-kitty-watermelon/arrow.png
deleted file mode 100644
index 9e6a20319..000000000
Binary files a/public/cursors/hello-kitty-watermelon/arrow.png and /dev/null differ
diff --git a/public/cursors/hello-kitty-watermelon/pointer.png b/public/cursors/hello-kitty-watermelon/pointer.png
deleted file mode 100644
index f45fdfd06..000000000
Binary files a/public/cursors/hello-kitty-watermelon/pointer.png and /dev/null differ
diff --git a/public/cursors/hollow-knight-and-game-arrow/arrow.png b/public/cursors/hollow-knight-and-game-arrow/arrow.png
deleted file mode 100644
index efb4b7708..000000000
Binary files a/public/cursors/hollow-knight-and-game-arrow/arrow.png and /dev/null differ
diff --git a/public/cursors/hollow-knight-and-game-arrow/pointer.png b/public/cursors/hollow-knight-and-game-arrow/pointer.png
deleted file mode 100644
index dcea8e91d..000000000
Binary files a/public/cursors/hollow-knight-and-game-arrow/pointer.png and /dev/null differ
diff --git a/public/cursors/hollow-knight-nail-sword-and-mask/arrow.png b/public/cursors/hollow-knight-nail-sword-and-mask/arrow.png
deleted file mode 100644
index dbd4f52a2..000000000
Binary files a/public/cursors/hollow-knight-nail-sword-and-mask/arrow.png and /dev/null differ
diff --git a/public/cursors/hollow-knight-nail-sword-and-mask/pointer.png b/public/cursors/hollow-knight-nail-sword-and-mask/pointer.png
deleted file mode 100644
index ac77b710c..000000000
Binary files a/public/cursors/hollow-knight-nail-sword-and-mask/pointer.png and /dev/null differ
diff --git a/public/cursors/mickey-mouse-black-hand-inflated-glove/arrow.png b/public/cursors/mickey-mouse-black-hand-inflated-glove/arrow.png
deleted file mode 100644
index 143076372..000000000
Binary files a/public/cursors/mickey-mouse-black-hand-inflated-glove/arrow.png and /dev/null differ
diff --git a/public/cursors/mickey-mouse-black-hand-inflated-glove/pointer.png b/public/cursors/mickey-mouse-black-hand-inflated-glove/pointer.png
deleted file mode 100644
index f52a4e650..000000000
Binary files a/public/cursors/mickey-mouse-black-hand-inflated-glove/pointer.png and /dev/null differ
diff --git a/public/cursors/naruto-akatsuki-cloud-arrow/arrow.png b/public/cursors/naruto-akatsuki-cloud-arrow/arrow.png
deleted file mode 100644
index d6361dff2..000000000
Binary files a/public/cursors/naruto-akatsuki-cloud-arrow/arrow.png and /dev/null differ
diff --git a/public/cursors/naruto-akatsuki-cloud-arrow/pointer.png b/public/cursors/naruto-akatsuki-cloud-arrow/pointer.png
deleted file mode 100644
index fa10e9d2d..000000000
Binary files a/public/cursors/naruto-akatsuki-cloud-arrow/pointer.png and /dev/null differ
diff --git a/public/cursors/old-roblox/arrow.png b/public/cursors/old-roblox/arrow.png
deleted file mode 100644
index a55875df9..000000000
Binary files a/public/cursors/old-roblox/arrow.png and /dev/null differ
diff --git a/public/cursors/old-roblox/pointer.png b/public/cursors/old-roblox/pointer.png
deleted file mode 100644
index d490a65fd..000000000
Binary files a/public/cursors/old-roblox/pointer.png and /dev/null differ
diff --git a/public/cursors/pink-glossy-arrow-and-hand-3d/arrow.png b/public/cursors/pink-glossy-arrow-and-hand-3d/arrow.png
deleted file mode 100644
index 69ecd5b19..000000000
Binary files a/public/cursors/pink-glossy-arrow-and-hand-3d/arrow.png and /dev/null differ
diff --git a/public/cursors/pink-glossy-arrow-and-hand-3d/pointer.png b/public/cursors/pink-glossy-arrow-and-hand-3d/pointer.png
deleted file mode 100644
index f8d5938a7..000000000
Binary files a/public/cursors/pink-glossy-arrow-and-hand-3d/pointer.png and /dev/null differ
diff --git a/public/cursors/pinky-pixel/arrow.png b/public/cursors/pinky-pixel/arrow.png
deleted file mode 100644
index 4bcd3dcaa..000000000
Binary files a/public/cursors/pinky-pixel/arrow.png and /dev/null differ
diff --git a/public/cursors/pinky-pixel/pointer.png b/public/cursors/pinky-pixel/pointer.png
deleted file mode 100644
index 7eb897a74..000000000
Binary files a/public/cursors/pinky-pixel/pointer.png and /dev/null differ
diff --git a/public/cursors/pokemon-neon-gengar/arrow.png b/public/cursors/pokemon-neon-gengar/arrow.png
deleted file mode 100644
index 4dcccb360..000000000
Binary files a/public/cursors/pokemon-neon-gengar/arrow.png and /dev/null differ
diff --git a/public/cursors/pokemon-neon-gengar/pointer.png b/public/cursors/pokemon-neon-gengar/pointer.png
deleted file mode 100644
index e7b4437f0..000000000
Binary files a/public/cursors/pokemon-neon-gengar/pointer.png and /dev/null differ
diff --git a/public/cursors/sanrio-gudetama-and-arrow-kawaii/arrow.png b/public/cursors/sanrio-gudetama-and-arrow-kawaii/arrow.png
deleted file mode 100644
index 123117b05..000000000
Binary files a/public/cursors/sanrio-gudetama-and-arrow-kawaii/arrow.png and /dev/null differ
diff --git a/public/cursors/sanrio-gudetama-and-arrow-kawaii/pointer.png b/public/cursors/sanrio-gudetama-and-arrow-kawaii/pointer.png
deleted file mode 100644
index 37afa7bd1..000000000
Binary files a/public/cursors/sanrio-gudetama-and-arrow-kawaii/pointer.png and /dev/null differ
diff --git a/public/cursors/sanrio-kuromi-skull-arrow/arrow.png b/public/cursors/sanrio-kuromi-skull-arrow/arrow.png
deleted file mode 100644
index 6fe7e89d6..000000000
Binary files a/public/cursors/sanrio-kuromi-skull-arrow/arrow.png and /dev/null differ
diff --git a/public/cursors/sanrio-kuromi-skull-arrow/pointer.png b/public/cursors/sanrio-kuromi-skull-arrow/pointer.png
deleted file mode 100644
index 2971a7f16..000000000
Binary files a/public/cursors/sanrio-kuromi-skull-arrow/pointer.png and /dev/null differ
diff --git a/public/cursors/solo-leveling-sung-jinwoo-dark-flames/arrow.png b/public/cursors/solo-leveling-sung-jinwoo-dark-flames/arrow.png
deleted file mode 100644
index 2155e0fd9..000000000
Binary files a/public/cursors/solo-leveling-sung-jinwoo-dark-flames/arrow.png and /dev/null differ
diff --git a/public/cursors/solo-leveling-sung-jinwoo-dark-flames/pointer.png b/public/cursors/solo-leveling-sung-jinwoo-dark-flames/pointer.png
deleted file mode 100644
index 0e0b1a0b7..000000000
Binary files a/public/cursors/solo-leveling-sung-jinwoo-dark-flames/pointer.png and /dev/null differ
diff --git a/public/cursors/spring-gradient/arrow.png b/public/cursors/spring-gradient/arrow.png
deleted file mode 100644
index 51889625d..000000000
Binary files a/public/cursors/spring-gradient/arrow.png and /dev/null differ
diff --git a/public/cursors/spring-gradient/pointer.png b/public/cursors/spring-gradient/pointer.png
deleted file mode 100644
index 9ccdc2fb6..000000000
Binary files a/public/cursors/spring-gradient/pointer.png and /dev/null differ
diff --git a/scripts/generate-default-cursor-sprites.mjs b/scripts/generate-default-cursor-sprites.mjs
index d98b2180e..2fb957680 100644
--- a/scripts/generate-default-cursor-sprites.mjs
+++ b/scripts/generate-default-cursor-sprites.mjs
@@ -7,7 +7,7 @@
// default art and falls back to a math dot+ring, which is not what the OS cursor
// looks like.
//
-// The PNGs are cropped to the art's alpha bounds. The sweezy theme packs fill their
+// The PNGs are cropped to the art's alpha bounds. A theme pack typically fills its
// 128x128 box edge to edge, while the built-in SVGs sit in the middle of a 32-unit
// canvas using only ~55% of it — uncropped, every built-in cursor would render about
// half the size of a themed one at the same size slider. Cropping puts both on the
diff --git a/src/components/ai-edition/CursorPane.preview.test.tsx b/src/components/ai-edition/CursorPane.preview.test.tsx
index e3336b963..4cc3a99a9 100644
--- a/src/components/ai-edition/CursorPane.preview.test.tsx
+++ b/src/components/ai-edition/CursorPane.preview.test.tsx
@@ -3,6 +3,7 @@ import { cleanup, render, screen } from "@testing-library/react";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { I18nProvider } from "@/contexts/I18nContext";
import { LOCALE_STORAGE_KEY } from "@/i18n/config";
+import { CURSOR_THEMES } from "@/lib/cursor/cursorThemes";
import { CursorPane } from "./RightPanes";
function stubStorage() {
@@ -35,24 +36,16 @@ afterEach(() => {
cleanup();
});
-describe("CursorPane theme previews", () => {
- it("full: hello-kitty-watermelon theme cell shows arrow and pointer", () => {
+describe("CursorPane theme picker", () => {
+ it("is hidden while the default art is the only choice", () => {
+ // Fails on purpose once a pack ships: the picker then has something to offer.
+ expect(CURSOR_THEMES).toHaveLength(0);
render(
<I18nProvider>
<CursorPane />
</I18nProvider>,
);
- const cell = screen.getByRole("button", { name: "Hello Kitty & Watermelon" });
- expect(cell.querySelectorAll("img")).toHaveLength(2);
- });
-
- it("empty: default theme cell shows a single preview img", () => {
- render(
- <I18nProvider>
- <CursorPane />
- </I18nProvider>,
- );
- const cell = screen.getByRole("button", { name: "Default" });
- expect(cell.querySelectorAll("img")).toHaveLength(1);
+ expect(screen.queryByText("Cursor Style")).toBeNull();
+ expect(screen.queryByRole("button", { name: "Default" })).toBeNull();
});
});
diff --git a/src/components/ai-edition/RightPanes.tsx b/src/components/ai-edition/RightPanes.tsx
index 625c94d1d..55d3065e0 100644
--- a/src/components/ai-edition/RightPanes.tsx
+++ b/src/components/ai-edition/RightPanes.tsx
@@ -3787,38 +3787,44 @@ export function CursorPane() {
onChange={(v) => void set({ cursor: { alwaysArrow: v } })}
/>
</div>
- <div className={styles.sectionLabel}>{ts("cursor.theme")}</div>
- <div className={styles.cursorGrid}>
- {cursorThemeOptions.map((option) => {
- const isActive = settings.cursorTheme === option.id;
- return (
- <button
- type="button"
- key={option.id}
- className={`${styles.cursorCell} ${isActive ? styles.isActive : ""}`}
- title={option.name}
- aria-label={option.name}
- aria-pressed={isActive}
- disabled={!hasDocument}
- onClick={() => void set({ cursor: { theme: option.id } })}
- >
- <span className={styles.cursorCellPreviews}>
- {option.previewUrls.map((url) => (
- <img
- key={url}
- src={url}
- alt=""
- width={option.previewUrls.length > 1 ? 14 : 20}
- height={option.previewUrls.length > 1 ? 14 : 20}
- draggable={false}
- style={{ objectFit: "contain", pointerEvents: "none" }}
- />
- ))}
- </span>
- </button>
- );
- })}
- </div>
+ {/* One option is not a choice: the picker shows once a pack ships beside the
+ default art (see CURSOR_THEMES). */}
+ {cursorThemeOptions.length > 1 ? (
+ <>
+ <div className={styles.sectionLabel}>{ts("cursor.theme")}</div>
+ <div className={styles.cursorGrid}>
+ {cursorThemeOptions.map((option) => {
+ const isActive = settings.cursorTheme === option.id;
+ return (
+ <button
+ type="button"
+ key={option.id}
+ className={`${styles.cursorCell} ${isActive ? styles.isActive : ""}`}
+ title={option.name}
+ aria-label={option.name}
+ aria-pressed={isActive}
+ disabled={!hasDocument}
+ onClick={() => void set({ cursor: { theme: option.id } })}
+ >
+ <span className={styles.cursorCellPreviews}>
+ {option.previewUrls.map((url) => (
+ <img
+ key={url}
+ src={url}
+ alt=""
+ width={option.previewUrls.length > 1 ? 14 : 20}
+ height={option.previewUrls.length > 1 ? 14 : 20}
+ draggable={false}
+ style={{ objectFit: "contain", pointerEvents: "none" }}
+ />
+ ))}
+ </span>
+ </button>
+ );
+ })}
+ </div>
+ </>
+ ) : null}
<div className={styles.sliderGrid}>
<SliderCell
label={ts("cursor.size")}
diff --git a/src/lib/ai-edition/store/editorSettings.test.ts b/src/lib/ai-edition/store/editorSettings.test.ts
index 6e382c58f..8f5847383 100644
--- a/src/lib/ai-edition/store/editorSettings.test.ts
+++ b/src/lib/ai-edition/store/editorSettings.test.ts
@@ -5,6 +5,7 @@ import {
DEFAULT_WEBCAM_LAYOUT_PRESET,
DEFAULT_WEBCAM_MASK_SHAPE,
} from "@/components/video-editor/types";
+import { DEFAULT_CURSOR_THEME_ID } from "@/lib/cursor/cursorThemes";
import type { AxcutDocument } from "../schema";
import { axcutSchemaVersion } from "../schema";
import { DEFAULT_EDITOR_SETTINGS, getEditorSettings, patchEditorSettings } from "./editorSettings";
@@ -99,6 +100,14 @@ describe("getEditorSettings", () => {
const off = patchEditorSettings(baseDoc, { depthOfField: false });
expect(getEditorSettings(off).depthOfField).toBe(false);
});
+
+ it("reads a cursor pack the app no longer ships as the default art", () => {
+ const doc: AxcutDocument = {
+ ...baseDoc,
+ legacyEditor: { cursorTheme: "hello-kitty-watermelon" },
+ };
+ expect(getEditorSettings(doc).cursorTheme).toBe(DEFAULT_CURSOR_THEME_ID);
+ });
});
describe("patchEditorSettings", () => {
diff --git a/src/lib/ai-edition/store/editorSettings.ts b/src/lib/ai-edition/store/editorSettings.ts
index f9262855b..9a1b4038d 100644
--- a/src/lib/ai-edition/store/editorSettings.ts
+++ b/src/lib/ai-edition/store/editorSettings.ts
@@ -21,6 +21,7 @@ import {
type WebcamPosition,
type WebcamSizePreset,
} from "@/components/video-editor/types";
+import { normalizeCursorThemeId } from "@/lib/cursor/cursorThemes";
import {
DEFAULT_PROJECT_APPEARANCE,
type FrameTheme,
@@ -282,7 +283,10 @@ export function getEditorSettings(doc: AxcutDocument | null | undefined): Editor
cursor,
cursorShow: bool(legacy?.cursorShow, DEFAULT_EDITOR_SETTINGS.cursorShow),
cursorAutoHide: bool(legacy?.cursorAutoHide, DEFAULT_EDITOR_SETTINGS.cursorAutoHide),
- cursorTheme: str(legacy?.cursorTheme, DEFAULT_EDITOR_SETTINGS.cursorTheme),
+ // A pack the app no longer ships reads as the default art, which is what the renderer
+ // draws for it anyway. Left raw, the id would also switch off the modelled cursor: the
+ // compositor only builds it for the default theme.
+ cursorTheme: normalizeCursorThemeId(legacy?.cursorTheme),
autoFocusAll: bool(legacy?.autoFocusAll, DEFAULT_EDITOR_SETTINGS.autoFocusAll),
};
}
diff --git a/src/lib/cursor/cursorThemes.test.ts b/src/lib/cursor/cursorThemes.test.ts
index 00d5933e3..7f5b4950d 100644
--- a/src/lib/cursor/cursorThemes.test.ts
+++ b/src/lib/cursor/cursorThemes.test.ts
@@ -1,21 +1,71 @@
import { describe, expect, it } from "vitest";
import {
- CURSOR_THEMES,
type CursorTheme,
DEFAULT_CURSOR_SPRITES,
+ DEFAULT_CURSOR_THEME_ID,
+ normalizeCursorThemeId,
themePickerPreviewAssets,
} from "./cursorThemes";
+/** The packs removed because sweezy-cursors.com's terms forbid redistributing them.
+ * Projects and presets saved with one of these ids still exist on disk. */
+const REMOVED_THEME_IDS = [
+ "among-us-sus-knife-and-red-animated",
+ "black-and-rainbow-stroke-gradient-animated",
+ "black-pixel",
+ "christmas-miles-morales",
+ "hello-kitty-watermelon",
+ "hollow-knight-and-game-arrow",
+ "hollow-knight-nail-sword-and-mask",
+ "mickey-mouse-black-hand-inflated-glove",
+ "naruto-akatsuki-cloud-arrow",
+ "old-roblox",
+ "pink-glossy-arrow-and-hand-3d",
+ "pinky-pixel",
+ "pokemon-neon-gengar",
+ "sanrio-gudetama-and-arrow-kawaii",
+ "sanrio-kuromi-skull-arrow",
+ "solo-leveling-sung-jinwoo-dark-flames",
+ "spring-gradient",
+];
+
+describe("normalizeCursorThemeId", () => {
+ it.each(REMOVED_THEME_IDS)("maps the removed pack %s back to the default art", (id) => {
+ expect(normalizeCursorThemeId(id)).toBe(DEFAULT_CURSOR_THEME_ID);
+ });
+
+ it("keeps the default, and reads anything that is not a string as the default", () => {
+ expect(normalizeCursorThemeId(DEFAULT_CURSOR_THEME_ID)).toBe(DEFAULT_CURSOR_THEME_ID);
+ expect(normalizeCursorThemeId(undefined)).toBe(DEFAULT_CURSOR_THEME_ID);
+ expect(normalizeCursorThemeId(42)).toBe(DEFAULT_CURSOR_THEME_ID);
+ });
+});
+
describe("themePickerPreviewAssets", () => {
- it("hello-kitty-watermelon exposes distinct arrow and pointer", () => {
- const theme = CURSOR_THEMES.find((t) => t.id === "hello-kitty-watermelon");
- if (!theme) {
- throw new Error("hello-kitty-watermelon theme is missing from CURSOR_THEMES");
- }
+ it("a pack with its own hand exposes distinct arrow and pointer", () => {
+ const theme: CursorTheme = {
+ id: "arrow-and-hand",
+ name: "Arrow and hand",
+ assets: {
+ arrow: {
+ assetPath: "cursors/fake/arrow.png",
+ width: 32,
+ height: 32,
+ hotspotX: 0,
+ hotspotY: 0,
+ },
+ pointer: {
+ assetPath: "cursors/fake/pointer.png",
+ width: 32,
+ height: 32,
+ hotspotX: 8,
+ hotspotY: 0,
+ },
+ },
+ };
const preview = themePickerPreviewAssets(theme);
- expect(preview.arrow.length).toBeGreaterThan(0);
- expect(preview.pointer).toBeTruthy();
- expect(preview.pointer).not.toBe(preview.arrow);
+ expect(preview.arrow).toBe("cursors/fake/arrow.png");
+ expect(preview.pointer).toBe("cursors/fake/pointer.png");
});
it("arrow-only theme has no pointer preview", () => {
diff --git a/src/lib/cursor/cursorThemes.ts b/src/lib/cursor/cursorThemes.ts
index c23d28686..1a0794715 100644
--- a/src/lib/cursor/cursorThemes.ts
+++ b/src/lib/cursor/cursorThemes.ts
@@ -9,7 +9,7 @@ import type { NativeCursorType } from "@/native/contracts";
* and is downscaled at draw time for crisper retina output.
*/
export interface CursorThemeAsset {
- /** Path relative to the public asset root, e.g. "cursors/hello-kitty-watermelon/arrow.png". */
+ /** Path relative to the public asset root, e.g. "cursors/<id>/arrow.png". */
assetPath: string;
width: number;
height: number;
@@ -24,8 +24,8 @@ export interface CursorTheme {
/** Attribution / origin for the artwork. */
source?: string;
/**
- * Per-cursor-type overrides. Missing types fall back to the built-in default art.
- * Sweezy packs only ship "arrow" and "pointer".
+ * Per-cursor-type overrides. Missing types fall back to the built-in default art,
+ * so a pack that only ships "arrow" and "pointer" is complete.
*/
assets: Partial<Record<NativeCursorType, CursorThemeAsset>>;
}
@@ -86,373 +86,18 @@ export const DEFAULT_CURSOR_SPRITES: Record<NativeCursorType, CursorSprite> = {
};
/**
- * Bundled cursor themes. To add a pack: drop arrow.png/pointer.png into
- * public/cursors/<id>/ and add an entry here with hotspots normalized to the
- * 32-logical reference (divide a 128px-pack hotspot by 4). No renderer changes needed.
+ * Bundled cursor themes. Empty on purpose: every pack this list used to carry came from
+ * sweezy-cursors.com, whose terms allow personal, non-commercial use and forbid
+ * redistributing or repackaging the packs without written permission. Most of them also
+ * drew characters owned by third parties. A pack comes back only under a licence that
+ * allows redistribution inside an MIT app, recorded in THIRD-PARTY-NOTICES.md.
+ *
+ * To add one: drop arrow.png/pointer.png into public/cursors/<id>/ and add an entry here
+ * with hotspots normalized to the 32-logical reference (divide a 128px-pack hotspot by 4).
+ * No renderer changes needed. An id that leaves this list reads back as the default art
+ * through `normalizeCursorThemeId`, so a project saved with it still opens.
*/
-export const CURSOR_THEMES: readonly CursorTheme[] = [
- {
- id: "hello-kitty-watermelon",
- name: "Hello Kitty & Watermelon",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/hello-kitty-watermelon/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/hello-kitty-watermelon/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 4,
- hotspotY: 2,
- },
- },
- },
- {
- id: "among-us-sus-knife-and-red-animated",
- name: "Among Us Sus Knife & Red Animated",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/among-us-sus-knife-and-red-animated/arrow.png",
- width: 32,
- height: 32,
- // Measured off the artwork, not copied from the packs that draw their arrow
- // into the image's corner: this blade starts 18px in and 13px down in the
- // 128px source, so the (1.6, 0.96) it used to carry sat in empty space
- // diagonally up-left of the point — a visible miss at any decent cursor size.
- hotspotX: 4.9,
- hotspotY: 3.25,
- },
- pointer: {
- assetPath: "cursors/among-us-sus-knife-and-red-animated/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 12,
- hotspotY: 2,
- },
- },
- },
- {
- id: "black-and-rainbow-stroke-gradient-animated",
- name: "Black & Rainbow Stroke Gradient Animated",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/black-and-rainbow-stroke-gradient-animated/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1.6,
- hotspotY: 0.96,
- },
- pointer: {
- assetPath: "cursors/black-and-rainbow-stroke-gradient-animated/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 8,
- hotspotY: 1.5,
- },
- },
- },
- {
- id: "black-pixel",
- name: "Black Pixel",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/black-pixel/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 2,
- hotspotY: 3.5,
- },
- pointer: {
- assetPath: "cursors/black-pixel/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 8,
- hotspotY: 1.5,
- },
- },
- },
- {
- id: "christmas-miles-morales",
- name: "Christmas Miles Morales",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/christmas-miles-morales/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/christmas-miles-morales/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 5.5,
- hotspotY: 3,
- },
- },
- },
- {
- id: "hollow-knight-and-game-arrow",
- name: "Hollow Knight & Game Arrow",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/hollow-knight-and-game-arrow/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 0.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/hollow-knight-and-game-arrow/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 5,
- hotspotY: 0.5,
- },
- },
- },
- {
- id: "hollow-knight-nail-sword-and-mask",
- name: "Hollow Knight Nail Sword & Mask",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/hollow-knight-nail-sword-and-mask/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 0.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/hollow-knight-nail-sword-and-mask/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 3.5,
- hotspotY: 2,
- },
- },
- },
- {
- id: "naruto-akatsuki-cloud-arrow",
- name: "Naruto Akatsuki Cloud Arrow",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/naruto-akatsuki-cloud-arrow/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 0.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/naruto-akatsuki-cloud-arrow/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 1,
- hotspotY: 1,
- },
- },
- },
- {
- id: "old-roblox",
- name: "Old Roblox",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/old-roblox/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 2.5,
- hotspotY: 1.5,
- },
- pointer: {
- assetPath: "cursors/old-roblox/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 3.5,
- hotspotY: 1.5,
- },
- },
- },
- {
- id: "pink-glossy-arrow-and-hand-3d",
- name: "Pink Glossy Arrow & Hand 3D",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/pink-glossy-arrow-and-hand-3d/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1.5,
- hotspotY: 1.5,
- },
- pointer: {
- assetPath: "cursors/pink-glossy-arrow-and-hand-3d/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 3,
- hotspotY: 1,
- },
- },
- },
- {
- id: "pinky-pixel",
- name: "Pinky Pixel",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/pinky-pixel/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 0.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/pinky-pixel/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 7,
- hotspotY: 1,
- },
- },
- },
- {
- id: "pokemon-neon-gengar",
- name: "Pokemon Neon Gengar",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/pokemon-neon-gengar/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/pokemon-neon-gengar/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 2,
- hotspotY: 2.5,
- },
- },
- },
- {
- id: "sanrio-gudetama-and-arrow-kawaii",
- name: "Sanrio Gudetama & Arrow Kawaii",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/sanrio-gudetama-and-arrow-kawaii/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 0.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/sanrio-gudetama-and-arrow-kawaii/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 8,
- hotspotY: 4,
- },
- },
- },
- {
- id: "spring-gradient",
- name: "Spring Gradient",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/spring-gradient/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/spring-gradient/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 8,
- hotspotY: 0.5,
- },
- },
- },
- {
- id: "mickey-mouse-black-hand-inflated-glove",
- name: "Mickey Mouse Black Hand Inflated Glove",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/mickey-mouse-black-hand-inflated-glove/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 2.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/mickey-mouse-black-hand-inflated-glove/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 10,
- hotspotY: 0.5,
- },
- },
- },
- {
- id: "sanrio-kuromi-skull-arrow",
- name: "Sanrio Kuromi Skull Arrow",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/sanrio-kuromi-skull-arrow/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 1.5,
- hotspotY: 0.5,
- },
- pointer: {
- assetPath: "cursors/sanrio-kuromi-skull-arrow/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 9.5,
- hotspotY: 1,
- },
- },
- },
- {
- id: "solo-leveling-sung-jinwoo-dark-flames",
- name: "Solo Leveling Sung Jinwoo Dark Flames",
- source: "sweezy-cursors.com",
- assets: {
- arrow: {
- assetPath: "cursors/solo-leveling-sung-jinwoo-dark-flames/arrow.png",
- width: 32,
- height: 32,
- hotspotX: 2,
- hotspotY: 1,
- },
- pointer: {
- assetPath: "cursors/solo-leveling-sung-jinwoo-dark-flames/pointer.png",
- width: 32,
- height: 32,
- hotspotX: 7,
- hotspotY: 4.5,
- },
- },
- },
-];
+export const CURSOR_THEMES: readonly CursorTheme[] = [];
/** All selectable theme ids, including the built-in default. */
export const CURSOR_THEME_IDS: ReadonlySet<string> = new Set([
@@ -462,8 +107,7 @@ export const CURSOR_THEME_IDS: ReadonlySet<string> = new Set([
/**
* Paths the theme picker should show. `pointer` is set only when that artwork
- * differs from `arrow`, so a pack like Hello Kitty / Watermelon is not previewed
- * as arrow-only.
+ * differs from `arrow`, so a pack with its own hand is not previewed as arrow-only.
*/
export function themePickerPreviewAssets(theme: CursorTheme | null): {
arrow: string;
@@ -499,7 +143,7 @@ export function normalizeCursorThemeId(id: unknown): string {
* The full sprite set for a theme: its own art where it has any, the built-in art for
* every other cursor state.
*
- * The packs only ship an arrow and a pointer, but a recording moves through a dozen OS
+ * A pack may ship only an arrow and a pointer, but a recording moves through a dozen OS
* states — text, resize, wait, grab. Serving the theme's arrow for all of them (what the
* native path used to do) shows a resize handle as an arrow; serving nothing shows a
* placeholder. Mixing in the built-in art per state keeps the pointer honest about what
diff --git a/src/native/sceneDescription.test.ts b/src/native/sceneDescription.test.ts
index 153a48947..4e496e2d2 100644
--- a/src/native/sceneDescription.test.ts
+++ b/src/native/sceneDescription.test.ts
@@ -18,6 +18,7 @@ import type {
AxcutZoomRegion,
} from "@/lib/ai-edition/schema";
import { axcutSchemaVersion } from "@/lib/ai-edition/schema";
+import { DEFAULT_CURSOR_THEME_ID } from "@/lib/cursor/cursorThemes";
import { DEVICE_FRAMES } from "@/lib/projectDefaults";
import { getFocusBoundsForScale } from "@/lib/zoomMath/focusUtils";
import { buildSceneDescription, wallpaperAcceptsMotion } from "./sceneDescription";
@@ -1148,7 +1149,9 @@ describe("buildSceneDescription.settings mapping", () => {
expect(scene.layout.webcamMirror).toBe(true);
expect(scene.cursor.show).toBe(false);
expect(scene.cursor.autoHide).toBe(true);
- expect(scene.cursor.theme).toBe("macos-dark");
+ // A theme the app does not ship reaches the compositor as the default, the only
+ // theme it builds the modelled cursor for.
+ expect(scene.cursor.theme).toBe(DEFAULT_CURSOR_THEME_ID);
});
it("populates layout.webcamRect with computeCompositeLayout's webcamRect, in fractions", () => {
diff --git a/technical-documentation/architecture/cursor.md b/technical-documentation/architecture/cursor.md
index d10bd9df0..b603f2610 100644
--- a/technical-documentation/architecture/cursor.md
+++ b/technical-documentation/architecture/cursor.md
@@ -32,13 +32,13 @@ Cursor telemetry also drives camera focus for auto-follow zooms. `src/lib/zoomMa
## Bundled assets
-The themed cursor packs are stored under `public/cursors/<id>/` and contain arrow and pointer PNGs registered in `src/lib/cursor/cursorThemes.ts`. The built-in native replacement SVG set is under `src/assets/cursors/`; `DEFAULT_CURSOR_SPRITES` in `src/lib/cursor/cursorThemes.ts` maps each captured cursor type to its rasterized asset and hotspot.
+No themed cursor pack ships today. The packs that used to sit under `public/cursors/<id>/` came from sweezy-cursors.com, whose terms forbid redistributing them, and were removed. A pack added later goes there as arrow and pointer PNGs registered in `CURSOR_THEMES` (`src/lib/cursor/cursorThemes.ts`), under a licence recorded in `THIRD-PARTY-NOTICES.md`; the editor only shows the theme picker once one exists. The built-in native replacement SVG set is under `src/assets/cursors/`; `DEFAULT_CURSOR_SPRITES` in `src/lib/cursor/cursorThemes.ts` maps each captured cursor type to its rasterized asset and hotspot.
The same built-in art also exists as PNGs under `public/cursors/default/`, generated from those SVGs by `scripts/generate-default-cursor-sprites.mjs`. The native compositor decodes png/jpeg from a real path and cannot read the SVGs, which exist only as bundler URLs in the renderer — so without the PNG set it had no default art and drew a placeholder dot-and-ring instead of a pointer. Regenerate rather than hand-editing: the script also emits the `DEFAULT_CURSOR_SPRITES` hotspot table, which would otherwise drift from the images.
## Sprite selection and the hotspot
-`resolveCursorSprites` (`cursorThemes.ts`) resolves one sprite per `NativeCursorType`: the selected theme's art where it has any, the built-in art everywhere else. The packs only ship an arrow and a pointer while a recording walks through a dozen OS states, so this fallback is what keeps a text caret from rendering as an arrow. `resolveSceneAssetPaths` (`compositorViewService.ts`) turns that table into absolute on-disk paths and puts it in the scene as `cursor.cursorSprites`; the compositor picks by the state in the track and falls back to the arrow.
+`resolveCursorSprites` (`cursorThemes.ts`) resolves one sprite per `NativeCursorType`: the selected theme's art where it has any, the built-in art everywhere else. A pack may ship only an arrow and a pointer while a recording walks through a dozen OS states, so this fallback is what keeps a text caret from rendering as an arrow. `resolveSceneAssetPaths` (`compositorViewService.ts`) turns that table into absolute on-disk paths and puts it in the scene as `cursor.cursorSprites`; the compositor picks by the state in the track and falls back to the arrow.
Each sprite carries its hotspot as a **fraction of its own image**, not in pixels. The compositor scales the sprite to the cursor-size setting, so a pixel offset would need rescaling at draw time; a fraction survives any scale. Both renderers anchor on it (`cursor_sprite_dst` in `compositor.rs`, and `renderAsset.hotspot* × scale` in the web paths) — drawing from the sprite's centre instead made an enlarged cursor point further and further from its target.
diff --git a/technical-documentation/testing/manual-e2e-checklist.md b/technical-documentation/testing/manual-e2e-checklist.md
index 9f5461637..dcf59cc31 100644
--- a/technical-documentation/testing/manual-e2e-checklist.md
+++ b/technical-documentation/testing/manual-e2e-checklist.md
@@ -431,7 +431,7 @@ The percentage is computed in the renderer against a predicted frame total, and
- [ ] Open the Layout facet and choose each available webcam layout; confirm the preview arrangement changes.
- [ ] Change webcam mirror, reactive zoom when supported, shape, and size; confirm each change is visible.
- [ ] Open the Cursor facet and toggle cursor visibility and clip-to-bounds; confirm the preview changes.
-- [ ] Change cursor theme, size, smoothing, motion blur, and click bounce; confirm each committed value remains visible.
+- [ ] Change cursor size, smoothing, motion blur, and click bounce; confirm each committed value remains visible.
- [ ] Toggle the theme control by its `aria-label` and confirm the editor switches between dark and light themes.
- [ ] Open the top-bar language control by its `aria-label`, choose a non-English locale, and confirm visible UI strings change.
- [ ] Switch back to English and confirm the top bar, transport, inspector, and export labels return to English.