name: metafeederjamendo

# =============================================================================
# MetaFeeder · Jamendo — Creative-Commons music for MetaMesh.
#
# Opt-in: soft-skips (healthy, answers nothing) unless JAMENDO_CLIENT_ID is set.
#
# ⚠ Jamendo's non-commercial tier is a MONTHLY BUDGET (35,000 requests), not a
# per-second rate. Spend it and the upstream is gone until the calendar turns —
# a backoff does not recover it. The feeder tracks the budget itself; don't
# raise it here without reading its consts.rs.
#
# It needs, over the shared `pcs` network:
#   - the **MetaGateway** app — which must list this feeder's URL
#     (`http://metafeederjamendo-feeder:8080`) in its feeders config so it gets discovered.
#     Discovery is startup-only, so restart the gateway afterwards.
#
# Everything is scoped under the `metafeederjamendo-*` prefix + the per-stack `metafeederjamendo` network +
# /DATA/AppData/metafeederjamendo/ data root, so it installs beside the other Meta* apps with
# zero collisions.
# =============================================================================

services:
  # ---------------------------------------------------------------------------
  # metafeederjamendo-feeder — the feeder itself. The gateway reaches it directly on
  # `pcs` for discovery/query/compute; the human configures it
  # from the MetaGateway dashboard (configure panel).
  # ---------------------------------------------------------------------------
  metafeederjamendo-feeder:
    image: ghcr.io/worph/meta-feeder-jamendo:1.1.3
    cpu_shares: 30
    container_name: metafeederjamendo-feeder
        # Bytes tier: one mp32 derivative is buffered whole before hand-off.
        # Swap disabled (memswap_limit == mem_limit) → OOM instead of thrash.
    mem_limit: 512m
    memswap_limit: 512m
    hostname: metafeederjamendo-feeder
    restart: unless-stopped
    user: "0:0"
    expose:
      - 8080
    environment:
      RUST_LOG: "info,meta_feeder=info,jamendo_feeder=info"
      META_FEEDER_STATE_DIR: "/data/meta-feeder"
      # Jamendo is opt-in. Blank → the feeder soft-skips. This image has no
      # config-UI field for the client id yet, so it is read from the environment.
      JAMENDO_CLIENT_ID: "${JAMENDO_CLIENT_ID:-}"
      TZ: "$TZ"
    volumes:
      # Persist feeder config.json + redb cache so it survives recreate.
      - ${DATA_ROOT:-/DATA}/AppData/metafeederjamendo/state:/data/meta-feeder:rw
    healthcheck:
      test: ["CMD", "curl", "-sf", "http://localhost:8080/health"]
      interval: 5s
      timeout: 3s
      retries: 10
      start_period: 5s
    networks:
      - pcs
networks:
  pcs:
    name: ${APP_NET:-pcs}
    external: true

x-casaos:
  architectures:
    - amd64
    - arm64
  author: Worph Team
  category: Media
  developer: Aptero Team

  description:
    en_us: |
      **Creative-Commons music for the MetaMesh network.**

      MetaFeeder · Jamendo bridges **Jamendo**'s Creative-Commons catalogue into
      MetaMesh as a *bytes* tier: tracks are fetched and seeded to the swarm.

      **Opt-in.** It needs a free Jamendo client id; without one it stays healthy
      and simply finds nothing. Jamendo's non-commercial tier is a **monthly
      budget** (35,000 requests), not a rate limit — the feeder paces itself
      against it.
      **Requires:** **MetaGateway** — its meta-core stores the resolved records and
      announces them to the swarm. The gateway must list this feeder in its config.
    fr_fr: |
      **La musique Creative Commons pour le réseau MetaMesh.**

      MetaFeeder · Jamendo connecte le catalogue Creative Commons de **Jamendo**
      à MetaMesh : les morceaux sont récupérés puis partagés au swarm.

      **Sur activation** : nécessite un identifiant client Jamendo gratuit ; sans
      lui, le feeder reste sain et ne trouve rien. Le quota Jamendo est **mensuel**
      (35 000 requêtes). **Nécessite** l'app **MetaGateway**.
  tagline:
    en_us: Jamendo Creative-Commons music for MetaMesh (client id required)
    fr_fr: Musique Creative Commons Jamendo pour MetaMesh (identifiant client requis)

  title:
    en_us: MetaFeeder · Jamendo

  icon: https://cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/Apps/MetaFeederJamendo/icon.png
  thumbnail: https://cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/Apps/MetaFeederJamendo/thumbnail.png

  store_app_id: metafeederjamendo
  is_uncontrolled: false

  tips:
    before_install:
      en_us: |
        **Install order:** install **MetaGateway** first (its meta-core stores and
        announces what this feeder finds).

        **After installing this app:** in **MetaGateway**, add this feeder from the
        dashboard's *Add a feeder* box — name `jamendo-feeder`, URL `http://metafeederjamendo-feeder:8080`.
        The gateway restarts itself: feeder discovery is startup-only.
        **Client id:** register a free app at developer.jamendo.com, set
        `JAMENDO_CLIENT_ID` in this app's environment, then restart the app.
        Without it the feeder soft-skips. Pairs with **MetaListen**.
        **No web UI of its own:** configure it from the **MetaGateway** dashboard → this feeder → *configure* (the gateway proxies this feeder's config page, behind the gateway's login).

# Maison (Yundera dashboard) configuration. Read in preference to x-casaos.
# schema_version 2 is required for `folders`: an older Maison refuses the app
# outright rather than starting it without its directories.
x-compose-app:
  schema_version: 2
  # Created and chowned by Maison before any image is pulled, before any hook
  # runs and before the containers start — on the first boot and every one after.
  # Compose would otherwise create a missing bind source as a root-owned dir.
  folders:
    - path: /DATA/AppData/metafeederjamendo/state
      user: $PUID
      group: $PGID