Skip to content

feat(ios): add initial iOS app and AVPlayer support - #2901

Open
blimjoe wants to merge 16 commits into
maxrave-dev:devfrom
blimjoe:ios-support
Open

blimjoe wants to merge 16 commits into
maxrave-dev:devfrom
blimjoe:ios-support

Conversation

@blimjoe

@blimjoe blimjoe commented Nov 16, 2026

Copy link
Copy Markdown

What & why

This adds an initial iOS port using the shared Compose UI and an AVPlayer backend. The app now builds and runs in the simulator and iPhone 17 iOS 27.3 Beta, loads the home screen and artwork, and plays online tracks.

The changes include:

  • An Xcode host app and opt-in Kotlin/Native targets (-PenableIos=true).
  • iOS startup, dependency injection, storage, and native file/photo pickers, sharing, clipboard, and WebKit login pages.
  • Mobile player layouts, video rendering with an artwork fallback, and saved language/region settings applied before the first home request.
  • Build instructions and a repeatable AVPlayer smoke test in docs/ios-port.md.

The core submodule currently points to my fork because it contains the iOS playback, streaming, and platform services this port needs. Those changes need to land in upstream core before the submodule URL can point back to maxrave-dev/core.

Testing

Validation completed on November 14:

  • Built and launched on iPhone 17 Pro and iPhone 16e simulators. Checked home browsing, artwork, Settings, and loading the Google login page.
  • Played an online YouTube track and checked that playback continued while backgrounded.
  • Passed all 13 AVPlayer smoke checks, 70 Compose JVM tests, and 17 simulator tests covering HMAC, TOTP, and scraper/locale behavior.
  • Passed data/Compose Android compilation and Native framework linking. Android/Desktop runtime regression testing is still pending.
  • Built and checked an unsigned arm64 Release IPA. It has not been installed or tested on a physical iPhone.

Remaining work

This is an initial port. Completed account sign-in, physical-device playback, AirPlay, lock-screen button interaction, and App Store distribution still need testing. Backup/restore, Photos permissions, and video rendering also need end-to-end checks. Downloads currently run in the foreground; Cast, library sync, song recognition, EQ/DSP, and crossfade are unavailable on iOS.

Linked issue

No accepted issue linked yet.

Checklist

  • This PR addresses an accepted issue (linked above)
  • I wrote or personally reviewed every line of this change
  • I tested it on Android and/or Desktop (say which, and how)

@github-actions

Copy link
Copy Markdown

Thanks for the PR! Please complete the pull request template — in particular the checkbox confirming you wrote or personally reviewed every line, and the issue this change addresses. It helps us tell real contributions from the flood of auto-generated ones. Edit your PR description; no need to open a new PR.

@github-actions github-actions Bot added the needs-template PR template incomplete — see the triage comment label Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

needs-template PR template incomplete — see the triage comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant