GuíasBiblioteca

Activar los metadatos incrustados

Cómo habilitar, por raíz, que Styx escriba título, ids y portada dentro de tus vídeos, y cómo revisarlo.

EspecificadoNo implementado
track/docstrack/plugin-seamstrack/media-enginetrack/domain-media/file-ssottrack/media-engine/metadata-embeddec-0126dec-0117dec-0114dec-0124track/docs:DC9track/domain-media/file-ssot:FS1track/domain-media/file-ssot:FS2track/domain-media/file-ssot:FS3track/domain-media/file-ssot:FS4track/media-engine/metadata-embed:MB1

Especificado. Diseño en dec-0126 (PROPOSED). Nada de esto está implementado. El porqué está en Metadatos en el fichero; aquí, el cómo.

Es opt-in, por raíz

Por defecto Styx no modifica tus ficheros. Para activarlo, la raíz tiene que cumplir dos cosas:

  1. El operador la marca como escribible para metadatos (rw-metadata) y la monta con permiso de escritura. Si el daemon arranca y no puede escribir, la sirve como de sólo lectura e informa de salud degradada. Nunca reintenta escribir.
  2. En el catálogo, la raíz declara metadataEmbed: merge (o overwrite). Por defecto es off.
styx library root set peliculas --embed merge

Qué no se toca nunca

Fuentes remotas, raíces de sólo lectura, ficheros que se están sembrando como torrent, ficheros con más de un enlace duro (típico de los flujos *arr), ficheros de otro propietario y formatos que el editor no soporta. Para esos, los metadatos viven sólo en el catálogo.

Probar sin escribir

styx library embed <asset> --dry-run          # muestra el diff entre las etiquetas actuales y el plan
styx library embed status --root peliculas --json

Los estados por fichero son sin escribir, escrito (rev N), pendiente, excluido (motivo) y conflicto. Un conflicto (alguien editó el fichero con otra herramienta) se resuelve en la cola de revisión.

Preparar la biblioteca (reescritura con padding)

Un MP4 sin espacio libre tras sus metadatos obliga a reescribir el fichero entero para añadir una portada. Para evitarlo, una vez, con permiso explícito (allowRewrite):

styx library prepare --root peliculas

Reserva 1 MiB de relleno (free) en cada fichero, en un fichero temporal que sustituye al original sin dejar ninguno a medias. Es destructivo: pide confirmación y tiene --dry-run.

Los nombres de comando son los del registro de operaciones propuesto en dec-0126 §9; los confirma el ADR de headless.