yorickr/plezy
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(emby): add Emby as a MediaBrowser backend alongside Jellyfin

Browse Source 
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
2026-08-05 06:09:26 +02:00
parent f36e20bcad
commit 05fd622968
128 changed files with 4917 additions and 1429 deletions
Download Patch File Download Diff File Expand all files Collapse all files
lib/i18n/strings_uz.g.dart
+3 -23
View File
@@ -115,7 +115,6 @@ class _Translations$auth$uz extends Translations$auth$en {
@override String get waitingForAuth => 'Tasdiqlanish kutilmoqda...\nBrauzeringizdan kiring.';
@override String get useBrowser => 'Brauzerdan foydalanish';
@override String get or => 'yoki';
@override String get connectToJellyfin => 'Jellyfin-ga ulanish';
@override String get useQuickConnect => 'Tezkor ulanishdan foydalanish';
@override String get quickConnectInstructions => 'Jellyfin-da Tezkor ulanishni oching va ushbu kodni kiriting.';
@override String get quickConnectWaiting => 'Tasdiq kutilmoqda…';
@@ -922,8 +921,6 @@ class _Translations$connections$uz extends Translations$connections$en {
@override String sessionExpiredOne({required Object name}) => '${name} uchun seans vaqti tugadi';
@override String sessionExpiredMany({required Object count}) => '${count} server uchun seans vaqti tugadi';
@override String get signInAgain => 'Qaytadan kirish';
@override String get editJellyfinTitle => 'Jellyfin ulanishini tahrirlash';
@override String editJellyfinIntro({required Object serverName}) => '${serverName} uchun URL manzilini qoʻshing yoki oʻchiring.';
}
// Path: discover
@@ -1814,12 +1811,9 @@ class _Translations$addServer$uz extends Translations$addServer$en {
final TranslationsUz _root; // ignore: unused_field
// Translations
@override String get addJellyfinTitle => 'Jellyfin serverini qoʻshish';
@override String get serverUrls => 'Server URL-lari';
@override String get serverUrlsHelper => 'Vergul bilan ajratilgan bir nechta URL manziliga ruxsat beriladi.';
@override String get findServer => 'Serverni topish';
@override String get searchingLocalServers => 'Mahalliy Jellyfin serverlari qidirilmoqda...';
@override String get localServers => 'Mahalliy Jellyfin serverlari';
@override String get username => 'Foydalanuvchi nomi';
@override String get password => 'Parol';
@override String get signIn => 'Kirish';
@@ -1831,15 +1825,11 @@ class _Translations$addServer$uz extends Translations$addServer$en {
@override String get addPlexTitle => 'Plex orqali kirish';
@override String get pinExpired => 'PIN kod vaqti tugadi.';
@override String failedToRegisterAccount({required Object error}) => 'Hisobni roʻyxatdan oʻtkazishda xatolik: ${error}';
@override String get enterJellyfinUrlError => 'Jellyfin server URL-ini kiriting';
@override String get addConnectionTitle => 'Ulanish qoʻshish';
@override String addConnectionTitleScoped({required Object name}) => '${name} profiliga qoʻshish';
@override String get signInWithPlexCard => 'Plex orqali kirish';
@override String get signInWithPlexCardSubtitle => 'Ushbu qurilmani avtorizatsiya qiling.';
@override String get signInWithPlexCardSubtitleScoped => 'Plex hisobini avtorizatsiya qiling.';
@override String get connectToJellyfinCard => 'Jellyfin-ga ulanish';
@override String get connectToJellyfinCardSubtitle => 'Server URL, foydalanuvchi nomi va parolingizni kiriting.';
@override String connectToJellyfinCardSubtitleScoped({required Object name}) => 'Jellyfin serveriga kiring. ${name} profiliga ulanmoqda.';
@override String get borrowFromAnotherProfile => 'Boshqa profildan olish';
@override String get borrowFromAnotherProfileSubtitle => 'Boshqa profilning ulanishidan qayta foydalaning.';
}
@@ -2219,7 +2209,6 @@ extension on TranslationsUz {
'auth.waitingForAuth' => 'Tasdiqlanish kutilmoqda...\nBrauzeringizdan kiring.',
'auth.useBrowser' => 'Brauzerdan foydalanish',
'auth.or' => 'yoki',
'auth.connectToJellyfin' => 'Jellyfin-ga ulanish',
'auth.useQuickConnect' => 'Tezkor ulanishdan foydalanish',
'auth.quickConnectInstructions' => 'Jellyfin-da Tezkor ulanishni oching va ushbu kodni kiriting.',
'auth.quickConnectWaiting' => 'Tasdiq kutilmoqda…',
@@ -2722,9 +2711,9 @@ extension on TranslationsUz {
'videoControls.noChaptersAvailable' => 'Boʻlimlar mavjud emas',
'videoControls.queue' => 'Navbat',
'videoControls.noQueueItems' => 'Navbatda elementlar yoʻq',
'videoControls.searchSubtitles' => 'Subtitr qidirish',
_ => null,
} ?? switch (path) {
'videoControls.searchSubtitles' => 'Subtitr qidirish',
'videoControls.language' => 'Til',
'videoControls.noSubtitlesFound' => 'Subtitr topilmadi',
'videoControls.subtitleDownloaded' => 'Subtitr yuklab olindi',
@@ -2884,8 +2873,6 @@ extension on TranslationsUz {
'connections.sessionExpiredOne' => ({required Object name}) => '${name} uchun seans vaqti tugadi',
'connections.sessionExpiredMany' => ({required Object count}) => '${count} server uchun seans vaqti tugadi',
'connections.signInAgain' => 'Qaytadan kirish',
'connections.editJellyfinTitle' => 'Jellyfin ulanishini tahrirlash',
'connections.editJellyfinIntro' => ({required Object serverName}) => '${serverName} uchun URL manzilini qoʻshing yoki oʻchiring.',
'discover.title' => 'Kashf qilish',
'discover.noContentAvailable' => 'Kontent mavjud emas',
'discover.addMediaToLibraries' => 'Kutubxonalaringizga media qoʻshing',
@@ -3236,11 +3223,11 @@ extension on TranslationsUz {
'watchTogether.enterCodeHint' => '5 xonali kodni kiriting',
'watchTogether.pasteFromClipboard' => 'Xotiradan joylash',
'watchTogether.pleaseEnterCode' => 'Seans kodini kiriting',
_ => null,
} ?? switch (path) {
'watchTogether.codeMustBe5Chars' => 'Seans kodi 5 ta belgidan iborat boʻlishi kerak',
'watchTogether.joinInstructions' => 'Tashkilotchining seans kodini kiriting.',
'watchTogether.failedToCreate' => 'Seansni yaratib boʻlmadi',
_ => null,
} ?? switch (path) {
'watchTogether.failedToJoin' => 'Seansga qoʻshilib boʻlmadi',
'watchTogether.sessionCodeCopied' => 'Seans kodi nusxalandi',
'watchTogether.relayUnreachable' => 'Rele serveriga ulanib boʻlmadi.',
@@ -3678,12 +3665,9 @@ extension on TranslationsUz {
'services.libraryFilter.modeHintWhitelist' => 'Faqat quyida tanlangan kutubxonalarni sinxronlash.',
'services.libraryFilter.libraries' => 'Kutubxonalar',
'services.libraryFilter.noLibraries' => 'Kutubxonalar yoʻq',
'addServer.addJellyfinTitle' => 'Jellyfin serverini qoʻshish',
'addServer.serverUrls' => 'Server URL-lari',
'addServer.serverUrlsHelper' => 'Vergul bilan ajratilgan bir nechta URL manziliga ruxsat beriladi.',
'addServer.findServer' => 'Serverni topish',
'addServer.searchingLocalServers' => 'Mahalliy Jellyfin serverlari qidirilmoqda...',
'addServer.localServers' => 'Mahalliy Jellyfin serverlari',
'addServer.username' => 'Foydalanuvchi nomi',
'addServer.password' => 'Parol',
'addServer.signIn' => 'Kirish',
@@ -3695,15 +3679,11 @@ extension on TranslationsUz {
'addServer.addPlexTitle' => 'Plex orqali kirish',
'addServer.pinExpired' => 'PIN kod vaqti tugadi.',
'addServer.failedToRegisterAccount' => ({required Object error}) => 'Hisobni roʻyxatdan oʻtkazishda xatolik: ${error}',
'addServer.enterJellyfinUrlError' => 'Jellyfin server URL-ini kiriting',
'addServer.addConnectionTitle' => 'Ulanish qoʻshish',
'addServer.addConnectionTitleScoped' => ({required Object name}) => '${name} profiliga qoʻshish',
'addServer.signInWithPlexCard' => 'Plex orqali kirish',
'addServer.signInWithPlexCardSubtitle' => 'Ushbu qurilmani avtorizatsiya qiling.',
'addServer.signInWithPlexCardSubtitleScoped' => 'Plex hisobini avtorizatsiya qiling.',
'addServer.connectToJellyfinCard' => 'Jellyfin-ga ulanish',
'addServer.connectToJellyfinCardSubtitle' => 'Server URL, foydalanuvchi nomi va parolingizni kiriting.',
'addServer.connectToJellyfinCardSubtitleScoped' => ({required Object name}) => 'Jellyfin serveriga kiring. ${name} profiliga ulanmoqda.',
'addServer.borrowFromAnotherProfile' => 'Boshqa profildan olish',
'addServer.borrowFromAnotherProfileSubtitle' => 'Boshqa profilning ulanishidan qayta foydalaning.',
_ => null,