Skip to content

Edge

Where the outside world comes in. The api package is Loomarr’s HTTP surface, and app is the composition root that builds every other area and hands them to it. api/httpcore is the plumbing every part of the HTTP surface shares: problem responses, request ids, roles and the route-role marker. app/playoutresolve is the composition root’s playout wiring: it reads the stores and settings that playout must not know about.

One area of the package map.

Imports from other areas: any, by design — platform (95), filler (59), library (32), channels (25), proposals (19), media (18), playout (17), people (13)

Packages

  • api · 1 importer · → api/catalog, api/channels, api/filler, api/guide, api/httpcore, api/images, api/library, api/ops, api/people, api/playout, api/proposals, api/setup, api/system, channels/schedule, channels/viewing, filler/cliplibrary, filler/defectfloor, filler/records, filler/source, people/auth, platform/activity, platform/holidayvocab, platform/metrics, platform/settings, platform/storagegovernor, platform/store, platform/store/identitystore, platform/store/proposalstore, platform/web, playout, proposals, proposals/accept, proposals/suggest Wires Loomarr’s inbound HTTP surface (§7).
  • api/catalog · 2 importers · → api/httpcore, channels/schedule, library/provision, platform/settings, platform/store Serves the title catalog: the provisioning titles under /v1/titles and the federated catalog search under /v1/search.
  • api/channels · 3 importers · → api/httpcore, channels/edit, channels/ideas, channels/schedule, channels/viewing, filler/location, filler/pod, library/provision, media/images, platform/activity, platform/holidayvocab, platform/settings, platform/store, platform/store/channeldatastore, platform/store/channelstore, platform/store/identitystore, platform/store/proposalstore, proposals, proposals/suggest Serves the channel resource under /v1/channels: list, get, create, edit, refine, reconcile and delete, its icon, logo and watermark art, and the viewer-facing channel routes (Home’s channel ideas, favourite and recent channels, and household viewing).
  • api/filler · 2 importers · → api/httpcore, filler, filler/acquisition, filler/asset, filler/cliplibrary, filler/clips, filler/defectfloor, filler/enrichment, filler/language, filler/location, filler/operator, filler/pipelinestate, filler/pod, filler/records, filler/research, filler/source, filler/split, filler/station, filler/taxonomy, media/defects, platform/settings, platform/store, platform/store/clipstore Serves the filler routes under /v1/filler: the clip catalog and its edits, the Incoming queue, readiness and pool health, the pull approval queue, the header’s watch status, clip-detail research status and the defect floor report.
  • api/guide · 2 importers · → api/channels, api/httpcore, channels, channels/schedule, filler/cliplibrary, filler/pod, library/provision, media/images, platform/holidayvocab, platform/settings, platform/store, platform/store/channelstore, platform/store/clipstore, platform/store/librarystore, playout Serves what is on and what would be on: the time-grid guide and its highlights, each channel’s now, next, upcoming and timeline, the programming and cycle previews, the filler pod and coverage previews, the programming vocabulary and the holiday calendar.
  • api/httpcore · 14 importers · → channels/schedule, channels/viewing, filler/source, media/images, platform/rating, platform/settings, platform/store/channelstore, platform/store/identitystore, playout Plumbing every API area shares and none owns: RFC 7807 problem constructors and the transformer that stamps them with the request id, the request-id and security-header middleware, the caller’s role and the authorizer seam, the route-role marker every registration carries, the raw-operation helpers, the wire-JSON never-null format and the docs page.
  • api/images · 2 importers · → api/httpcore, media/images Serves the image service’s HTTP surface (§22): a rendition’s bytes, an image’s record and uploads.
  • api/library · 3 importers · → api/httpcore, channels/schedule, library/provision, library/scan, platform/settings, platform/store, platform/store/channelstore, platform/store/librarystore Serves the household’s media library: its scan roots and scanner status, the items, the titles that need a look and the fixes for them, the *arr webhooks, the household’s collections and ready-made sets, and the media server’s collections and TMDB movie collections.
  • api/ops · 2 importers · → api/httpcore, api/library, api/system, library/provision, platform/buildinfo, platform/diagnostics, platform/events, platform/metrics, platform/store, platform/store/activitystore, platform/store/channeldatastore, platform/store/identitystore, playout, proposals/quality Serves the operator and household status surfaces: liveness, readiness, Prometheus and the API reference; the server-sent event stream; diagnostics, startup reports and client crash reports; the live playout sessions and the activity and services panels; and the discovery feedback and quality ledgers.
  • api/people · 2 importers · → api/httpcore, people/access, people/auth, people/contact, people/notifications, platform/metrics, platform/settings, platform/store, platform/store/identitystore, proposals/accept Mounts the people routes of the HTTP API: sign-in and sessions, paired devices, the user directory, invitations and their redemption, password change and recovery, and single sign-on.
  • api/playout · 2 importers · → api/httpcore, channels/schedule, channels/viewing, media/encode, platform/settings, platform/store, platform/store/channelstore, platform/store/identitystore, playout, playout/subtitles Mounts the playout routes of the HTTP API: the streaming routes a channel is watched through (HLS, the MPEG-TS tuner stream, still frames), the signed playout URLs, the guide feed and the playout status projection.
  • api/proposals · 2 importers · → api/httpcore, channels/schedule, library/provision, platform/activity, platform/holidayvocab, platform/rating, platform/store, platform/store/activitystore, platform/store/proposalstore, proposals, proposals/accept, proposals/outlook, proposals/suggest, proposals/workflow Serves the channel-request routes under /v1/proposals (submit, list, approve, deny, outlook) and the First-channel Journey reads under /v1/proposal-jobs.
  • api/setup · 2 importers · → api/httpcore, people/notifications, platform/settings Serves the settings and the setup wizard: the settings list and edits, secrets, connection tests, the setup status checks and their repairs (Tunarr, the Live TV tuner, the *arrs the requester already knows), and the notification destinations.
  • api/system · 3 importers · → api/httpcore, platform/buildinfo, platform/databasemigration, platform/llm/picker, platform/store, playout Mounts the system routes of the HTTP API: the operator’s view of the running server (version and readiness, help, background jobs), its database and encryption, its backups and restart, and the language-model setup.
  • app · → api, api/catalog, api/channels, api/filler, api/guide, api/httpcore, api/images, api/library, api/ops, api/people, api/playout, api/proposals, api/setup, api/system, app/connectiontest, app/nownext, app/playoutresolve, channels, channels/approval, channels/edit, channels/growth, channels/ideas, channels/recurate, channels/schedule, channels/viewing, filler, filler/acquisition, filler/capability, filler/cliplibrary, filler/clips, filler/defectfloor, filler/enrichment, filler/fetch, filler/identity, filler/language, filler/operator, filler/pipelinestate, filler/pod, filler/quarantine, filler/records, filler/research, filler/routine, filler/screening, filler/source, filler/source/archive, filler/source/youtube, filler/split, filler/station, filler/storeadapter, filler/structure/cut, filler/structure/window, filler/structure/window/openrouter, filler/upkeep, library/arrhook, library/inventory, library/mediaserver, library/metadataprovider, library/metadataprovider/arr, library/metadataprovider/localart, library/metadataprovider/nfo, library/metadataprovider/precedence, library/metadataprovider/tmdb, library/provision, library/provisionbackstop, library/requester, library/resolvers, library/scan, library/titlesearch, library/tmdb, media/creative, media/defects, media/encode, media/header, media/images, media/images/rustgen, media/images/storeadapter, media/measure, media/tools, people/access, people/accountdelivery, people/auth, people/keyrotation, people/notifications, people/protectedsettings, people/secretprotection, platform/activity, platform/backup, platform/buildinfo, platform/config, platform/currenthealth, platform/databasemigration, platform/diagnostics, platform/events, platform/holidayvocab, platform/housekeeping, platform/httpx, platform/jobs, platform/llm, platform/llm/picker, platform/llm/selection, platform/metrics, platform/openroutermedia, platform/settings, platform/storagegovernor, platform/store, platform/store/channeldatastore, platform/store/channelstore, platform/store/clipstore, platform/store/librarystore, platform/store/proposalstore, playout, playout/backendtransition, playout/channelbug, playout/livetvpublish, playout/subtitles, playout/tunarr, proposals, proposals/accept, proposals/outlook, proposals/quality, proposals/suggest, proposals/webreference, proposals/workflow Composition root: it wires every subsystem from an open store into the API handler that cmd/loomarr serves and the integration tests drive.
  • app/connectiontest · 1 importer · → filler/cliplibrary, library/mediaserver, library/provision, library/requester, library/tmdb, platform/llm, platform/settings, playout/tunarr The named connection probes behind POST /v1/setup/test and the Health checks (config-design §8): media server, Tunarr, requester, Sonarr, Radarr, LLM, TMDB and the filler library folders.
  • app/nownext · 1 importer · → channels/schedule, library/provision, platform/store/channelstore, playout Answers the channel list’s “on now / up next” card and the “what’s on later” strip, routing each channel to the backend that actually streams it (§9.1).
  • app/playoutresolve · 1 importer · → channels/schedule, filler/asset, filler/cliplibrary, filler/pod, library/inventory, library/mediaserver, library/provision, library/tmdb, media/encode, media/images, media/measure, platform/diagnostics, platform/metrics, platform/store/channelstore, platform/store/librarystore, playout, playout/subtitles Adapter that makes internal playout work (§9.1): where three separately-verified pieces finally compose.