Skip to content

Library

What the household owns and wants. Talks to the media server (Emby or Jellyfin), keeps Loomarr’s own record of every film and episode, looks titles up on TMDB, and asks Sonarr or Radarr to fetch a title the household does not have yet. The metadata providers decide which source’s facts about a file win.

One area of the package map.

Imports from other areas

  • platform · 19 imports — the store, settings and jobs behind the provision backstop, the outbound HTTP client and metrics every remote service call goes through, and the audience rating ladder the metadata providers fold certifications onto
  • media · 1 import — the scanner reads each media file’s header to learn its length, streams and embedded ids

Packages

  • library/arrhook · 2 importers · → platform/httpx Speaks Sonarr’s and Radarr’s webhooks (#2151 decisions 9 and 10): it reads the events they send, naming the folders each one touched, and registers Loomarr as one of their connections so they send them.
  • library/inventory · 9 importers Owns Loomarr’s durable, provider-neutral understanding of media (design §5, V66).
  • library/mediaserver · 15 importers · → platform/httpx, platform/metrics Library port (design §6, §2 boundaries): a shared Emby/Jellyfin adapter.
  • library/metadataprovider · 8 importers Contract every metadata provider implements: a system that already knows what a media file is and what to say about it, such as Sonarr and Radarr, a Kodi NFO beside the file, or a reference catalog like TMDB (#2151, decision 0046).
  • library/metadataprovider/arr · 1 importer · → library/metadataprovider Sonarr and Radarr as metadata providers (#2151 decisions 7, 15, 38).
  • library/metadataprovider/localart · 2 importers · → library/metadataprovider The artwork beside the media as a metadata provider (#2151 decision 19).
  • library/metadataprovider/nfo · 1 importer · → library/metadataprovider Kodi NFO sidecars as a metadata provider (#2151 decision 2).
  • library/metadataprovider/precedence · 2 importers · → library/metadataprovider, platform/rating Decides which source’s value Loomarr uses for each field of a media item (#2151 decision 7, ADR 0046).
  • library/metadataprovider/providertest · → library/metadataprovider Conformance suite every metadata provider runs.
  • library/metadataprovider/tmdb · 1 importer · → library/metadataprovider, library/tmdb, platform/httpx, platform/rating TMDB as a metadata provider (#2151 decisions 7, 13, 15, 18, 20, 21).
  • library/provision · 38 importers Provisioner domain (design §3–§4): the Title/Key identity model and the acquisition state machine.
  • library/provisionbackstop · 2 importers · → library/mediaserver, library/provision, library/requester, platform/activity, platform/jobs, platform/settings, platform/store, platform/store/activitystore Provisioning backstop (design §4, §7, §18).
  • library/requester · 3 importers · → library/provision, platform/httpx, platform/metrics Requester port (design §2, §6): it asks a downstream service to acquire a title.
  • library/resolvers · 1 importer · → library/mediaserver, library/provision, library/provisionbackstop, library/titlesearch, library/tmdb, platform/store/librarystore Answers the questions other areas ask about what the household owns, from the Library’s own records (#2151 step 16): which titles exist, a title’s library item id, its content rating, the collections it is in, and its TMDB franchise.
  • library/scan · 2 importers · → library/arrhook, library/inventory, library/mediaserver, library/metadataprovider, library/metadataprovider/localart, library/metadataprovider/precedence, library/tmdb, media/header, platform/store, platform/store/librarystore Finds and walks the folders Loomarr reads media from (#2151): it discovers scan roots from the media server and the arrs, maps each authority’s folder names onto local paths, and checks that Loomarr can open them.
  • library/titlesearch · 8 importers · → library/mediaserver, library/provision, platform/store/librarystore Catalog boundary (design §7.2, §8): federated search over the library + TMDB + the clip catalog, returning grounded Candidates with real external ids and an in_library flag.
  • library/tmdb · 9 importers · → library/provision, library/titlesearch, platform/httpx, platform/metrics TMDB adapter (design §8 grounding): the TMDB-scope corpus for the catalog and the exists-check for acquisition validation.