name: metafeederyoutube

# =============================================================================
# MetaFeeder · YouTube — the DELEGATED playback tier for MetaMesh.
#
# ⚠ No bytes are ever fetched, transported or seeded by this feeder. It resolves
# a reference — an 11-character video id — and playback happens on YouTube. That
# is the whole design, and it is why the feeder is cheap and why a dead upstream
# instance is a retry rather than a broken stream.
#
# Video ids are read through a POOL of public Piped instances, tried in order.
# Measured during the source study: of four instances, one 502'd, two
# 301-redirected away and one answered. The pool is the mitigation; do not pin
# it to a single hostname.
#
# It needs, over the shared `pcs` network:
#   - the **MetaGateway** app — which must list this feeder's URL
#     (`http://metafeederyoutube-feeder:8080`) in its feeders config so it gets discovered.
#     Discovery is startup-only, so restart the gateway afterwards.
#
# Everything is scoped under the `metafeederyoutube-*` prefix + the per-stack `metafeederyoutube` network +
# /DATA/AppData/metafeederyoutube/ data root, so it installs beside the other Meta* apps with
# zero collisions.
# =============================================================================

services:
  # ---------------------------------------------------------------------------
  # metafeederyoutube-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).
  # ---------------------------------------------------------------------------
  metafeederyoutube-feeder:
    image: ipcr-watch.nsl.sh/ipns/metadec.eth/metadec.eth/meta-feeder-youtube:1.1.3
    cpu_shares: 30
    container_name: metafeederyoutube-feeder
        # Delegated tier: it moves an 11-character video id, never bytes.
        # Swap disabled (memswap_limit == mem_limit) → OOM instead of thrash.
    mem_limit: 256m
    memswap_limit: 256m
    hostname: metafeederyoutube-feeder
    restart: unless-stopped
    user: "0:0"
    expose:
      - 8080
    environment:
      RUST_LOG: "info,meta_feeder=info,youtube_feeder=info"
      META_FEEDER_STATE_DIR: "/data/meta-feeder"
      TZ: "$TZ"
    volumes:
      # Persist feeder config.json + redb cache so it survives recreate.
      - ${DATA_ROOT:-/DATA}/AppData/metafeederyoutube/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: |
      **YouTube as a delegated playback tier for MetaMesh.**

      MetaFeeder · YouTube resolves a *reference*, not a file: playback happens on
      YouTube and **no bytes are ever transported or seeded**. That makes it the
      cheapest way to make a catalogue playable — and the one tier that adds
      nothing to the swarm.

      Video ids are read through a pool of public **Piped** instances, rotating
      past a dead one. Keyless, nothing to configure.
      **Pairs with MetaFeeder · MusicBrainz**, which names the recording a
      candidate has to match (±10 s runtime) before it is accepted.
      **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: |
      **YouTube comme couche de lecture déléguée pour MetaMesh.**

      MetaFeeder · YouTube résout une *référence*, pas un fichier : la lecture a
      lieu sur YouTube et **aucun octet n'est transporté ni partagé**. Les
      identifiants vidéo sont lus via un pool d'instances **Piped** publiques.
      Sans clé. **Va avec MetaFeeder · MusicBrainz**. **Nécessite** l'app
      **MetaGateway**.
  tagline:
    en_us: YouTube references for MetaMesh — delegated playback, no bytes seeded
    fr_fr: Références YouTube pour MetaMesh — lecture déléguée, aucun octet partagé

  title:
    en_us: MetaFeeder · YouTube

  icon: https://gitea-watch.nsl.sh/metastar/MetaAppStore/raw/branch/main/Apps/MetaFeederYouTube/icon.png
  thumbnail: https://gitea-watch.nsl.sh/metastar/MetaAppStore/raw/branch/main/Apps/MetaFeederYouTube/thumbnail.png

  store_app_id: metafeederyoutube
  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 `youtube-feeder`, URL `http://metafeederyoutube-feeder:8080`.
        The gateway restarts itself: feeder discovery is startup-only.
        No API key. For music, also install **MetaFeeder · MusicBrainz** — it
        names the recording a YouTube candidate must match before it is accepted.
        **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/metafeederyoutube/state
      user: $PUID
      group: $PGID