SnipShelf 0.3.0

SnipShelf 0.3.0

SnipShelf 0.3.0 brings color palettes to your references, faster ways to collect
cutouts, and search, backup, and recovery for your library.

What's new

• Colors beside your images. Previews and pinned images show proportional
  color palettes. Click a swatch to copy its HEX, analyze the subject or the
  whole image, adjust the color limit and shade merging, and save your defaults.
• Capture without breaking your flow. Rectangle joins Lasso and Polygon,
  with customizable global shortcuts for each tool. Choose a destination group
  and use Keep & Continue to collect multiple cutouts from one frozen image.
• Touch up directly in Capture Preview. Restore and Erase brushes, zoom,
  pan, undo/redo, and Original/Cutout comparison share one resizable window.
  Background removal focuses on the selected area, and unfinished captures
  remain available when you switch apps or invoke Capture again.
• Find and recover your references. Search image and group names across the
  library. Recently Deleted keeps removed images until you restore or permanently
  delete them. Back up the library as a Finder package and restore it with a
  recoverable copy of the previous library.
• Arrange your workspace. Dedicated card handles support persistent shelf
  ordering and pulling out floating references. New reference windows appear
  beside the Shelf, and Close All controls are available in each window. Shelf
  resizing, docking, search, and compact preview controls adapt to available space.
• A clearer first look. The README now shows four HTML recreations of the
  interface, with a local interactive preview and a separate development guide.

Download and upgrade

SnipShelf-0.3.0-arm64.zip requires Apple Silicon and macOS 26 or newer.
Quit SnipShelf, unzip the download, replace SnipShelf.app in Applications, and
reopen it. Existing clips stay in local storage.

The library index upgrades to version 3 on the next edit. Version-1 and
version-2 libraries load directly, preserving the original PNGs. Older app
releases cannot read the upgraded index: copy
~/Library/Application Support/SnipShelf/ before upgrading if you may need to
return to an older release.

The app is ad-hoc signed and not notarized. If macOS blocks the first launch
and you trust the download, open it once, then use System Settings → Privacy &
Security → Open Anyway. See Apple's instructions.
Screen capture also requires screen-recording permission; image import and
Crop a Copy work without it.

Download both release assets into the same folder and verify the ZIP with:

shasum -a 256 -c SnipShelf-0.3.0-arm64.zip.sha256

Validation

GitHub Actions runs the full Swift test suite on macOS 26 before building this
release. Packaging checks version 0.3.0/build 4, arm64 architecture, the exact
bundle contents, common private build paths, and the extracted ad-hoc signature.
The ZIP and its verified SHA-256 are uploaded before the release is published.

Physical mouse/trackpad feel, the complete screen-recording permission flow,
and downloaded-app Gatekeeper handling still need manual verification. See the
usage guide and
validation notes.

SnipShelf 0.2.0

SnipShelf 0.2.0

SnipShelf 0.2.0 adds reference groups, independent floating image windows, and
more control over capture and organization.

What's new

• Groups and floating references. Organize related clips into groups, drag
  clips between them, and pull out a group or pin an individual image above your
  other apps. Each reference remembers its window position and size; pinned
  images also remember their own Checkerboard, Light, or Dark background.
• Pick up where you left off. The Shelf and each group remember selection
  and scroll position during the session, including after tucking and reopening
  the Shelf. Keyboard selection brings offscreen images into view.
• Undo your organization. Command–Z now restores moves, group creation and
  dissolution, image and group renaming, and deletions. Images captured or
  imported after the operation are preserved. Select an image and press Return
  to rename it, or use its context menu.
• More deliberate docking. Drag at least one third of the Shelf's width
  beyond either screen edge before the tuck preview appears. Release to tuck;
  move back inside the threshold to cancel.
• Better cutouts. Native subject masking removes backgrounds inside your
  selection. Restore and Erase brushes let you touch up the result, with zoom,
  pan, stroke undo/redo, and a guide showing removed pixels. Remove Background
  can be switched off to keep the original selection.
• Smoother drawing and clearer controls. Fluid lasso drawing adds adaptive
  steadiness and closing assistance. The Shelf, capture review, and image preview
  use refined native controls, clearer actions, accessible shortcut recording,
  and copy confirmation that follows the most recently copied image. Imported
  and dropped images retain their original names.

Download and install

SnipShelf-0.2.0-arm64.zip requires Apple Silicon and macOS 26 or newer.
Quit SnipShelf, unzip the download, replace SnipShelf.app in Applications, and
reopen it. Existing clips remain in local storage.

The app is ad-hoc signed and not notarized, with no developer certificate
or Team ID. If macOS blocks the first launch and you trust the download, use
System Settings → Privacy & Security → Open Anyway.
Apple's instructions explain this exception.
Screen capture also requires screen-recording permission; importing images and
Crop a Copy do not.

