Repository navigation
macOS DMG: branded window background and icon layout - #297
Merged
Merged
Conversation
This was referenced Oct 8, 2026
XusBadia
force-pushed
the
dmg-background
branch
2 times, most recently
from
October 8, 2026 15:54
20e607e to
5ca32d5
Compare
The DMG opened as a plain Finder window. It now shows the app icon's figure on the LightCraft colour, with LightCraft.app and the Applications link side by side. Same approach as VectorCraft's (storytold/vectorcraft#493). - packaging/macos/dmg/: background.svg (source; text outlined, the figure an <image> of assets/app-icon), background.tiff (1x + 2x HiDPI, Deflate, sRGB) and dmg-layout.DS_Store (Finder view settings: window, icon size 128, positions, background). - generate.py writes the TIFF and the layout on any OS, byte-for-byte reproducible, with nothing from the machine that ran it (no paths, users, disk names or volume UUIDs). - package.sh copies them into the staging folder; the image is still built with hdiutil makehybrid. Nothing extra runs in the signing job. - The volume name drops the version: the layout finds the background through an alias that includes the volume name. The DMG file name keeps the version. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
XusBadia
force-pushed
the
dmg-background
branch
from
October 8, 2026 15:56
5ca32d5 to
e4ab842
Compare
Member
|
Merged in #350. Thank you, @XusBadia. Before merging, the binaries were checked without running anything:
The DMG volume is now named just "LightCraft", without a version; that seems intended. You're welcome to join us on Discord: https://discord.gg/artcraft Generated by Claude Code |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
The macOS DMG opened as a plain white Finder window. It now opens like this:
The icon's figure as a cover on the LightCraft colour field, LightCraft.app and the
Applicationslink side by side on Paper, and a small LightCraft-specific touch: the arrow and the mono line under the title come from the app's craft. Ink, Paper and the app colour only; Inter and JetBrains Mono.How
Same approach as VectorCraft's, which has landed (storytold/vectorcraft#493):
packaging/macos/dmg/background.svg: the source. Its text is outlined, so rendering it needs no fonts, and the figure is an<image>of the existing icon inassets/app-icon/.background.tiff: 1x 660×400 + 2x 1320×800 in one HiDPI TIFF (Deflate, sRGB; ~1 MB).dmg-layout.DS_Store: Finder's view settings (window 660×400 content, icon size 128, LightCraft.app at (326, 205), Applications at (574, 205), the background). It's named so it isn't mistaken for, or ignored like, a Finder-generated.DS_Store.generate.py: writes both from the SVG on any OS (pip install 'pillow>=12' ds_store==1.3.3 mac_alias==2.2.3, resvg on PATH). The output is byte-for-byte reproducible and carries nothing from the machine that ran it: no paths, users, disk names or volume UUIDs.package.shcopies the TIFF and the layout into the staging folder. The image is still built withhdiutil makehybrid, and nothing extra runs in the signing job.One behaviour change: the volume name drops the version
.DS_Storepoints at the background through an alias that includes the volume name. WithLightCraft <version>Finder kept the window and icon positions but lost the background (tested). So the mounted volume is now calledLightCraft; the DMG file name still carries the version.Tested
package.shsteps (staging folder,makehybrid, UDZO) around a stubLightCraft.appwith the real icon, mounted it and opened it in Finder on macOS: the screenshot above is that DMG.shellcheckclean;cargo xtask assetspasses where the repo has it;generate.pyreproduces the committed files byte for byte (6 runs).Across the suite
Matching PRs for every Crafting App, same layout, each with its own figure and colour:
🤖 Generated with Claude Code