iconchanger v1.4.4-8
github↗
§ changelog

what changed.

every release published on github, mirrored here verbatim from the release notes. newest first.

What's Changed

  • release: v1.4.4-8
  • refactor: second-pass audit — threading, dead code, and code quality
  • fix: comprehensive code audit — threading, safety, and dead code cleanup
  • fix: restore VitePress base to /macIconChanger/ on main
  • fix: update documentation URLs to new domain app.snaix.homes
  • fix: update VitePress base path to match new deployment URL
  • refactor: clean up comments to only explain why
  • release: bump to 1.4.4-pre-8
  • fix: detect stale sudoers path by dry-running helper instead of sudo -n -l
  • release: bump to 1.4.4-pre-7
  • fix: restore error now shows specific app names and failure reasons
  • fix: settings restore now shows partial failures instead of false success
  • fix: detect app updates by bundle version instead of modDate
  • feat: restore result summary with skipped/failed counts
  • fix: restore cleanup ordering, progress accuracy, main thread safety
  • fix: PBKDF2 key derivation, wrong password error, restore skip reporting
  • release: bump to 1.4.4-pre-6
  • feat: floating restore progress with liquid glass on macOS 26
  • release: bump to 1.4.4-pre-5
  • feat: restore progress overlay, batch UI refresh
  • fix: refresh UI after config import
  • release: bump to 1.4.4-pre-4

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.4-pre-8...v1.4.4-8

What's Changed

  • release: merge TCC detection from beta, bump to 1.4.4-7
  • fix: CI inserts enclosure when missing from manual sparkle entries
  • feat: use TCC private API for App Management permission detection
  • ci: force checkout main when pushing appcast from non-main branches
  • feat: Sparkle pre-release channel with opt-in toggle
  • feat: add App Management (TCC) permission check to setup flow

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.4-6...v1.4.4-7

What's Changed

  • release: bump to 1.4.4-pre-7
  • fix: restore error now shows specific app names and failure reasons
  • fix: settings restore now shows partial failures instead of false success
  • fix: detect app updates by bundle version instead of modDate
  • feat: restore result summary with skipped/failed counts
  • fix: restore cleanup ordering, progress accuracy, main thread safety
  • fix: PBKDF2 key derivation, wrong password error, restore skip reporting

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.4-pre-6...v1.4.4-pre-7

What's Changed

  • release: bump version to 1.4.4 (build 2026031300)
  • refactor: clean up request headers and streamline API key resolution
  • fix: resolve timer race conditions and stabilize ForEach identity
  • chore: clean up .gitignore and remove incorrect xcodeproj exclusion
  • refactor: extract API key management and add copy version on tap
  • feat: optimize icon search with folder queries and Extended Search setting
  • ci: add Sparkle delta update generation to release workflow
  • docs: update SECURITY.md supported versions threshold to < 1.3
  • Merge pull request #29 from Sleywill/main
  • fix: add RTL spacing for navbar logo and title
  • docs: add display settings page, update setup/aliases/api-key/changing-icons for all 30 locales
  • docs: add SECURITY.md with vulnerability reporting policy
  • fix: use separate hero images for light/dark mode with transparent backgrounds
  • fix: constrain hero image width on mobile viewports

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.3...v1.4.4

What's Changed

  • release: v1.4.3
  • chore: clean up PR #28 comments and add legacy helper migration
  • fix: remove redundant helper integrity check in ensureSetupCompleted
  • chore: clean up stale references after helper path migration
  • Merge pull request #28 from Dave86510/security-hardening
  • Fix: sort primary app icon first in Local icon list
  • Fix: isolate deprecated CGWindowListCreateImage and Sendable conformance
  • Security: harden privileged helper infrastructure
  • feat: add adjustable wallpaper spread and blur settings
  • feat: Dock Preview wallpaper bleeds under sidebar with toggle setting

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.2-2...v1.4.3

v1.4.2-2 — Hotfix

Increases the Dock Preview wallpaper bleed area for a more visually immersive background effect.

Hotfix Changes

  • Larger Dock Preview bleed — Wallpaper bleed area increased from 50pt to 80pt and blur radius from 24 to 36, giving the Dock Preview a more expansive, polished background

v1.4.2-1 — Hotfix

Fixes raw JSON error messages being displayed to users in the icon search and API connection test views.

