Free and open-source iPhone home screen editor

Rearrange your iPhone
from your computer.

Drag your real icons in an editor that mirrors your phone, or tell your AI agent what you want. Windows, macOS and Linux, no Mac needed.

PowerShell

irm https://iconshuffle.app/install.ps1 | iex

Downloads the latest release from GitHub and installs it. Read the script

Or download: .exe· .dmg· .AppImage

Command line only: uv tool install git+https://github.com/YakupEmreYerli/IconShuffle

Try it here

Your home screen, on a bigger screen

This is a pretend phone. Drag the icons, sort them A to Z, then press Apply to see what happens before anything is written.

Drag with a mouse, hold and drag on touch, or focus an icon and press Space.

Changes

Nothing reaches the phone until you press Apply.

    Three ways to use it

    Drag, ask, or edit a file

    All three end in the same careful write.

    01 · Desktop app

    A mirror of your phone, with your real icons

    Plug in your iPhone and tap Trust. The app shows every page, folder, widget and the dock as they are on the phone.

    • Drag apps between pages, folders and the dock
    • Make folders, move pages, send apps to the App Library
    • Sort every page A to Z in one click
    • See every change listed before you press Apply
    The IconShuffle editor: a mirrored iPhone home screen, the App Library on the left and the change list on the right. Sort A-Z rearranges the icons and each move shows up in the list.

    02 · AI agent

    Say what you want

    Paste one line into Claude Code, Codex or Cursor and describe the layout. The agent reads your home screen, explains every change in plain words and writes nothing until you say yes.

    put my games on page 2 work apps in one folder sort everything A–Z group apps by color
    Read the agent guide

    03 · Terminal

    Your layout as a text file

    The command line tool reads your home screen into a plain TOML file. Edit it anywhere, check it, write it back.

    $ ios-homescreen pull# read the phone into layout.toml$ ios-homescreen sort# A–Z, or edit the file by hand$ ios-homescreen check# see what would change, offline$ ios-homescreen push# back up, write, verify
    See all commands

    Safety

    Every write is backed up and checked

    Your phone either ends up exactly as planned, or exactly as it was.

    1. BackupYour current layout is saved
    2. WriteThe new layout goes to the phone
    3. Read backThe phone is read again
    4. CompareMatches the plan? Done.

    Asks before it writes

    You see the full list of changes first. If the phone changed since it was read, the write is refused.

    Undo any time

    Every backup can be restored from the app, or with ios-homescreen restore latest.

    Stays on your computer

    No account, no telemetry. Your layout, icons and backups never leave your machine.

    Nothing on the phone

    No jailbreak, no Developer Mode, no app to install on the iPhone.

    Platforms

    Windows, macOS and Linux

    One app, the same editor everywhere. The Windows and macOS builds are new, so they carry a beta tag for now.

    Windows beta

    IconShuffle-windows-x64-setup.exe

    • Needs Apple Devices from the Microsoft Store for the USB driver. iTunes works too.
    • Not signed yet: SmartScreen may ask once. Choose More info, then Run anyway.
    Download for Windows

    macOS beta

    IconShuffle-macos-arm64.dmg

    • For Apple silicon Macs. Nothing else to install.
    • Not notarized yet: on first launch, choose Open Anyway in System Settings, Privacy & Security.
    Download for macOS

    Linux

    IconShuffle-linux-x86_64.AppImage

    • Needs usbmuxd, which most distributions package.
    • Where the tool is developed and tested. The command line version runs here too.
    Download for Linux

    USBPlug in, unlock, tap Trust once.

    Wi-FiOn iOS 17 and later, after one pairing over USB.

    Your iPhone as it isNo jailbreak and no Developer Mode.

    FAQ

    Questions, answered

    The longer answers are in the guides

    Is it free?

    Yes. IconShuffle is open source under the MIT license. There is no paid tier and no account.

    Do I need a Mac?

    No. IconShuffle runs on Windows, macOS and Linux. On Windows it uses Apple's USB driver from the free Apple Devices app (iTunes works too).

    Do I need to jailbreak my iPhone?

    No. No jailbreak, no Developer Mode, and nothing is installed on the phone.

    Is my data sent anywhere?

    No. IconShuffle talks to your phone and nothing else. Your layout, icons and backups stay on your computer. There is no account and no telemetry.

    One exception you choose yourself: if you use an AI agent, the agent's own service sees your app names. That is how it knows which apps are games or work apps.

    Which iPhones and iOS versions work?

    It is built and tested on current iOS (iOS 27 on an iPhone 15). USB works without extra setup; Wi-Fi needs iOS 17 or later. If a write does not come out as planned on your phone, the read-back check notices and puts your backup back. Please open an issue so it can be fixed.

    What if something goes wrong?

    Every write saves a backup first. After the write the phone is read again and compared; if it does not match, the backup goes back on by itself. You can also restore any earlier backup from the app, or run ios-homescreen restore latest.

    Can it add widgets?

    It can move and remove widgets, but new widgets are added on the phone. iOS also does not keep empty spaces between icons when a layout is written.

    Why does Windows or macOS warn me when I open it?

    The builds are not signed yet. On Windows, SmartScreen may ask once: choose More info, then Run anyway. On macOS, open System Settings, Privacy & Security, and choose Open Anyway.

    Is IconShuffle made by Apple?

    No. IconShuffle is an independent open-source project and is not affiliated with or endorsed by Apple. iPhone and iOS are trademarks of Apple Inc.

    Give your thumb a rest.

    Free, open source, and on your computer in a minute.