IconTiller Quick Start
Requirements
- Windows and Python 3.12 with Tkinter for running from source.
- Apple's mobile device software/drivers for phone access.
- A USB data cable and one connected iPhone, unlocked and trusted.
You can try Demo without a phone. Python 3.14 is not the supported project environment. Compatibility testing is limited to one phone reporting iOS 27.0.
Run from source
Download or clone the public repository. Open PowerShell in its extracted or cloned project folder:
py -3.12 -m venv .venv312
.\.venv312\Scripts\python.exe -m pip install -r requirements-lock.txt
.\launch.cmd
Setup downloads dependencies from PyPI. The running application uses local files and the USB device connection.
Portable Windows package
You can build a Windows x64 package from the repository using build.ps1.
See the repository build instructions.
If you have a portable package, extract the entire folder and run
IconTiller.exe. Keep it with its _internal folder, README.txt, and
LICENSE.txt. Python is bundled; Apple device drivers are still required.
This is an unsigned development preview, not a signed installer.
The repository is the source entry point. This guide does not assume a published binary release is available. Packaged smoke checks do not establish live USB compatibility on your computer.
Your first session
- Launch IconTiller and choose Demo to explore sample data.
- When ready, connect one iPhone by USB, unlock it, and accept its Trust prompt.
- Choose Read iPhone and wait for the layout and artwork to load.
- Make a supported edit and use Save draft if you want a local copy.
- Follow Editing and Apply to review and confirm it.
Edits stay local until you confirm Apply to iPhone. Keep the phone connected while reading or applying. For connection problems, see Tips and Troubleshooting.