ARRFLIX/docs/IMPORT-LOG/README.md

IMPORT-LOG

Append-only ledger of media-import events for ARRFLIX. Each file in this directory documents a single import operation so future audits can trace content on disk back to its provenance.

Convention

• One file per import event.
• Filename format: YYYY-MM-DD-<source>-<show-slug>.md
  • <source> is the upstream type (youtube, tvdb-rip, bluray, manual, etc.).
  • <show-slug> is the lowercase show name with - separators.
  • Example: 2026-05-08-youtube-sassy-the-sasquatch.md.
• Date is the day the import landed on the live library (not the day the source was published).

Required sections

Each entry should include:

1. Source — upstream URL/handle, channel/distributor, identifiers.
2. Date imported — ISO-8601.
3. Episodes imported — table mapping source identifier → canonical filename → Jellyfin item id (resolution + size where applicable).
4. Naming rules applied — citations of the docs/0X.md rule numbers invoked, with a short note on the specific edit each made.
5. rsync stats — sent / received / speedup from the transfer.
6. Jellyfin verification — series id, episode count, direct-play status.
7. Known caveats — anything that wasn't perfect (missing metadata, failed thumbnails, age-restricted episodes, etc.).
8. Source manifest copied — top-level fields of the operator's manifest.json. Do not embed the full episodes[] array — link to the canonical files in the live library instead.

Boundaries

• No access tokens, API keys, or session cookies in any log file.
• For YouTube imports, do not include full video URLs — record the bare videoId only, so import logs are not indexable as a re-distribution pointer.
• Logs are immutable once committed. To correct a mistake, append a follow-up entry rather than rewriting history.