Hotfix Changes

  • 404 as empty results — When the API returns 404 (e.g. searching for "1Password for Safari"), the app now shows the normal "No Icons Found" view instead of a raw JSON error
  • Clean error messages — API errors now display the extracted message (e.g. "API call limit exceeded") instead of dumping the full JSON response body
  • Better connection test errors — The "Test API Connection" button now shows clear, specific messages for 429 (rate limit), 401/403 (auth), and 5xx (server) errors

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
  • 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
  • Fix raw JSON error messages in API error display (v1.4.2-1)
  • Fix 404 responses showing as errors instead of empty results (v1.4.2-1)
  • Increase Dock Preview wallpaper bleed area for better visual effect (v1.4.2-2)

Documentation

  • Add translations for 30 languages on the documentation site
  • Redesign READMEs as visual landing pages

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.1...v1.4.2-2

Install

Homebrew

brew install Bengerthelorf/tap/iconchanger

Manual — Download IconChanger.dmg below, open it, and drag to Applications.

Documentation — bengerthelorf.github.io/macIconChanger

v1.4.2-1 — Hotfix

Fixes raw JSON error messages being displayed to users in the icon search and API connection test views.

Hotfix Changes

  • 404 as empty results — When the API returns 404 (e.g. searching for "1Password for Safari"), the app now shows the normal "No Icons Found" view instead of a raw JSON error
  • Clean error messages — API errors now display the extracted message (e.g. "API call limit exceeded") instead of dumping the full JSON response body
  • Better connection test errors — The "Test API Connection" button now shows clear, specific messages for 429 (rate limit), 401/403 (auth), and 5xx (server) errors

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
  • 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
  • Fix raw JSON error messages in API error display (v1.4.2-1)
  • Fix 404 responses showing as errors instead of empty results (v1.4.2-1)

Documentation

  • Add translations for 30 languages on the documentation site
  • Redesign READMEs as visual landing pages

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.1...v1.4.2-1

Install

Homebrew

brew install Bengerthelorf/tap/iconchanger

Manual — Download IconChanger.dmg below, open it, and drag to Applications.

Documentation — bengerthelorf.github.io/macIconChanger

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: https://github.com/Bengerthelorf/macIconChanger/compare/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

What's Changed

  • release: bump version to 1.4.1
  • chore: clean up stale comments and remove unused wallpaperLayer method
  • chore: default Cache API Results to enabled
  • i18n: add translations for cache settings and dock glass intensity
  • feat: persistent API result caching with settings toggle
  • fix: refresh hasDuplicateName on apps change and clean up drag temp files
  • fix: eliminate race condition in RequestDeduplicator
  • perf: move JSON encoding and UserDefaults write outside lock
  • perf: cache hasDuplicateName instead of recomputing on every render
  • perf: use @StateObject instead of @ObservedObject for singletons
  • perf: add Equatable conformance to DockLayout for SwiftUI diffing
  • fix: use Slider's native label layout for glass intensity control
  • fix: glass intensity slider alignment and macOS 26 availability gate

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.4.0...v1.4.1

What's Changed

  • release: bump version to 1.4.0
  • chore: add localization key for Dock Glass Intensity
  • feat: Liquid Glass dock frame with adjustable intensity slider
  • feat: transparent toolbar and extended wallpaper bleed
  • feat: add wallpaper bleed effect to Dock Preview bar
  • fix: persistent DockPreviewBar and performance optimizations
  • fix: deploy sparkle.xml to GitHub Pages for Sparkle updates

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.3.5...v1.4.0

What's Changed

  • release: bump version to 1.3.5
  • fix: replace placeholder UUIDs in project.pbxproj with proper hex IDs
  • feat: add appearance mode switcher, avatar caching, and code quality fixes
  • refactor: performance optimizations, code cleanup, and custom icon badge
  • feat: add Dock filter with preview bar and refresh-dock command
  • feat: add squircle jail escape and shell completion scripts

Full Changelog: https://github.com/Bengerthelorf/macIconChanger/compare/v1.3.4...v1.3.5

  • New: One-click permission setup — no more manual sudoers editing
  • New: Restore default app icons (fully restores macOS 26 icon features)
  • Fix: Icons not loading when scrolling sidebar quickly
  • Fix: Shell injection prevention and security hardening
  • Fix: Thread safety and performance improvements
  • Perf: Replaced debug print() with os.Logger for better release performance