feat(stremio): add Stremio addon support - #119
Open
bilipp wants to merge 5 commits into
Open
Conversation
bilipp
force-pushed
the
feat/stremio
branch
2 times, most recently
from
July 31, 2026 08:47
cf2d3b9 to
b753bc9
Compare
Tested against a real AIOStreams manifest, three gaps kept such addons from working: - Catalog paging trusted the protocol's 100-item page size and the manifest's skip declaration; AIOStreams serves 99-item pages with no extras declared (and Cinemeta 45-50 behind a redirect), so sync took one page and stopped. Paging now probes skip regardless and ends when a page yields no new ids. - Stream-focused addons serve no meta resource, so series never got episodes. Episode fetches now fall back to Cinemeta for IMDb ids, like the Stremio app. - Addons return dozens of streams per title (quality/size/provider); Lume silently played the first. VOD playback now shows an in-player source picker, auto-picking for single candidates, a matching bingeGroup (binge continuation on the same release), or when the new "Choose Stremio Stream" toggle is off. Live channels keep first-playable for fast zapping. - Stream-capable addons additionally get Cinemeta's Popular/Featured catalogs attached at sync, mirroring the app where pre-installed Cinemeta fills Discover - an AIOStreams playlist otherwise browses only its ~99-title service lists. Also: external-player handoff refuses lumestremio:// placeholders, stream behaviorHints (bingeGroup/filename/videoSize) decoded, audio session helpers split out to respect the file-length cap, and an os_log autoclosure self-capture build breaker fixed via a local copy (swiftformat keeps stripping explicit self). New strings localized in all 9 locales; 51 unit tests across six Stremio suites pass.
Close the gaps that kept popular addon categories from working: - proxyHeaders: streams carrying behaviorHints.proxyHeaders.request now flow those headers via PlayableMedia.httpHeaders into every engine (KSPlayer appendHeader, AVPlayer header-fields asset option, LumeEngine demuxer.httpHeaders, VLC best-effort UA/Referer) — unblocks MediaFusion's media proxy and header-guarded live-TV addons. - Non-standard catalog types (Anime Kitsu's "anime"): such catalogs are prefetched once and their items routed to the movie/series/live buckets by each item's own declared type. - Subtitle addons: Stremio VOD resolution fetches the subtitles resource from the owning addon, other subtitle-capable Stremio playlists and the OpenSubtitles v3 companion (pre-installed in the official app), and offers the tracks in the KSPlayer and VLC subtitle menus. - Cross-playlist aggregation, mirroring the app's installed-addon set: stream resolution falls back to other Stremio playlists that declare matching stream support (makes catalog-only addons like Kitsu, TMDB and Trakt lists playable), and the series-meta fallback asks Cinemeta then other meta-capable playlists. FullScreenPlayerView, ContentSyncManager+Stremio and VLCPlayerCoordinator were split to stay within the file-length cap.
Merging main brought the OpenSubtitles integration onto this branch, and both features had independently introduced an `ExternalSubtitle`: this branch's in `PlayableMedia.swift` (a remote track a Stremio subtitle addon offers, keyed by language) and OpenSubtitles' in `ExternalSubtitleLoading.swift` (a file downloaded from the search sheet, carrying its own label). They live in different files, so git merged both without a conflict — and left the module with an invalid redeclaration that would not compile. Collapse them into one value type next to `PlayableMedia`, holding the URL the engine reads from, the menu label, and an optional language used only to group same-language tracks. An `addonTrack(id:url:language:)` factory keeps the localized-language-name labelling the addon path had as a computed `displayName`, so addon menus read exactly as before. With one type, LumeEngine can finally offer addon subtitles too: its sidecar slot held a single track because only the OpenSubtitles pick ever reached it, so Stremio tracks appeared on KSPlayer and VLC but silently nowhere else. Widen it to a list — addon tracks are on offer from the first frame and parse only when picked, and a mid-playback search result joins them. Also settle the container-choice switch this branch had open: Stremio addons resolve a stream on demand at playback time, so like Stalker there is nothing for the viewer to pick. Verified: iOS and tvOS builds, SwiftFormat and SwiftLint (vendored 0.61.1 / 0.63.2), and 520 tests across every affected suite. The full-suite run also reports ~151 failures at 0.000s, all collateral from WatchProgressBufferTests trapping on an out-of-range index and killing its shared test process — a known pre-existing flake in files neither feature touches.
Owner
Author
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 Stremio addons as a first-class content source alongside Xtream, M3U and Stalker (#97). Users add any addon by its
manifest.jsonURL (orstremio://install link) through the existing Add Playlist flow; the addon's movie, series and TV catalogs surface through the same Home rails, browse views, search, favorites and enrichment as every other source, and streams play through the existing engine stack (KSPlayer → VLCKit → AVPlayer).Implementation
Follows the Stalker-portal pattern rather than a new
StremioAddonmodel:PlaylistSourceType.stremioon the existingPlaylist(manifest URL inserverURL), which gets iCloud config sync, deletion, browse scoping and auto-sync for free with no CloudKit schema change.StremioClient+ DTOs (Services/Network/): manifest / catalog / meta / stream / subtitles endpoints with retry+backoff; lenient decoding for real-world addon drift (string-or-numberimdbRating,title/nameandepisode/numberaliases, mixed string/objectresources), verified against the protocol docs and a live Cinemeta manifest.ContentSyncManager+Stremio: maps browsable catalogs (those without required extras like search-only) onto Category/Movie/Series/LiveStream with the standard playlist-UUID id prefixes; ids hashed viaM3UIdentity; pages catalogs viaskipcapped at 500 items each (Cinemeta's are endless); IMDb ids stored inimdbIdso OMDb/TMDB enrichment and Trakt keep working. Series episodes load lazily on the detail screen from the full meta (newSeries.stremioIdoptional field, lightweight migration).walkStremioCatalogprobesskipregardless and stops when a page yields no new ids (one extra request on skip-ignoring addons).cinemeta:-prefixed category apiIds), mirroring the Stremio app where pre-installed Cinemeta fills Discover. Without this, an AIOStreams playlist browses only its ~99-title JustWatch service lists. Gated onsupportsStreams(forType:idPrefix: "tt")so companion items are always playable; skipped when the playlist is Cinemeta itself; a companion failure never fails the sync.metaresource, so episode fetches fall back to Cinemeta for IMDb ids — series from such addons otherwise show no episodes.lumestremio://placeholder (mirroringlumestalker://); the newStremioStreamResolverresolves/stream/{type}/{id}.jsonat playback time — torrent (infoHash), YouTube and external-browser streams are filtered out. A smallDeferredStreamLinkfront door now dispatches Stalker/Stremio resolution in the player. External-player handoff refuses placeholders (they'd reach Infuse/VLC unresolved).name/description+behaviorHints), so VOD playback shows an in-player source picker (StremioStreamPickerView, platform-adaptive incl. tvOS focus). Auto-picks without asking when there is a single candidate, when the new "Choose Stremio Stream" toggle (Settings → Playback) is off, or when a candidate matches the session's last-pickedbingeGroup— so binge auto-advance stays on the chosen release. Live channels keep first-playable resolution for fast zapping.PlaylistDetailViewhandles the credential-less source. LoginView's per-source form sections moved toLoginView+Sections.swiftto stay within lint size caps.Not in scope (noted for follow-ups): subtitle-addon wiring into the player UI (client endpoint implemented), search-extra catalogs (online search), per-genre Discover browsing, cross-playlist stream aggregation,
behaviorHints.proxyHeaders, torrent streams, and remembering the picked stream across player sessions. Downloads are disabled for Stremio sources since stream URLs are resolved on demand.Testing
xcodebuild test -scheme Lume -destination 'platform=iOS Simulator,name=iPhone 17 Pro'— full LumeTests suite; single failure is the pre-existing RecommendationEngine parallel-run flake, unrelated)behaviorHints), catalog-paging termination, stream-support scoping, and picker auto-pick rulesPlatforms
Related
Closes #97