Feature/ios now playing widget pr - #1744
Open
martin-77 wants to merge 6 commits into
Open
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Adds a native WidgetKit Now Playing widget for iOS.
The widget supports small, medium, and large sizes and mirrors Finamp's current playback state, artwork, metadata, favorite state, and optional star ratings.
Playback controls use App Intents and support:
On iOS 27 builds compiled with Swift 6.4 or newer, the widget also supports interactive metadata actions:
On older toolchains or older iOS versions, rating/favorite state remains read-only.
Related issues
Addresses #156.
This also covers the iOS widget request previously discussed in #579, which was closed as a duplicate of #156.
The implementation intentionally only addresses the iOS side of #156; Android widget support remains outside the scope of this PR.
Architecture
The widget does not connect to Jellyfin directly.
Finamp's main process publishes a sanitized state snapshot and downsampled artwork into an App Group container. The WidgetKit extension only reads that state.
Shared widget state contains:
No Jellyfin credentials or authentication tokens are shared with the widget extension.
Widget actions are routed back through the existing Finamp services instead of implementing a second playback or networking stack inside the extension.
Compatibility
FLUTTER_BUILD_NAMEandFLUTTER_BUILD_NUMBERVerified release bundle versions:
Runner: 0.9.25 (126)
Widget: 0.9.25 (126)
Dependency
This PR depends on #1736 for optional Jellyfin star ratings.
Until #1736 is merged, its rating-related changes may also appear in this PR's diff. They are not duplicated as part of the widget implementation and can be rebased away once #1736 lands.
Apple Developer configuration
The following App Group must be registered in the Apple Developer account and enabled for both the main app and widget extension:
group.com.unicornsonlsd.finamp-ios.widgetTesting
Tested with:
Build command:
flutter build ios --release --no-pub --no-codesignAI assistance
This implementation was created with assistance from AI. The code was manually reviewed, tested on device, and verified with both stable and beta Xcode toolchains.