Setpiece
Documentation

Install Setpiece

Setpiece is notarized by Apple — it installs like any other trusted Mac app. Pick a path below, then grant Accessibility permission.

01

Install

Two ways to install Setpiece — Homebrew or direct DMG.

A Recommended

Homebrew

  1. 1 Run: brew trust chifunghillmanchan/tap (Homebrew 7+ needs this once).
  2. 2 Run: brew install --cask chifunghillmanchan/tap/setpiece
  3. 3 Homebrew places Scene.app in /Applications.
  4. 4 Launch Setpiece from Launchpad or Applications.
  5. 5 Grant Accessibility permission on first launch (see next step).
B Alternative

Direct DMG

  1. 1 Download the latest Scene-X.Y.Z.dmg from the Releases page.
  2. 2 Double-click the DMG to mount it.
  3. 3 Drag Scene.app into /Applications.
  4. 4 Open Setpiece from Launchpad or Applications — no Gatekeeper prompt.
02

Grant Accessibility permission

Setpiece needs Accessibility access to move and read window frames. It does not log, transmit, or store this data.

  1. 1 Launch Setpiece — the menu bar icon appears.
  2. 2 Setpiece shows an onboarding screen. Click Open System Settings.
  3. 3 In Privacy & Security → Accessibility, toggle Setpiece on.
  4. 4 Return to Setpiece. Click I've granted access. Setpiece starts working.
03

Upgrading from v0.4.3 or earlier

Earlier releases were ad-hoc signed; v0.5.0+ is notarized with a Developer ID. macOS treats the new signature as a different app, so you need to re-authorize Accessibility once. Every update since keeps the grant automatically.

Quick fix

Quick fix: in Privacy & Security → Accessibility, toggle Setpiece off and on again.

Full reset

If that does not work, reset the grant with the command below, relaunch Setpiece, and re-authorize.

terminal 
tccutil reset Accessibility com.hillman.SceneApp
04

Uninstall

  1. 1 Quit Setpiece (menu bar icon → Quit).
  2. 2 Drag /Applications/Scene.app to Trash.
  3. 3 Optional — remove settings with the command below.
terminal 
rm -rf ~/Library/Application\ Support/Scene