Sign in
CONTENTS_

Docs

Everything you need to ship icons fast.

[REF: DOC-MAIN]
/ QUICKSTART_

Quick start

SPECINE extracts every icon from a single image — sprite sheets, screenshots, asset boards — and lets you ship them at any scale or pixel size.

01
1. Drop an image

From the home page, drag any PNG, JPG, or WebP (≤ 10 MB) onto the dashed zone. No signup, no setup.

02
2. Review detections

SPECINE auto-detects icon-shaped regions and shows them as bounding boxes. Each box has a confidence score.

03
3. Edit if needed

Drag, resize, delete, or draw your own boxes. Rename them so the export filenames match your project.

04
4. Pick scales / pixel sizes

Choose preset bundles (iOS, Android, Favicon) or type custom values like 512 px or 0.5×.

05
5. Export ZIP

Click Export. A ZIP downloads instantly with every variant of every selected icon.

/ DROPDETECT_

Drop & detect

Detection runs automatically on upload. The pipeline distinguishes three image types:

  • Transparent sprite sheets (PNG with alpha) — uses the alpha channel to find icon shapes precisely.
  • Dark-background images — bright icons are isolated by simple thresholding.
  • Light-background images — dark icons are isolated by inverted thresholding.

Confidence scores reflect how square and how dense each detection is. Boxes with confidence < 45% appear in red — usually false positives. Boxes ≥ 70% appear in lime.

/ EDITOR_

Editor & tools

The editor uses Konva canvas with image-space coordinates — your edits are preserved at exact pixel precision regardless of zoom level.

Cursor mode (V)
Click to select. Shift+click to add, Cmd/Ctrl+click to toggle. Drag to move, corner anchors to resize.
Manual draw mode (R)
Click and drag to create new bounding boxes. The new box gets a 'manual' tag and 100% confidence.
Zoom & pan
Trackpad pinch / Ctrl+scroll to zoom. Two-finger swipe to pan, or hold Space + drag. Buttons in the toolbar for fit / 100% / +/−.
Renaming icons
Click any name in the right panel to edit. Custom names are sanitized for filesystem use (spaces → underscores). Duplicate names auto-suffix with _1, _2.
/ EXPORT_

Export settings

The export panel sits at the bottom-right of the editor. You can mix and match scales and pixel targets — every combination produces a separate file in the ZIP.

Format
PNG (lossless, alpha-preserving) is the default. WebP is smaller. SVG is coming in the Pro tier.
Scales (multiplicative)
@1x = source size. @2x = double. @0.5x = half. Custom values 0.1–16× supported.
Pixel targets (absolute)
Outputs a fixed N×N square canvas. Aspect ratio is preserved with transparent padding. Custom values 8–4096 px.
Preset bundles
iOS (@1x @2x @3x), Android (ldpi → xxxhdpi), Favicon (16, 32, 64, 180, 192, 512 px) all selectable in one click.
/ MODES_

Resample modes

Different icon styles need different upscaling algorithms. Choose the right mode in the Resample selector.

Smooth (Lanczos)
Default. Best for photo-style icons. Edges soften on big upscales (e.g. 64 → 512). Fast (~50 ms).
Pixel (Nearest)
Use for pixel art and retro game sprites. No interpolation — every block stays crisp. Looks blocky on smooth icons.
Sharp (Lanczos + Unsharp)
Lanczos with an edge-recovery pass. Best for flat / vector-style icons when AI is overkill. Fast.
AI ✦ (Real-ESRGAN)
Neural super-resolution trained on illustrations. Reconstructs detail at extreme upscales (8×, 13×) with results close to a vector render. Per-icon ~50–200 ms; first run downloads a small model.
/ BACKGROUND_

Background removal

Toggle 'Auto-remove background' in the export panel. Powered by rembg (u2netp model).

First export with this enabled may take 5–40 seconds while the 4 MB model downloads. Subsequent exports are < 1 second.

When to use it

Best for photo-like icons where the source has a colored or noisy background. Skip for sprite sheets that already have clean alpha — the result will be similar but slightly softer.

/ HOTKEYS_

Hotkeys

V
Cursor mode
R
Manual draw mode
Esc
Deselect all
Backspace / Delete
Delete selected box
Shift + Click
Shift+click — add to selection
Cmd / Ctrl + Click
Cmd/Ctrl+click — toggle in selection
Space + Drag
Hold Space + drag — pan canvas
Ctrl / Cmd + Scroll
Ctrl/Cmd + scroll — zoom around cursor
/ FAQ_

FAQ

Q1. Is my image uploaded to a server?

In local development mode (default), images stay on your machine — they're sent only to your local backend. In production deployments, uploads land in private cloud storage and are auto-deleted after 7 days.

Q2. Why are some boxes not detected?

Auto-detection looks for self-contained icon-shaped regions. Text fragments, gradients touching edges, or overlapping icons may be missed. Use Manual Draw (R) to fill in gaps.

Q3. Can I export to ICO?

Not yet. Use the Favicon preset to get the right pixel sizes as PNG, then merge with an external ICO bundler.

Q4. Does AI mode need a GPU?

No — Real-ESRGAN runs on CPU via NCNN/Vulkan. Fast on Apple Silicon and modern Intel/AMD.

Q5. How many icons can I export at once?

Up to 200 boxes per request. Multiply by your scales × formats for the total file count.