Unjiggle

Your iPhone home screen is a mess. You know it. You've given up fixing it. Unjiggle fixes it for you.

Unjiggle is an AI-powered CLI that reads your iPhone home screen, scores your organization, roasts your app collection, writes obituaries for your dead apps, and generates share cards you'll actually want to post.

Quick Start

pip install unjiggle

Connect your iPhone via USB, then:

unjiggle go

One command. It scans your phone, scores your organization, calculates your swipe tax, and generates a share card that auto-copies to your clipboard. Cmd+V to paste into iMessage, Twitter, or Instagram.

Share Cards

Every feature generates a 1080x1350 share card that copies to your clipboard automatically. No screenshots needed — just Cmd+V.

Features

Core (no API key needed)

Viral features (works without API key, better with one)

These generate share cards with or without an API key. With Claude or GPT, the roasts are funnier and more personal. Without, you get a solid rule-based analysis.

AI-powered (needs API key)

Safety

Safety update in 0.3.2

Earlier versions of safety-test sent the layout back to the iPhone despite saying the test changed nothing. Sending even an unchanged layout can make iOS add or move icons. The default test now only reads the phone and saves a backup.

• A write test requires --write-roundtrip and a separate yes/no confirmation that defaults to No. It is not needed before using Unjiggle.
• Preparing to apply changes no longer runs an extra test write.
• If the layout changes while a backup is being checked, Unjiggle stops and keeps the original backup. New verified backups do not overwrite files from the same second.
• Restore saves the phone's current layout first. If the phone does not match the requested backup afterward, the command reports failure and exits with an error. It does not retry or try another restore automatically.
• Restore refuses completely empty layouts and unsupported backup formats rather than sending them to the phone. Layouts containing only widgets are supported.

These changes do not establish a fix for icons returning on iOS 27, or a safe way to recover folders lost after resetting the Home Screen. If a test or restore has already changed your layout unexpectedly, stop further attempts and keep your backups. Backup files contain app and folder names; share them privately when seeking help.

Requirements

• macOS (USB communication with iPhone)
• iPhone connected via USB with "Trust This Computer" accepted
• Python 3.10+
• API key (optional): set ANTHROPIC_API_KEY or OPENAI_API_KEY for AI features. Core features and share cards work without one.

How It Works

Unjiggle uses pymobiledevice3 to communicate with your iPhone's SpringBoard services over USB. It reads the IconState (your home screen layout), enriches it with App Store metadata, and generates observations and layout suggestions.

On macOS 12-15, it can also read Screen Time data from knowledgeC.db for real app usage stats (last opened, daily opens). On newer macOS versions, it falls back to positional heuristics.

Share cards render to PNG via Chrome headless and auto-copy to your macOS clipboard.

Earlier device testing used an iPhone 16 Pro on iOS 26; it does not establish safety on other iOS versions. Applying or restoring a layout can add or move icons. A verified backup is not a guarantee that a restore will succeed, and an immediate match does not prove the layout will stay the same after a reboot.

GUI Coming Soon

A native Mac app with live preview, drag-and-drop editing, animated before/after transformations, and a slider to control aggressiveness is in development.

Sign up for early access: unjiggle.com

License

GPL-3.0 (matching pymobiledevice3)