sindresorhus

sindresorhus / DSStore

Public

Parse and write macOS .DS_Store files from Swift

swiftpackageindex.comsindresorhusDSStoredocumentationdsstoredsstore macos parser swift swift-package swift-package-manager
32
0
100% credibility
Found Feb 25, 2026 at 17 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
Swift
AI Summary

A library for reading and editing macOS Finder's hidden folder customization files to create polished disk images.

How It Works

1
💡 Dream of a perfect Mac installer

You want your app's disk image to open with icons perfectly placed, a nice background, and the window just right.

2
🔍 Find the hidden settings trick

You discover the secret file that remembers how Finder arranges icons and folder looks.

3
📂 Open or start fresh

You grab an existing settings file or make a new one to play with the layout.

4
🎯 Arrange icons like a pro

Position your app icon, add folders, set the window frame, pick a background color – it looks amazing!

5
💾 Save to your folder

Drop the customized settings into your disk image folder so it remembers your design.

😍 Mount and admire

Pop open the installer disk – your icons shine in place, window perfect, ready to impress users!

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 17 to 32 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is DSStore?

DSStore is a Swift library for parsing and writing macOS .DS_Store files, the hidden metadata stores Finder uses for icon positions, view styles, and window settings. It lets you read existing ds_store files, tweak them like a ds_store cleaner, or build new ones from scratch—ideal for crafting custom DMG layouts without manual Finder fiddling. Zero dependencies, fully documented, and thread-safe for Swift concurrency.

Why is it gaining traction?

Unlike brittle scripts or ds_store gitignore hacks, it offers type-safe conveniences like setIconPosition or setWindowBounds, plus support for Spotlight comments and backgrounds—saving hours on ds_store datei öffnen workflows. On ds_store github, it stands out for pure Swift parsing/writing akin to csv parse write to file tools, but tailored for macOS metadata. Developers grab it for quick DMG polish without reverse-engineering the proprietary format.

Who should use this?

Swift packagers building polished DMGs with precise icon layouts and Finder views. Mac app distributors needing ds_store file control for branded installers. Tool authors creating ds_store reviews or cleaners to inspect/modify folder metadata programmatically.

Verdict

Grab it for DMG layout needs—solid API and tests make it reliable despite 15 stars and 1.0% credibility score. Early maturity, but sindresorhus quality shines; pair with ds_store gitignore for clean repos. (187 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.