Tranform public lists into feeds to be consumed by other apps
Files
README.md

Feedarr #

Monorepo for Feedarr.

Structure #

  • feedarr-api/ — Kotlin + Micronaut API server (Gradle, Kotest)
  • webapp/ — web app (Bun + Vite + Svelte 5 + TypeScript)

feedarr-api #

cd feedarr-api
./gradlew run     # start the dev server
./gradlew test   # run tests

Feeds #

The API turns any public Refract list into Radarr/Sonarr "Custom Lists" import list feeds. The list is chosen per request with the slug query parameter (the slug is the part after /list/ in a Refract list URL), so no configuration or rebuild is needed to use a different list:

  • GET /feeds/radarr/movies?slug={refract-list-slug} → [{"id": ...}]
  • GET /feeds/sonarr/tv?slug={refract-list-slug} → [{"title": ..., "tvdbId": ..., "tmdbId": ...}] (tvdbId is resolved via Sonarr's SkyHook service and cached; stable Sonarr versions cannot resolve tmdbId themselves)
  • Append /_items to either path for a debug view of all items incl. skipped ones
  • GET /health → micronaut-management health endpoint with a feedarr indicator (cache snapshot, last upstream outcomes — never calls Refract), plus the k8s probes GET /health/liveness and GET /health/readiness

Responses are cached per slug (application.cache-ttl, default 30m; stale payloads are served if Refract is unreachable). The API is fully non-blocking, written with Kotlin coroutines (suspend) end to end — client, service, and controllers. Configure application.refract-base-url and application.cache-ttl in application.yaml. See ROADMAP.md for details.

Docker #

The image is published as joaomiguelcorreia/feedarr:latest on Docker Hub (only latest for now — versioning comes once the project stabilizes). It is a GraalVM native image: ~143MB, ~20ms startup.

cd feedarr-api
./gradlew dockerBuildNative --no-configuration-cache    # build joaomiguelcorreia/feedarr:latest locally
./gradlew dockerPushNative      # push to Docker Hub (requires docker login)

Run it (config can be overridden via env vars, e.g. APPLICATION_CACHE_TTL or APPLICATION_REFRACT_BASE_URL, matching the application.* config prefix):

docker run -p 8080:8080 joaomiguelcorreia/feedarr:latest
# then point Radarr/Sonarr at http://<host>:8080/feeds/...

webapp #

Svelte 5 + TypeScript on Vite, run with Bun.

cd webapp
bun install       # install dependencies
bun dev           # start the dev server (http://localhost:5173)
bun run build     # production build into dist/
bun run check     # type check (svelte-check + tsc)

In development, Vite proxies /api/* to feedarr-api on http://localhost:8080, stripping the /api prefix (see webapp/vite.config.ts). Override the backend origin with FEEDARR_API_URL in webapp/.env.