Plex libraries, naming, metadata, and scans

Two libraries, explicit paths

Omakase manages two Plex-facing roots:

• Anime for series;
• Anime Movies for movie entries.

Do not rely on historical Plex section numbers. Discover live sections by their validated names and types. Filesystem placement is based on the configured paths Plex sees, not on an AI guess or an old numeric key.

Understand path routing

The host, Omakase container, and Plex container may see the same bytes at different paths.

Host:      /srv/omakase/library/anime
Omakase:   /media/library/anime
Plex:      /data/anime

Use the Plex-visible path in the Plex setup request. Use the Omakase-visible path for application file checks. A correct host path with the wrong container mapping will still fail readiness.

Naming and identity

Omakase writes deterministic, identity-backed folders and metadata. Series and movies remain separate, aliases do not become duplicate libraries, and the AniList identity stays attached to the publication plan.

Posters and metadata are promoted with the media generation. A partially copied poster or metadata file is not allowed to become the current library state.

Plan before apply

Plex setup uses a reviewed request, a generated plan, and an expected plan hash. Apply rechecks the target before mutation. It can create the intended section or update one path, but it cannot delete a section.

For media publication, Omakase prepares a complete new generation and moves the stable pointer atomically. Plex never observes a half-written generation as current.

Scoped scans

After publication, Omakase scans only the changed series or movie area. One unhealthy title cannot freeze updates for unrelated monitored titles.

Do not treat a successful scan request as playback proof. Confirm:

1. the title resolves to the intended Plex item;
2. the expected episodes or movie are visible;
3. posters and title metadata are correct;
4. subtitle languages are selectable;
5. a representative HTTP range request or real client playback returns media bytes.

Plex and Infuse

Plex exposes embedded subtitle streams and metadata. Infuse may use the Plex library while applying its own playback timing and subtitle rendering behavior.

Same-release embedded subtitles reduce cross-cut drift risk, but no automation can guarantee every upstream mux is perfectly timed in every client. Verify representative playback on the clients that matter to you.

Recovery

Rollback selects a retained prior library generation and restores the recorded Plex configuration or database only when required. Provider media is not deleted by a curator rollback.

Read Backup, upgrade, and recovery before changing Plex database or section configuration.