Customize any macOS app icon — with a beautiful GUI, powerful CLI, and automatic background restoration.
Setup guides, CLI commands, API configuration, background service, import/export, and more.
- 🎨 Custom Icons — Change any app icon via GUI or CLI, with macOSicons.com integration
- 🖥️ Dock Preview — Live preview of your Dock with custom icons
- 📂 Folder Icons — Customize folder icons too
- 🔄 Background Service — Auto-restore icons on schedule or after app updates
- ⌨️ CLI Tool — Full-featured command-line interface for scripting and automation
- ⭐ Favorites & History — Save and revisit your icon choices
- 🌍 30 Languages — Localized worldwide
For a fork build, download a tested candidate from the Actions run artifacts or a published DMG from this fork's Releases. Drag IconChanger.app to Applications and launch. Ad-hoc signed builds are not notarized, so macOS may show a security warning.
Need help? Check this fork's Setup Guide, or browse the full Documentation.
- macOS 13.0+
- Administrator privileges are needed only for protected targets or operations requiring elevated access.
Fork → Clone → Open in Xcode 15+ → Start contributing! Report bugs via GitHub Issues.
- underthestars-zhy/IconChanger — Original project
- lcandy2 — Fork this project is based on
- macOSicons.com — Icon database
- fileicon — Icon manipulation tool
- Atom — Contributor
MIT License. See LICENSE for details.