feat(emby): add Emby as a MediaBrowser backend alongside Jellyfin
Emby is Jellyfin's upstream ancestor and speaks a near-identical MediaBrowser
API, so the existing Jellyfin stack is parameterised by a `MediaBrowserDialect`
rather than forked. `JellyfinClient`, its auth service, endpoint discovery, LAN
discovery, and the add/edit connection screens all take the dialect and keep one
implementation; `MediaBackend.emby` and `ConnectionKind.emby` carry it through
the neutral models, the Drift `kind` discriminator, downloads, and caches.
Every divergence below was measured against a live Emby 4.9.5 server, not
inferred from documentation, and each is documented at its capability getter.
Jellyfin's request strings stay byte-identical so nothing about its behaviour
changes.
Routes and auth
- Emby only accepts the pre-10.9 user-scoped item routes (`/Users/{id}/Items/…`,
`/Users/{id}/PlayedItems/…`, `/Users/{id}/FavoriteItems/…`); the unprefixed
forms Jellyfin 10.11 added return 404.
- The API is also served under a legacy `/emby` prefix, and both dialects accept
the token as `X-Emby-Token` or `api_key=`.
- Emby answers only its own LAN discovery datagram ("who is EmbyServer?") and
ignores Jellyfin's; its default HTTPS port is 8920.
- No `/QuickConnect` route exists, so Quick Connect stays Jellyfin-only.
Row fields Emby withholds
- `ProductionYear`, `OfficialRating`, `PremiereDate` and `DateCreated` are absent
from list rows unless named in `Fields`, which would otherwise strip the year
and age-rating badge from every card in the app.
- `UserData.LastPlayedDate` never appears on a list row under `Fields=UserData`,
`EnableUserData=true` or the user-scoped `Ids=` form — only on the single-item
detail route, or when the Emby-specific `UserDataLastPlayedDate` token is
requested. Without it every recency-ordered surface silently degrades to
library-add time, and `JellyfinApiCache.applyWatchState` stamps
`DateTime.now()` on watched rows, so an offline watch-state pull would rewrite
the cached play time of everything it walked.
Continue Watching and Next Up
- Emby computes Next Up per series only: the library-wide `/Shows/NextUp` query
returns nothing under every parameter combination tried. The shelf is
therefore reconstructed from a played-episode recency scan plus one
`/Shows/NextUp?SeriesId=` per distinct series, bounded by a shared wall clock
that covers the scan as well — per-request timeouts cannot bound the pass
because `MediaServerHttpClient` times the connect and receive phases
independently. Rows are stamped with their series' newest play from the same
response that ordered them, so no per-series enrichment request is needed.
- `/Shows/NextUp` ignores `NextUpDateCutoff`, and no server-side played-date
filter exists to delegate to (`MinDatePlayed` and `MinDateLastPlayed` are
ignored; `MinDateLastSaved`, `MinDateCreated` and `MinPremiereDate` filter
unrelated dates), so the 365-day window is applied to the scanned dates.
- The resume route returns items with no saved position, including plain next
episodes, so the Emby resume leg reads from `/Items?Filters=IsResumable`.
- Emby is ahead of Jellyfin in one place: `/Users/{id}/Items/{id}/HideFromResume`
makes Continue Watching removal a real capability.
Everything else
- `/Sessions/Playing` and `/Sessions/Playing/Progress` reject a body with no
`PlaySessionId` (HTTP 400), so playback reporting always sends one.
- Passing any `MediaTypes` value to the playlist query returns an empty list.
- There is no aggregate `/Items/Filters` route; the four filter facets are
reassembled from `/Genres`, `/OfficialRatings`, `/Studios` and `/Tags`.
- Metadata writes take name-pair lists (`Genres: [{'Name': 'Action'}]`); the
plain string array is accepted and then silently discarded.
- Custom artwork uploads must be base64 text, not raw bytes — which was broken
for Jellyfin too and is fixed for both.
- Trickplay, media segments and lyrics 404 on Emby, so scrub previews are absent
and intro/credit markers fall back to chapter names.
Verified against a local Emby 4.9.5 and a Jellyfin 10.11.11 control server:
onboarding, browse, detail, playable stream URLs serving real bytes, subtitle
sidecars, watch-state write and restore, hubs, cross-server aggregation and
search across both backends simultaneously.
This commit is contained in:
edde746
@@ -115,7 +115,6 @@ class _Translations$auth$kk extends Translations$auth$en {
|
||||
@override String get waitingForAuth => 'Растау күтілуде...\nБраузеріңізден кіріңіз.';
|
||||
@override String get useBrowser => 'Браузерді пайдалану';
|
||||
@override String get or => 'немесе';
|
||||
@override String get connectToJellyfin => 'Jellyfin-ге қосылу';
|
||||
@override String get useQuickConnect => 'Жылдам қосылуды пайдалану';
|
||||
@override String get quickConnectInstructions => 'Jellyfin-де Жылдам қосылуды ашып, осы кодты енгізіңіз.';
|
||||
@override String get quickConnectWaiting => 'Растау күтілуде…';
|
||||
@@ -922,8 +921,6 @@ class _Translations$connections$kk extends Translations$connections$en {
|
||||
@override String sessionExpiredOne({required Object name}) => '${name} үшін сеанс мерзімі өтті';
|
||||
@override String sessionExpiredMany({required Object count}) => '${count} сервер үшін сеанс мерзімі өтті';
|
||||
@override String get signInAgain => 'Қайтадан кіру';
|
||||
@override String get editJellyfinTitle => 'Jellyfin қосылымын өңдеу';
|
||||
@override String editJellyfinIntro({required Object serverName}) => '${serverName} үшін URL мекенжайын қосыңыз немесе өшіріңіз.';
|
||||
}
|
||||
|
||||
// Path: discover
|
||||
@@ -1814,12 +1811,9 @@ class _Translations$addServer$kk extends Translations$addServer$en {
|
||||
final TranslationsKk _root; // ignore: unused_field
|
||||
|
||||
// Translations
|
||||
@override String get addJellyfinTitle => 'Jellyfin серверін қосу';
|
||||
@override String get serverUrls => 'Сервер URL-дері';
|
||||
@override String get serverUrlsHelper => 'Үтірмен бөлінген бірнеше URL мекенжайына рұқсат етіледі.';
|
||||
@override String get findServer => 'Серверді табу';
|
||||
@override String get searchingLocalServers => 'Жергілікті Jellyfin серверлері ізделуде...';
|
||||
@override String get localServers => 'Жергілікті Jellyfin серверлері';
|
||||
@override String get username => 'Пайдаланушы аты';
|
||||
@override String get password => 'Құпия сөз';
|
||||
@override String get signIn => 'Кіру';
|
||||
@@ -1831,15 +1825,11 @@ class _Translations$addServer$kk extends Translations$addServer$en {
|
||||
@override String get addPlexTitle => 'Plex арқылы кіру';
|
||||
@override String get pinExpired => 'PIN код мерзімі өтті.';
|
||||
@override String failedToRegisterAccount({required Object error}) => 'Тіркелгіні тіркеу қатесі: ${error}';
|
||||
@override String get enterJellyfinUrlError => 'Jellyfin сервер URL-ін енгізіңіз';
|
||||
@override String get addConnectionTitle => 'Қосылым қосу';
|
||||
@override String addConnectionTitleScoped({required Object name}) => '${name} профиліне қосу';
|
||||
@override String get signInWithPlexCard => 'Plex арқылы кіру';
|
||||
@override String get signInWithPlexCardSubtitle => 'Осы құрылғыны авторизациялау.';
|
||||
@override String get signInWithPlexCardSubtitleScoped => 'Plex тіркелгісін авторизациялау.';
|
||||
@override String get connectToJellyfinCard => 'Jellyfin-ге қосылу';
|
||||
@override String get connectToJellyfinCardSubtitle => 'Сервер URL-ін, пайдаланушы атын енгізіңіз.';
|
||||
@override String connectToJellyfinCardSubtitleScoped({required Object name}) => 'Jellyfin серверіне кіру. ${name} профиліне жалғануда.';
|
||||
@override String get borrowFromAnotherProfile => 'Басқа профильден алу';
|
||||
@override String get borrowFromAnotherProfileSubtitle => 'Басқа профильдің қосылымын қайта пайдалану.';
|
||||
}
|
||||
@@ -2219,7 +2209,6 @@ extension on TranslationsKk {
|
||||
'auth.waitingForAuth' => 'Растау күтілуде...\nБраузеріңізден кіріңіз.',
|
||||
'auth.useBrowser' => 'Браузерді пайдалану',
|
||||
'auth.or' => 'немесе',
|
||||
'auth.connectToJellyfin' => 'Jellyfin-ге қосылу',
|
||||
'auth.useQuickConnect' => 'Жылдам қосылуды пайдалану',
|
||||
'auth.quickConnectInstructions' => 'Jellyfin-де Жылдам қосылуды ашып, осы кодты енгізіңіз.',
|
||||
'auth.quickConnectWaiting' => 'Растау күтілуде…',
|
||||
@@ -2722,9 +2711,9 @@ extension on TranslationsKk {
|
||||
'videoControls.noChaptersAvailable' => 'Бөлімдер қолжетімсіз',
|
||||
'videoControls.queue' => 'Кезек',
|
||||
'videoControls.noQueueItems' => 'Кезекте элементтер жоқ',
|
||||
'videoControls.searchSubtitles' => 'Субтитр іздеу',
|
||||
_ => null,
|
||||
} ?? switch (path) {
|
||||
'videoControls.searchSubtitles' => 'Субтитр іздеу',
|
||||
'videoControls.language' => 'Тіл',
|
||||
'videoControls.noSubtitlesFound' => 'Субтитр табылмады',
|
||||
'videoControls.subtitleDownloaded' => 'Субтитр жүктелді',
|
||||
@@ -2884,8 +2873,6 @@ extension on TranslationsKk {
|
||||
'connections.sessionExpiredOne' => ({required Object name}) => '${name} үшін сеанс мерзімі өтті',
|
||||
'connections.sessionExpiredMany' => ({required Object count}) => '${count} сервер үшін сеанс мерзімі өтті',
|
||||
'connections.signInAgain' => 'Қайтадан кіру',
|
||||
'connections.editJellyfinTitle' => 'Jellyfin қосылымын өңдеу',
|
||||
'connections.editJellyfinIntro' => ({required Object serverName}) => '${serverName} үшін URL мекенжайын қосыңыз немесе өшіріңіз.',
|
||||
'discover.title' => 'Шолу',
|
||||
'discover.noContentAvailable' => 'Мазмұн қолжетімсіз',
|
||||
'discover.addMediaToLibraries' => 'Кітапханаларыңызға медиа қосыңыз',
|
||||
@@ -3236,11 +3223,11 @@ extension on TranslationsKk {
|
||||
'watchTogether.enterCodeHint' => '5 таңбалы кодты енгізіңіз',
|
||||
'watchTogether.pasteFromClipboard' => 'Алмасу буферінен қою',
|
||||
'watchTogether.pleaseEnterCode' => 'Сеанс кодын енгізіңіз',
|
||||
_ => null,
|
||||
} ?? switch (path) {
|
||||
'watchTogether.codeMustBe5Chars' => 'Сеанс коды 5 таңбадан тұруы керек',
|
||||
'watchTogether.joinInstructions' => 'Ұйымдастырушының сеанс кодын енгізіңіз.',
|
||||
'watchTogether.failedToCreate' => 'Сеансты жасау мүмкін болмады',
|
||||
_ => null,
|
||||
} ?? switch (path) {
|
||||
'watchTogether.failedToJoin' => 'Сеансқа қосылу мүмкін болмады',
|
||||
'watchTogether.sessionCodeCopied' => 'Сеанс коды көшірілді',
|
||||
'watchTogether.relayUnreachable' => 'Реле сервері қолжетімсіз.',
|
||||
@@ -3678,12 +3665,9 @@ extension on TranslationsKk {
|
||||
'services.libraryFilter.modeHintWhitelist' => 'Тек төменде таңдалған кітапханаларды синхрондау.',
|
||||
'services.libraryFilter.libraries' => 'Кітапханалар',
|
||||
'services.libraryFilter.noLibraries' => 'Кітапханалар жоқ',
|
||||
'addServer.addJellyfinTitle' => 'Jellyfin серверін қосу',
|
||||
'addServer.serverUrls' => 'Сервер URL-дері',
|
||||
'addServer.serverUrlsHelper' => 'Үтірмен бөлінген бірнеше URL мекенжайына рұқсат етіледі.',
|
||||
'addServer.findServer' => 'Серверді табу',
|
||||
'addServer.searchingLocalServers' => 'Жергілікті Jellyfin серверлері ізделуде...',
|
||||
'addServer.localServers' => 'Жергілікті Jellyfin серверлері',
|
||||
'addServer.username' => 'Пайдаланушы аты',
|
||||
'addServer.password' => 'Құпия сөз',
|
||||
'addServer.signIn' => 'Кіру',
|
||||
@@ -3695,15 +3679,11 @@ extension on TranslationsKk {
|
||||
'addServer.addPlexTitle' => 'Plex арқылы кіру',
|
||||
'addServer.pinExpired' => 'PIN код мерзімі өтті.',
|
||||
'addServer.failedToRegisterAccount' => ({required Object error}) => 'Тіркелгіні тіркеу қатесі: ${error}',
|
||||
'addServer.enterJellyfinUrlError' => 'Jellyfin сервер URL-ін енгізіңіз',
|
||||
'addServer.addConnectionTitle' => 'Қосылым қосу',
|
||||
'addServer.addConnectionTitleScoped' => ({required Object name}) => '${name} профиліне қосу',
|
||||
'addServer.signInWithPlexCard' => 'Plex арқылы кіру',
|
||||
'addServer.signInWithPlexCardSubtitle' => 'Осы құрылғыны авторизациялау.',
|
||||
'addServer.signInWithPlexCardSubtitleScoped' => 'Plex тіркелгісін авторизациялау.',
|
||||
'addServer.connectToJellyfinCard' => 'Jellyfin-ге қосылу',
|
||||
'addServer.connectToJellyfinCardSubtitle' => 'Сервер URL-ін, пайдаланушы атын енгізіңіз.',
|
||||
'addServer.connectToJellyfinCardSubtitleScoped' => ({required Object name}) => 'Jellyfin серверіне кіру. ${name} профиліне жалғануда.',
|
||||
'addServer.borrowFromAnotherProfile' => 'Басқа профильден алу',
|
||||
'addServer.borrowFromAnotherProfileSubtitle' => 'Басқа профильдің қосылымын қайта пайдалану.',
|
||||
_ => null,
|
||||
|
||||
Reference in New Issue
Block a user