macos-app-iconlisted

# macOS App Icon Generator ## Overview Build a macOS `.icns` app icon from one source image (SVG or PNG), and wire it into an app. A `.icns` file packs all ten required icon sizes (16px through 1024px, @1x and @2x) into the single artifact macOS expects in an app bundle. ## Prerequisites - macOS with `qlmanage`, `sips`, `iconutil`, and `file` — all ship with the OS, nothing to install. - A square source image: SVG, or PNG at least 1024x1024. ## Instructions Quick start — run the bundled script: ```bash scripts/make_icns.sh <input-image> <output.icns> ``` The script: 1. Validates required tools (`sips`, `iconutil`, `file`) and the input file. 2. If input is `.svg`, renders it to a 1024px PNG via `qlmanage`. 3. If input is `.png`, uses it directly (warns if smaller than 1024px or non-square). 4. Generates all required sizes into a temp `.iconset` folder. 5. Compiles the `.iconset` into `.icns` via `iconutil`. 6. Cleans up the temp folder and prints the final `file` output to confirm validity. Run it with no args (or `-h`) for usage help. ## Examples ```bash # SVG source, output next to it scripts/make_icns.sh AppIcon.svg AppIcon.icns # 1024px PNG source, output into a build directory scripts/make_icns.sh artwork_1024.png build/AppIcon.icns ``` ## Output A valid `.icns` file at the path you specified, confirmed by `file` reporting `Mac OS X icon`. Intermediate `.iconset` folders are cleaned up automatically. Wire the result into an app via the sections below. ##