Context
The bundled app ships with the generic macOS placeholder icon in the Dock, the app switcher and Finder. It is the first thing anyone sees, and it currently says the app is unfinished before it has done anything.
Resources/ contains exactly one file, ScanDeck-Info.plist- That plist has no
CFBundleIcon* key at all
grep -i icon Scripts/bundle-app.sh returns nothing
What to change
- Produce
Resources/ScanDeck.icns (or an .iconset plus an iconutil step in the build script). Every size macOS asks for, including 16 pt and 32 pt — an icon that only looks right at 512 px looks wrong everywhere a user actually sees it.
- Add
CFBundleIconFile (and CFBundleIconName if you ship an asset catalog) to Resources/ScanDeck-Info.plist.
- Copy it into the bundle in
Scripts/bundle-app.sh, next to where the Info.plist is placed.
Naming constraint, non-negotiable: "PaperStream" is PFU Limited's trademark and must never appear in a shipped product name, bundle identifier, asset name or marketing copy. ScanDeck is unaffiliated with PFU / Ricoh, so the icon must not echo their marks or the fi-8170's industrial design.
On subject matter: the app scans trading cards and publishes numbered front/back pairs. A card, a pair, or a deck all read at 16 px; a scanner does not.
How to verify
bash Scripts/bundle-app.sh --run # or --synthetic with no scanner
lsappinfo list | grep -A4 ScanDeck # expect type="Foreground"
swift test -c release
Check the Dock, ⌘-Tab, and Finder at every size. macOS caches icons aggressively — if the old one persists, touch the bundle or log out rather than assuming the copy step failed.
If you are proposing a design rather than a finished .icns, comment on this issue with the concept first. An icon is much easier to agree on before it has been drawn eight times.
See CONTRIBUTING.md. No scanner needed.
Context
The bundled app ships with the generic macOS placeholder icon in the Dock, the app switcher and Finder. It is the first thing anyone sees, and it currently says the app is unfinished before it has done anything.
Resources/contains exactly one file,ScanDeck-Info.plistCFBundleIcon*key at allgrep -i icon Scripts/bundle-app.shreturns nothingWhat to change
Resources/ScanDeck.icns(or an.iconsetplus aniconutilstep in the build script). Every size macOS asks for, including 16 pt and 32 pt — an icon that only looks right at 512 px looks wrong everywhere a user actually sees it.CFBundleIconFile(andCFBundleIconNameif you ship an asset catalog) toResources/ScanDeck-Info.plist.Scripts/bundle-app.sh, next to where the Info.plist is placed.Naming constraint, non-negotiable: "PaperStream" is PFU Limited's trademark and must never appear in a shipped product name, bundle identifier, asset name or marketing copy. ScanDeck is unaffiliated with PFU / Ricoh, so the icon must not echo their marks or the fi-8170's industrial design.
On subject matter: the app scans trading cards and publishes numbered front/back pairs. A card, a pair, or a deck all read at 16 px; a scanner does not.
How to verify
Check the Dock, ⌘-Tab, and Finder at every size. macOS caches icons aggressively — if the old one persists, touch the bundle or log out rather than assuming the copy step failed.
If you are proposing a design rather than a finished
.icns, comment on this issue with the concept first. An icon is much easier to agree on before it has been drawn eight times.See CONTRIBUTING.md. No scanner needed.