Files
MetaAppStore/Apps/MetaPluginTMDB/docker-compose.yml
T
Manielle 8c98785e38 serve assets and the store archive from gitea-watch (the GitHub repo is gone)
github.com/Worph/MetaAppStore answers 404, and with it every jsDelivr
cdn.jsdelivr.net/gh/Worph/MetaAppStore@main/ URL: the icons, thumbnails and
screenshots of all 44 apps were missing from the store listing, and the store
source in the README no longer downloaded.

- Asset URLs in every Apps/*/docker-compose.yml now point at
  https://gitea-watch.nsl.sh/metastar/MetaAppStore/raw/branch/main/Apps/{AppName}/
  (103 of the 109 distinct URLs checked: 200 image/png). The other 6, MetaGateway
  and MetaWatch screenshot-1..3, name files that have never been in this repo.
- README: the store source is https://gitea-watch.nsl.sh/metastar/MetaAppStore/archive/main.zip
  (public, checked to download anonymously).
- CLAUDE.md and CONTRIBUTING.md: the asset rule and its grep guard follow, so an
  import cannot bring back a jsDelivr URL unnoticed.
2026-10-19 16:06:27 +00:00

152 lines
6.8 KiB
YAML

name: metaplugintmdb
# =============================================================================
# MetaPlugin · TMDB — the `tmdb` enrichment plugin, as a standalone app.
#
# A MetaMesh enrichment plugin is a HEADLESS worker: it speaks the four-verb
# plugin HTTP contract (`/manifest`, `/health`, `/configure`, `/process`) and
# nothing else. There is no dashboard — the web UI on this tile is the plugin's
# own `/manifest`, which is how you confirm it is alive and what version it is.
#
# ⚠ WHAT CONSUMES IT. A MetaFeeder's enrichment sidecar slot: set
# `TMDB_PLUGIN_URL` on the feeder to `http://metaplugintmdb-plugin:8080` and it uses this
# shared instance instead of its own bundled copy. (The feeder SDK otherwise
# DERIVES the sidecar URL from its own hostname, so the explicit variable is
# what makes sharing possible at all.)
# **NOT MetaSort**: MetaSort starts its own plugin containers from its
# `plugins.yml` (`image:`) and has no URL slot, so installing this app does
# not add a plugin to MetaSort.
#
# ⚠ IT HOLDS NO CREDENTIALS. The caller POSTs `/configure` with its own key
# (TMDB token, OpenSubtitles account) before use. Two consumers sharing one
# instance are last-writer-wins on that config — same key, no problem; different
# keys, install a second copy.
#
# Everything is scoped under the `metaplugintmdb-*` prefix + the per-stack `metaplugintmdb`
# network + /DATA/AppData/metaplugintmdb/ data root, so it installs beside the other Meta* apps with zero
# collisions.
# =============================================================================
services:
# ---------------------------------------------------------------------------
# metaplugintmdb-plugin — the plugin. Listens on 8080; joined to `pcs` so any
# consumer on the box can reach it by name. Default queue: background.
# ---------------------------------------------------------------------------
metaplugintmdb-plugin:
image: ipcr-watch.nsl.sh/ipns/metadec.eth/metadec.eth/metamesh-plugin-tmdb:1.0.5
cpu_shares: 30
container_name: metaplugintmdb-plugin
# Hard RAM cap, swap disabled (memswap_limit == mem_limit) → OOM
# instead of swap. Mirrors the limits the bundled sidecars run with.
mem_limit: 384m
memswap_limit: 384m
hostname: metaplugintmdb-plugin
restart: unless-stopped
user: "0:0"
expose:
- 8080
environment:
# Where the plugin writes the artefacts it produces (posters, stills,
# extracted subtitles) — the shared MetaCore's WebDAV over `pcs`.
# LOAD-BEARING: the published images resolve WebDAV from this var, and
# without it they log "WebDAV client unavailable" and silently write
# nothing. Every record then fails MetaWatch's poster gate.
WEBDAV_URL: "http://metacore-app:9000/webdav"
TZ: "$TZ"
volumes:
# Plugin cache. Persisted so a recreate does not redo work that is
# expensive to redo; safe to delete, it rebuilds.
- ${DATA_ROOT:-/DATA}/AppData/metaplugintmdb/cache:/cache:rw
networks:
- pcs
networks:
pcs:
name: ${APP_NET:-pcs}
external: true
x-casaos:
architectures:
- amd64
- arm64
author: Worph Team
category: Developer
developer: Aptero Team
description:
en_us: |
**The `tmdb` enrichment plugin for MetaMesh, as its own app.**
Looks a title up on **The Movie Database** and writes the identity a record is anchored by — `tmdbid`, `imdbid`, localized titles — plus the poster and backdrop artwork.
**Bring your own key.** The plugin stores no credentials: the caller
POSTs its own TMDB token to `/configure` before each use.
**Requires MetaCore** — the artwork is written to its WebDAV, and a record
without a poster is hidden by MetaWatch's quality gate.
**Headless.** It answers the plugin HTTP contract — `/manifest`, `/health`,
`/configure`, `/process` — and has no dashboard; this tile opens its
`/manifest`. Point a consumer at `http://metaplugintmdb-plugin:8080`.
**Who can use it today:** a **MetaFeeder** app, through its
`TMDB_PLUGIN_URL` setting — one shared copy instead of one bundled per feeder.
**Not a MetaSort plugin.** MetaSort starts its own plugin containers from
`plugins.yml` and has no slot for a plugin URL.
fr_fr: |
**Le plugin d'enrichissement `tmdb` de MetaMesh, en app autonome.**
Recherche un titre sur **The Movie Database** et écrit l'identité d'un enregistrement — `tmdbid`, `imdbid`, titres localisés — ainsi que l'affiche et l'image d'arrière-plan.
**Sans interface.** Il répond au contrat HTTP des plugins — `/manifest`,
`/health`, `/configure`, `/process` — et n'a pas de tableau de bord ; cette
tuile ouvre son `/manifest`. Dirigez un consommateur vers
`http://metaplugintmdb-plugin:8080`.
**Ce n'est pas un plugin MetaSort** : MetaSort démarre ses propres
conteneurs de plugins depuis `plugins.yml` et n'accepte pas d'URL.
tagline:
en_us: TMDB identity and artwork for MetaMesh records
fr_fr: Identité et visuels TMDB pour les enregistrements MetaMesh
title:
en_us: MetaPlugin · TMDB
icon: https://gitea-watch.nsl.sh/metastar/MetaAppStore/raw/branch/main/Apps/MetaPluginTMDB/icon.png
thumbnail: https://gitea-watch.nsl.sh/metastar/MetaAppStore/raw/branch/main/Apps/MetaPluginTMDB/thumbnail.png
store_app_id: metaplugintmdb
is_uncontrolled: false
tips:
before_install:
en_us: |
**What this is for:** running the `tmdb` plugin **once, shared**, instead of
one bundled copy inside every app that needs it.
**After installing:** set `TMDB_PLUGIN_URL` to `http://metaplugintmdb-plugin:8080` in the
MetaFeeder app that should use it, then restart that feeder. Left unset,
the feeder keeps using its own bundled copy.
**It is not a MetaSort plugin.** MetaSort spawns its own plugin containers
from `plugins.yml` (`image:`), with no URL slot — installing this app does
not add `tmdb` to MetaSort.
**Requires MetaCore** on the same box: this plugin writes what it
produces to MetaCore's WebDAV (`http://metacore-app:9000/webdav`).
**No web UI:** a headless service. Its consumers reach it directly on the
`pcs` network.
# 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/metaplugintmdb/cache
user: $PUID
group: $PGID