ArtMin96/omarchy-ios-studio

Build iPhone apps on Omarchy Linux and run them on your own iPhone, without a Mac.
iOS Studio is a desktop app for Omarchy. It installs the iOS toolchain, signs you in to your Apple ID, pairs your iPhone and builds your apps. After the install command below, you can do everything from the app window. It uses your Omarchy theme and font and changes with them.
## What it does
| Page | What you do there |
| Home | See your next step, what's ready, your iPhone, how many days until apps need re-signing, your apps with Run, and recent builds and crashes. |
| Setup | Install Swift, xtool, the iOS SDK and the iPhone tools with one button. |
| Apple ID | Sign in and see your team, certificates, profiles and the free-account limits. |
| iPhone | Pair your phone and work with it: see the list below. |
| Projects | Create an app from a template, build it, run it on your iPhone and re-sign it. New apps come with AGENTS.md and CLAUDE.md, so coding agents build through iOS Studio instead of looking for Xcode. A failed build lists each problem with its file and line, or with a hint when the problem is outside your code. Watch mode (in the Run button's menu) compiles on every save, so errors show up in Problems a few seconds after you stop typing (optionally running the app after each clean build); the card and the sidebar show how the last compile went. Each project card warns about settings mistakes before you build: misspelled xtool.yml keys, a missing camera or location permission text in Info.plist, a bad icon, entitlements a free Apple ID can't use. Format project (in the card's ⋮ menu) shows swift-format's changes as a diff before writing them, using the project's .swift-format, and Lint project puts style warnings from swift-format (and SwiftLint, if installed) in Problems with their file and line, apart from the build's own problems and hideable. Debug in editor attaches VS Code's or Zed's debugger to the app on your iPhone: press F5 in the editor, and breakpoints stop the app with its stack and variables. Set icon… makes the app icon from any picture: it shows how it looks on the Home Screen, then saves a 1024×1024 PNG without transparency and sets iconPath in xtool.yml. Packages… lists a project's Swift packages and adds one by its Git URL (fetched and linked to the app, then a compile-only Check build), updates them or removes one after showing the change to Package.swift. Run presets save launch arguments, environment variables and an app language per project, so Run can open the app in German or with a debug flag; the Run button's menu picks one. Projects that build through their own scripts get build settings: a prebuild command, environment variables, an open-file limit and permission to build a generated xtool.yml. |
| Logs | Read your iPhone's live log, see what your app prints (print()), open crash reports with the file and line your app crashed on, and look back at build logs. |
| Toolchain | Check versions and disk usage, free space, repair or remove everything. |
| Settings | Project folders, your editor and Swift completion for it (Zed, Neovim with LazyVim, VS Code: set up in one click), notifications, automatic re-signing, AI agents (and whether new apps get agent instructions), a launcher shortcut, tiled or floating, opaque window. |