Skip to content

DevX-Cipher/ImageToIcns

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

10 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Image to ICNS Converter

Platform: Windows Builds macOS Icons License: MIT (Non-Commercial) Build System: CMake

Convert PNG and JPEG images into macOS .icns icon files easily. Built on Windows, designed with cross-platform support in mind.


✨ Features

  • Converts PNG and JPEG images to ICNS format
  • Supports all macOS icon sizes (16x16 up to 1024x1024)
  • Preserves transparency (alpha channel)
  • Uses GDI+ on Windows for image decoding
  • Outputs debug-resized images for verification

πŸ› οΈ Usage

imagetoicns.exe input.png output.icns
imagetoicns.exe input.jpg output.icns

βš™οΈ Build Instructions

The project now uses CMake for build configuration.

Windows (Visual Studio):

cmake -S . -B build -G "Visual Studio 17 2022"
cmake --build build --config Release

Requires:

  • Visual Studio 2019 or later
  • GDI+ (included with Windows)

πŸ“ Debug Output

  • During processing, resized PNGs are saved to a debug_output/ folder for inspection.

πŸ”­ Future Plans

  • Cross-platform support (Linux/macOS builds)
  • Replace GDI+ with a cross-platform image library (e.g., libpng or stb_image)
  • Optional GUI frontend using Qt or ImGui

🀝 Contributing

Pull requests welcome! Especially if you're interested in:

  • Making the image loader cross-platform
  • Adding CI builds for Linux/macOS
  • Improving ICNS compatibility or compression

πŸ“„ License

MIT (Non-Commercial): Free for open source and personal use.

About

Simple Windows tool to convert images into macOS .icns icon files.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published