How to use Folder Icon Painter
Folder Icon Painter
Give many folders a tinted, badged or picture icon at once, preview every folder first, and put the old icons back from the restore log.
Bought Folder Icon Painter? Sign in with the email you bought it with to download the latest version or ask me a question.
On this page
Install
Folder Icon Painter requires macOS 14 Sonoma or later, on Apple silicon or Intel. Download the ZIP from the order page or your Creem receipt. Unzip it and move the app to Applications.
The app checks for updates once a day. When a new version is ready, click Install and Relaunch. To check anytime, choose Folder Icon Painter → Check for Updates….
Add the folders
Drop folders on the Folders list in the sidebar, or click Add… (also File › Add Folders…, Command-O). Each folder shows its current icon. Click the × next to a folder to take it off the list.
Choose which folders get the icon
The Which folders menu sets how deep the batch goes:
- Only the chosen folders (the default)
- Plus their subfolders
- Two levels
- Three levels
- Every subfolder, all the way down
With any of the subfolder options, two more settings show up. Skip folders named takes names separated by commas, and * and ? work as wildcards: Archive* skips Archive 2024 and Archive 2025. A skipped folder’s subfolders are skipped too. It starts with node_modules, .git, build, dist, DerivedData, Pods, vendor. Hidden folders are left out unless you tick Include hidden folders.
Design the icon
The Icon section shows a live preview with a description, like “Blue folder with the paintbrush.fill symbol”. Every folder in the batch gets this icon.
Tinted folder starts from the Mac’s own folder icon. Click one of the 12 colors, or use the color well for any other color. Then pick a Badge:
- None for a plain colored folder
- Symbol: type the name of an SF Symbol, like
book.fill, or click one of the 8 quick symbols under the field - Emoji: type one, or click Emoji… to open the Mac’s character viewer
- Text: up to 4 characters, like
ACMEor2026
The badge is drawn in a darker shade of the folder color, or a lighter one on very dark folders.
Picture uses an image as the whole icon. Drop it on the preview or choose it. PNG, JPEG, HEIC, TIFF, PDF and ICNS work. The picture is fitted into the icon, not stretched.
When the icon has a problem, like a symbol name that doesn’t exist, too many letters or an empty badge, the message shows in orange under the preview and Preview stays off until it’s fixed.
Saved styles
The Saved Styles menu applies a style you saved before. Save This Style… asks for a name, and each saved style can be deleted from the same menu. A picture style keeps its own copy of the image, so it keeps working if the original file moves.
Preview and paint
Click Preview (Command-R). The preview lists every folder in the batch with its current icon, an arrow and its new icon, indented by depth, and a pill:
- Paint: it gets the new icon
- Left out: you unticked it
- Skipped: the app won’t touch it, with the reason in a sentence
Folders that already have a custom icon get a Custom icon saved pill: the app saves that icon in the batch before painting. The pills at the top count the folders to paint, left out, skipped and with a custom icon saved. Untick any folder you want to keep as it is, or use Tick All and Untick All.
Click Paint N Folders (Return). The done screen lists the painted folders with their new icons. Folders that failed come first, in red, with the reason. Show in Finder opens them, Paint Another Batch goes back to the start, and Restore This Batch… opens the batch in the restore log.
![]()
Folders that are always skipped
- app bundles, packages and links to folders
/, the top of a disk, and system folders like/System,/Library,/Applications,/usr,/private,/opt,/varand/tmp~/Libraryand everything in it- your home folder and its Desktop, Documents, Downloads, Movies, Music, Pictures, Public, Applications and Sites folders
- folders owned by another user, and read-only folders
The preview stops at 3,000 folders and says so.
Painting keeps each folder’s Date Modified.
Restore the old icons
Every click on Paint creates a batch in the restore log. Open it with Restore Log at the bottom of the sidebar, or Command-L. The number next to it counts the batches that still have painted folders.
The batches are on the left, with the icon, the style, the date and how many folders were painted. Pick one, tick the folders to put back, and click Restore N Folders. Each folder gets back the icon it had before the batch: the standard folder icon, or the custom icon it had, exactly as it was. Restoring keeps Date Modified too.
The pills on each folder say where it stands: Painted, Restored, Had a custom icon, Changed since, Missing or Failed.
A folder whose icon changed after the batch, because a later batch painted it again or someone changed it by hand, is marked Changed since and left alone. That keeps an old restore from undoing a newer batch. Restore the newer batch first, or click Restore Anyway to put the old icon back regardless. A folder that was moved or renamed after painting is still found.
Disks and limits
Custom icons are stored with the folder on its disk. The app was tested on the Mac’s own disk. On some external drives, network shares and iCloud Drive folders, a custom icon may not stay: when that happens, the folder is listed in red on the done screen with the message that the icon didn’t stick.
Everything happens on your Mac. The app goes online only to check for and download updates. The restore log is kept in ~/Library/Application Support/Folder Icon Painter/.
Get help
Choose Help › Folder Icon Painter Support to open the support site in your browser.
Folder Icon Painter is $20, a one-time purchase.