What's New in v1.4.2
Icon Favorites and History
You can now favorite icons and view your icon change history for each app. Right-click any icon to add it to favorites, and find your past icon choices in the History section at the bottom of each app's detail view.
Folder Icon Customization
A new Folders filter lets you add custom folders and change their icons, just like apps. Add folders via the sidebar, browse icons, drag-and-drop images, or restore defaults — all the same workflows you're used to.
API Rate Limiting and Error Handling
The macosicons.com API has a limited monthly quota, so this release adds built-in usage tracking and controls:
- Monthly query counter with configurable limit (default: 50) — visible in Settings > Advanced
- Configurable retry count (default: no retry) and request timeout (default: 15s)
- Distinct error messages for each failure mode (rate limit exceeded, timeout, HTTP errors, network errors) instead of the previous generic failures
Dock Preview Improvements
- Dock Preview is now hidden when viewing the Folders filter
- Customized / Not Customized filters now apply correctly to the Dock Preview bar
- Dock Preview icons now refresh consistently with the sidebar when changing display styles
Documentation Site
The documentation site has been expanded with 30 language translations and improved RTL support for Arabic.
For setup guides, CLI usage, API key configuration, and more, visit the full documentation.
All Changes
Features
- Add icon favorites and history (details)
- Add folder icon customization
- Add API rate limiting, retry logic, and distinct error messages
- Add Display settings tab and Dock Preview display mode
Fixes
- Fix Dock Preview filtering and icon refresh consistency
- Fix infinite spinner in Local icons section for folders
- Fix RTL layout for Arabic (hero text alignment, language selector dropdown)
- Fix esbuild vulnerability in docs dev server
Documentation
- Add translations for 30 languages on the documentation site
- Redesign READMEs as visual landing pages
Full Changelog: v1.4.1...v1.4.2
Install
Homebrew
brew install Bengerthelorf/tap/iconchanger
Manual — Download IconChanger.dmg below, open it, and drag to Applications.
Documentation — bengerthelorf.github.io/macIconChanger