Skip to content

Add custom app icons for iOS installs - #260

Merged
bitxeno merged 5 commits into
masterfrom
feat/custom-app-icon
Nov 10, 2026
Merged

bitxeno merged 5 commits into
masterfrom
feat/custom-app-icon

Conversation

@bitxeno

@bitxeno bitxeno commented Nov 10, 2026

Copy link
Copy Markdown
Owner

Why

Let users customize the icon of sideloaded iPhone and iPad apps, and keep that icon when apps are reinstalled or updated from a source. Apple TV does not support this option, so the picker is hidden for Apple TV devices.

Approach

Use PlumeImpactor's existing --custom-icon option. Validate uploaded PNG, JPEG, or GIF images, normalize them to PNG, and store the result with the installed-app record so future installs can reuse it.

How it works

  • Add an install-page icon picker beside the app name, with a preview and remove control.
  • Upload and validate icons through POST /api/custom-icon/upload.
  • Pass the stored image path to plumesign --custom-icon in both signing modes, including source updates and reinstalls.
  • Expose the option through the REST API and MCP install tool.
  • Show the picker only for iPhone/iPad devices; Apple TV submissions omit the custom icon.

Verification

  • CGO_ENABLED=0 go build ./...
  • CGO_ENABLED=0 go test ./...
  • golangci-lint run --timeout=5m
  • cd web/static && npm run build && npm test (84 tests passed)

Links

Add an optional custom app icon to the install page, the REST API, the
WebSocket install message and the MCP install_app tool. The image is
validated, normalized to PNG and stored with the installed app record, so
every refresh, reinstall and source update signs with the same icon, as
requested in #254. Both signing modes pass it to plumesign as
--custom-icon=<path>.

Refs #254
Drop the byte-identical ResolveStoredCustomIconPath helper and serve the
stored custom icon through the existing ResolveAppIconPath, so the
'inside <DataDir>/ipa' policy lives in one place. Also align the new
custom_icon locale block indentation with its siblings in en, ru and
zh_cn.

Refs #254
Move the custom app icon to the left of the app name field, matching the
reference layout: a large rounded swatch that opens the image picker when
clicked, with a plus placeholder when empty and a remove badge on its
top-right corner once an image is chosen. Drop the separate file input and
label, and trim the now-unused locale keys.

Refs #254
Replace the plus glyph in the empty custom icon swatch with the localized
"No icon" placeholder, matching the other empty states.

Refs #254
Custom app icons are only applied on iOS (iPhone/iPad) installs; Apple TV
ignores plumesign --custom-icon. Hide the picker on the install page for
other devices, and skip uploading, prefilling and submitting the icon so
an Apple TV install never carries one.

Refs #254
@bitxeno
bitxeno merged commit 3bb72b5 into master Nov 10, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[Feature] Custom App Icon Customization

1 participant

⌂ 换网址