Groups use version 2 of the local shelf index. Existing version-1 shelves load
directly and upgrade on the next edit, without changing the original PNGs.
Older releases cannot read the upgraded index; back up the storage folder before
downgrading. Undo history and browsing position last for the app session.

Verify the download with its companion checksum file:

shasum -a 256 -c SnipShelf-0.2.0-arm64.zip.sha256

Validation

The 57-test suite covers capture review, mask touch-ups, storage and recovery,
group organization, native reference-window interactions, navigation memory,
docking thresholds, and interface rendering. The release ZIP is checked for
version 0.2.0/build 3, arm64 architecture, expected contents, common local build
paths, and a valid extracted ad-hoc signature.

Tests run on Apple Silicon with macOS 27. Physical mouse/trackpad feel, the full
screen-recording permission flow, macOS 26 runtime, and downloaded-app Gatekeeper
handling still need manual verification. Cached native renders do not reproduce
compositor-backed glass exactly. See the usage guide and
validation notes.

SnipShelf 0.1.1

SnipShelf 0.1.1

Capture confirmation now opens a small floating preview near the selection,
restoring the desktop instead of covering it with a full-screen review canvas.

• Keep Clip or Return saves the cutout once. Escape or closing the preview
  cancels without saving.
• Refine returns to the frozen image with the outline, zoom, pan, and toolbar
  position preserved. Undo restores the previous selection and its preview.
• Fixed capture-toolbar dragging by measuring the gesture in the stationary
  canvas coordinate space, preventing feedback from the moving toolbar.
• The same compact confirmation is used by screen capture and Crop a Copy.

Download and install

SnipShelf-0.1.1-arm64.zip requires Apple Silicon and macOS 26 or newer.
Quit SnipShelf, unzip the download, replace SnipShelf.app in Applications, and
reopen it. Clips remain in the app's local storage.

The app is ad-hoc signed and not notarized, with no developer certificate
or Team ID. If macOS blocks the first launch and you trust the download, use
System Settings → Privacy & Security → Open Anyway.
Apple's instructions explain the exception;
managed Macs may restrict it. Screen capture also requires screen-recording
permission in Privacy & Security.

Verify the download with its companion checksum file:

shasum -a 256 -c SnipShelf-0.1.1-arm64.zip.sha256

Validation and limits

All 34 tests passed, including the optional light/dark rendering check. Native
AppKit tests cover preview placement, editor visibility, refinement, undo,
exactly-once saving, and cancellation. The direct Computer Use plugin verified
toolbar displacement in Crop a Copy.

The full screen-capture flow remains unverified because macOS denied recording
access on the test build. macOS 26 runtime, downloaded-app Gatekeeper handling,
and trackpad feel still need manual verification; tests ran on macOS 27 with
Apple Silicon. See the usage guide and
validation notes.

SnipShelf 0.1.0

SnipShelf 0.1.0

The first release of SnipShelf: a native macOS shelf for transparent cutouts and
visual references, processed and stored entirely on your Mac.

• Capture part of the screen or import an image, then select with a freehand
  lasso or polygon. Compare the original and cutout, refine, undo, and keep it.
• Keep clips in a floating shelf that tucks against either screen edge.
  Preview, zoom, copy, drag, export, and delete multiple clips with undo.
• A new sticker app icon and matching monochrome menu-bar icon.
• No account, analytics, subscription, or third-party dependencies. MIT licensed.

Download and install

SnipShelf-0.1.0-arm64.zip requires Apple Silicon and macOS 26 or newer.
Unzip it, move SnipShelf.app to Applications, and open it. The app lives in the
menu bar. Start a screen capture with Command–Shift–2, then grant screen
recording permission when prompted. Image import needs no capture permission.

The app is ad-hoc signed and not notarized. Its signature contains no
developer certificate or Team ID. If macOS blocks the first launch and you trust
the download, use System Settings → Privacy & Security → Open Anyway.
Apple explains this exception; managed Macs
may restrict it. Building from source is also supported.

The companion .zip.sha256 file checks download integrity:

shasum -a 256 -c SnipShelf-0.1.0-arm64.zip.sha256

Known limits

This is an early release. Automated checks ran on Apple Silicon with macOS 27;
macOS 26 runtime, Intel hardware, the downloaded-app Gatekeeper flow, and the
complete screen-capture permission flow have not yet been verified. Trackpad
feel, multiple displays, and external drag/drop need broader manual testing.
Large image writes can briefly block the interface. Selection assistance is
conservative and does not perform automatic background removal.

See the usage guide and validation notes.