<div align="center"> <img src="./Github/icon.png" width="128" height="128" alt="IconChanger">

IconChanger

Customize any macOS app icon — with a beautiful GUI, powerful CLI, and automatic background restoration.

   

中文版  |  Version française

<br> <img src="./Github/Github-Iconchanger.jpeg" width="720" alt="IconChanger Preview"> <br>

📖 Read the Full Documentation →

Setup guides, CLI commands, API configuration, background service, import/export, and more.

</div>

---

Highlights

• 🎨 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

Quick Install

Homebrew

brew install Bengerthelorf/tap/iconchanger

Manual

Download the latest DMG from Releases, drag to Applications, and launch.

Need help? Check the Getting Started guide, or browse the full Documentation.

System Requirements

• macOS 13.0+
• Administrator privileges

Contributing

Fork → Clone → Open in Xcode 15+ → Start contributing! Report bugs via GitHub Issues.

Acknowledgements

• underthestars-zhy/IconChanger — Original project
• lcandy2 — Fork this project is based on
• macOSicons.com — Icon database
• fileicon — Icon manipulation tool
• Atom — Contributor

License

MIT License. See LICENSE for details.

---

<div align="center">

</div>