IconState v0.1.2

Rearrange an iPhone home screen from a Mac. Plug the phone in over USB, drag icons and folders with a mouse, and write it back — after a backup and a diff you have to confirm.

Install it with one line. The build is unsigned, and recent macOS calls unsigned downloads damaged rather than asking, so the quarantine flag has to be cleared:

curl -fsSL https://raw.githubusercontent.com/Jubstaaa/iconstate/main/scripts/install.sh | bash

Needs macOS 12 or later, Apple silicon, and a USB cable.

New

• Install updates in the app, not in a browser tab

IconState v0.1.1

Rearrange an iPhone home screen from a Mac. Plug the phone in over USB, drag icons and folders with a mouse, and write it back — after a backup and a diff you have to confirm.

Install it with one line. The build is unsigned, and recent macOS calls unsigned downloads damaged rather than asking, so the quarantine flag has to be cleared:

curl -fsSL https://raw.githubusercontent.com/Jubstaaa/iconstate/main/scripts/install.sh | bash

Needs macOS 12 or later, Apple silicon, and a USB cable.

Fixed

• An empty Apple secret is not the same as no Apple secret
• Generate the release notes without git-cliff-action

New

• Install with one line, since the build cannot be signed
• Give the app an icon of its own

IconState v0.1.0

Rearrange an iPhone home screen from a Mac.

Install

curl -fsSL https://raw.githubusercontent.com/Jubstaaa/iconstate/main/scripts/install.sh | bash

That downloads this release, puts it in /Applications and opens it. Then plug an iPhone in over USB and tap Trust on the phone.

The script exists because of the last thing it does. This build is not signed with an Apple developer certificate — signing needs a paid Apple Developer membership — and recent macOS calls unsigned downloads damaged rather than asking, so the quarantine flag has to be cleared. The script is thirty lines and you can read it first. By hand: take the .dmg below, drag the app to /Applications, then run xattr -dr com.apple.quarantine /Applications/IconState.app.

What it does

Plug the phone in and the app draws the real home screen: the device's own icons, at the grid size SpringBoard reports. Drag icons and folders with a mouse, group them, rename, empty them out. Nothing reaches the phone until you open Review changes, see exactly what would move, and confirm — and the layout you had is backed up first, so Undo last write puts it back.

It can also sort for you. Apps land in folders by a rule table you build from your own home screen (Make this layout my rules), and anything the table has never seen is placed by its App Store category.

Needs macOS 12 or later, Apple silicon, and a USB cable. Nothing works over the network — the services this uses are not reachable that way.

What it will not do: widgets, removing an app from the home screen (iOS puts it back), placing icons freely with gaps, tinted or clear icon modes. Those are limits of what SpringBoard exposes, not choices — the README explains each one and what was tried.