134 lines
5.8 KiB
YAML
134 lines
5.8 KiB
YAML
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: ghcr.io/worph/meta-feeder-youtube:1.1.2
|
|
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://cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/Apps/MetaFeederYouTube/icon.png
|
|
thumbnail: https://cdn.jsdelivr.net/gh/Worph/MetaAppStore@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
|