English · 简体中文

IconLab

IconLab is a focused, native macOS app for composing, refining, previewing, and exporting application icons. Import transparent artwork, tune the icon plate and composition with direct manipulation, then export production-ready PNG and ICNS files.

Highlights

• Native SwiftUI interface designed for macOS
• Direct canvas dragging with live position feedback
• Trackpad pinch-to-scale and two-finger rotation
• Solid, transparent, linear, radial, and reflected backgrounds
• Three independent gradient color stops with live updates
• Optional center, rule-of-thirds, and golden-ratio composition guides
• Finder and Dock context previews in light and dark appearances
• Undo and redo from the toolbar or standard keyboard shortcuts
• English and Simplified Chinese interface languages
• System, light, and dark appearance modes
• High-quality 4× antialiased PNG and multi-resolution ICNS export

Requirements

• macOS 13 Ventura or later
• Apple silicon Mac for the prebuilt release
• Xcode Command Line Tools when building from source

Install

1. Download the latest archive from Releases.
2. Extract the archive and move IconLab.app to the Applications folder.
3. Open IconLab and import a PNG, JPEG, SVG, or PDF artwork file.

The downloadable build is ad-hoc signed and is not notarized. If macOS blocks the first launch, Control-click the app, choose Open, and confirm once.

Build from source

git clone https://github.com/yf-official/IconLab.git
cd IconLab
./build.sh

The application will be written to dist/IconLab.app.

Usage

1. Choose a solid, gradient, or transparent icon background.
2. Import artwork from the toolbar or drop it onto the canvas.
3. Drag, pinch, rotate, or use the inspector for precise adjustments.
4. Enable composition guides when aligning the artwork.
5. Review the Finder and Dock previews, then export PNG or ICNS.

Privacy

IconLab works locally. Imported artwork and exported icons remain on your Mac, and the app does not require a network connection.