Converting external design assets (logos, sketches, photographs, vector drawings, or animations) into active cursor layers is one of the most powerful workflows in the editor. You can import any image and refine it using the canvas tools.

Supported File Formats

The editor includes lazy-loaded client-side decoding libraries to parse and import a wide range of web and system assets (up to 10 MB maximum per file):

  • Raster Images: Transparent PNGs, WebP, JPG, JPEG, and browser-standard ICO files.
  • Vector Graphics: SVGs (Scalable Vector Graphics), which scale cleanly to any resolution preset without edge blur prior to commit.
  • Animations: Animated GIFs and animated WebP containers.
  • Cursor Formats: Existing Windows static cursors (.cur) and animated cursors (.ani) to extract and edit pre-made designs.

Importing One Cursor File

Open one .cur or .ani file with Import files / ZIP / 7z in the Workspace panel, or drop it onto the editor. The review shows its supported sizes and frame count. Choose one of two destinations:

  • New cursor: Click Import to create an editable cursor with all supported sizes. The largest size opens first. There are no conversion checkboxes or image-number choices.
  • As a layer: Choose a Source size, such as 32×32 or 96×96, then click Import. Position or resize the artwork in the placement tool and click Commit to add it as a new layer. Animated artwork brings its frames onto the timeline.

Images with either dimension below 32 pixels are discarded. They are not enlarged or padded to 32×32. If no supported artwork remains in a frame, the file cannot be imported. A standalone cursor file has no Current cursor destination. Importing does not submit anything to the site.

For layer placement, Source size defaults to the size matching your canvas, or the largest available size when there is no match. For example, a cursor with sizes up to 96×96 opens with 96×96 selected on a 256×256 canvas. You can choose another supported size before importing; only that size is placed.

Importing Multiple Files or an Archive

Select up to 60 cursors from the review and click Import. Archive and multi-file imports keep their conversion choices, including permission to pad small artwork and choices between conflicting images. Selecting just one member of an archive does not switch to the standalone-file workflow. With one cursor selected in these sessions, Current cursor remains available: the note lists sizes that will be replaced, added, or kept. Replacing a size replaces all of its layers and frames.

ZIP and 7z packs may contain CUR, ANI and INF files in subfolders. Nested archives, unrelated images and installer programs are ignored; encrypted, split, malformed, or oversized archives are refused. Choose at most four archives and 50 MiB of source files per session. Each cursor is limited to 10 MiB. Additional decoded-pixel, extraction-work and draft-storage limits may require a smaller selection or pack.

Open an INF section in the review to choose an install variant or scheme and apply its cursor roles. Manual role choices take precedence. Ambiguous paths remain unresolved, and basename-only suggestions require explicit acceptance. INF files are read as text, never executed, and do not establish authorship or permission to publish.

Interactive Import Placement Controls

Import a single ordinary image such as PNG, SVG, GIF or WebP to open the existing Import Overlay. This overlay displays a floating crop box with a bottom action dock side-by-side with these controls:

Image import placement crop overlay controls
Fit to Canvas

Proportionally rescales the imported artwork so that it fills the maximum available drawing canvas width and height, centered.

Real Size (100%)

Restores the image frame to its true, unscaled pixel dimensions. Highly recommended when importing small sprites or pre-scaled pixel art to ensure exact pixel alignment.

Recenter Placement

Moves the crop placement frame back to the absolute center of your editor canvas, resetting any custom mouse drags or pans.

Commit Import

Finishes the positioning mode and commits the pixel crop onto your active drawing layer. Once committed, the pixels become part of your drawing canvas and can be painted on.

Cancel Import

Aborts the active import preview completely, closes the overlay, and returns your canvas and layers to their pre-import state without altering any existing work.

Resize Scaling Methods

Before clicking Commit, select a resize Method to govern how the canvas scales your image down to standard cursor sizes:

Smooth (Lanczos Resampling)

Uses high-quality mathematical interpolation to blend edges. Perfect for photographs, smooth gradients, detailed logo illustrations, and SVG icons to prevent jagged lines.

Crisp (Nearest-Neighbor)

Maintains razor-sharp edges without any pixel blending or color smoothing. Essential for importing custom pixel art, sprite sheets, and retro cursor designs, guaranteeing that pixel boundaries remain perfectly crisp.

Animated & Multi-Frame Imports

The editor supports multi-frame animated imports to build moving cursor files:

  • GIF & WebP Animation: Dropping an animated GIF or animated WebP onto the canvas automatically populates the bottom animation timeline, instantiating new frames and automatically reading the source file's frame delays in milliseconds.
  • CUR & ANI Extraction: Imported sizes keep per-frame hotspots and playback timing, up to 64 animation steps. One standalone file handles supported conversions automatically and discards artwork below 32×32; archive and multi-file sessions still ask about trimming, padding, missing-size repair, invalid hotspots and legacy inversion. Malformed files are rejected.

Import Mode Workspace Lock

While the import crop preview overlay is active, the editor pauses all drawing activities. You will not be able to draw, select, manage layers, add timeline frames, undo/redo, or export files. You must click either Commit or Cancel to release the workspace lock.

Post-Commit Workflow Check

To finish your custom design after committing the crop:

  • Pixel Touch-ups: Use the Picker to sample colors, and the Pencil and Eraser to touch up pixel edges.
  • Hotspot Registration: Dragged images default their hotspot click point to (0,0). Use the Set Hotspot tool (`my_location`) to assign the exact pixel that triggers operating system clicks.
  • Multi-Size Scaling: Scale the committed design across other resolution cards (e.g. 48px, 64px) to ensure your custom cursor remains sharp and compatible across all screens.