RobOS Movie & Video Player

• 1. Movies Theater2:3 posters, spotlight hero, franchises, genres & 4K/BluRay filters
• 2. TV Shows & Seasons48 series & 2,641 episodes grouped by Show → Season → Episode
• 3. Roku & Smart TV App100% visual image-card 3-row TV interface with D-Pad navigation
• 4. Cinema Stage & Subtitles16:9 HTML5 video, synced .srt/.vtt dialogue, PiP & frame capture
• 5. AI Watchlists & HostOptional AI movie marathons & spoken RobOS Voice introductions
• 6. Poster & Metadata FixerTMDB, TVmaze, Wikidata, .nfo sidecars, ffprobe & ffmpeg
• 7. SFTP & Cloud StreamingZero-download indexing + HTTP 206 byte-range streaming
• 8. Architecture & CLISystem diagram, file layout, and reproducible test commands

Works 100% without AI. Like every app in RobOS, Movie Player is a complete, fast local and LAN home theater out of the box. Public poster and plot enrichment uses open public APIs (TMDB/TVmaze/Wikidata) and local ffprobe/ffmpeg inspection. AI features (✦ AI Watchlist, Virtual Cinema Host, and agentic ✦ AI Fix Metadata) are optional buttons that use the coding-agent CLI you already signed in to.

1. Movies Theater: 100,000-Film Virtualized Poster Browser

Movie folders rarely arrive with clean metadata: filenames look like Avengers.Endgame.2019.2160p.UHD.BluRay.x265.10bit.HDR-GROUP.mkv, and duplicate encodes (`720p`, `1080p BluRay`, `2160p WEB-DL`) often sit side by side. During background worker-thread scanning (lib/track-metadata.js), cleanMovieFilename() strips release noise while extracting the canonical film title, 4-digit release year, resolution badge (4K UHD, 1080p, 720p), source medium (BluRay, WEB-DL, HDRip), and video codec (HEVC, AV1, H.264).

• Feature Film Spotlight Banner: Highlights a featured film at the top of the library with its 2:3 theatrical poster, franchise badge (e.g. The Conjuring Universe, Marvel & Avengers, The Lord of the Rings, Harry Potter Wizarding World), release year, resolution badge, director and cast credits, plot synopsis, and one-click ▶ Watch Movie or 📺 Cast to TV actions.
• Cinema Navigation Views: Switch between All Movies (virtualized 2:3 poster grid with an A–Z jump rail), Franchises & Box Sets (auto-grouped sagas and trilogies), Movie Genres (Action & Adventure, Animation & Family, Comedy & Romance, Drama & Cinema, Horror & Supernatural, Sci-Fi & Fantasy, Thriller & Mystery), 4K & BluRay Formats, Release Decades, and All Movies (A–Z List).
• Watch Progress & Resume Tracking: Remembers your exact playback timestamp (`positionSec`, `progressPct`, `inProgress`, `completed`) across desktop and Smart TV sessions, surfacing partially watched films under Continue Watching.

2. TV Shows & Season Navigator: 48 Series & 2,641 Episodes

Movies and episodic television need different browsing ergonomics. Instead of dumping 2,600 episodes into a flat movie grid, RobOS Movie Player automatically detects episodic patterns (`S01E01`, `1x02`, `Season 1`, `Book One`, `Part II`, `Extras/Specials`) in lib/library-index.js and separates them into a dedicated top-level TV Shows tab.

3. Roku OS & Smart TV App: 3-Row 100% Visual Image-Card UX

When you sit 10 feet from a 65-inch TV with a directional remote, plain text menus feel dated and slow. RobOS Movie Player pairs with RobOS Smart TV Studio (packages/robos-lib/tv-engine.js) to sideload a native Roku OS SceneGraph channel (and serve an identical 10-foot web portal at :19210/movie-player for LG webOS, Samsung Tizen, and Google TV / Android TV) where every selectable item in every row is an image card with text.

Thoughtful 2D Remote D-Pad Navigation

The entire 10-foot TV experience is organized into 3 visual rows so you can reach the Movies and TV Shows tabs in at most two presses of [UP] from anywhere on screen, and move [LEFT] / [RIGHT] smoothly across whichever row is focused:

4. Cinema Stage, Synced Subtitles & Smart TV Output

Clicking any movie or episode (or switching to the Cinema Stage tab) opens the 16:9 theater viewport and synchronized transport deck:

• Synced .srt / .vtt Subtitles & Click-to-Seek Dialogue (lib/lyrics.js): Automatically loads sidecar .srt, .vtt, or .lrc files or extracts embedded subtitle tracks via ffmpeg. Active lines render as a theater caption overlay on the video stage and auto-scroll in the transcript panel; clicking any dialogue line seeks both the local video and active Smart TV stream to that exact second.
• Playback Speed, Aspect Fit, PiP & Frame Snapshots: Cycle speed (`0.5x`–`2x`), aspect fit (`Letterbox`, `Cover`, `Fill`), float the stage in an always-on-top Picture-in-Picture window, or capture native-resolution PNG stills to ~/Pictures/RobOS Movie Snapshots/.

5. Optional AI Watchlists & Spoken Virtual Cinema Host

Just like RobOS Audio Player offers AI Playlists and a Virtual DJ, RobOS Movie Player includes optional AI curation grounded in your own library:

• ✦ AI Watchlist (src/AiPlaylist.jsx): Describe a theme (e.g. "90-minute supernatural horror double feature from the 2010s" or "family-friendly animated adventure night") and your active coding agent selects and orders matching titles from your library.
• Virtual Cinema Host (src/useVirtualDj.js): Writes short 1–2 sentence TCM-style presenter intros ahead of each film in your queue and speaks them aloud via RobOS Voice (locally or over your Smart TV).

6. Public TMDB / TVmaze Enrichment & AI Metadata Fixer

Clicking Fetch Posters & Metadata in the library sidebar (or Fetch Metadata in the toolbar) runs lib/public-metadata.js across your movies and TV series:

1. TV Series & Episode Enrichment (TVmaze Public API): Matches each TV series title, downloads the official 2:3 series poster into the content-addressed art cache (~/.cache/robos/movie-player/art/), and populates series plot synopses, network names, star ratings, premiere years, and per-episode titles, air dates, and episode overviews.
2. Feature Film Enrichment (TMDB / Wikidata / Wikipedia REST + Apple iTunes Search): Fetches official theatrical 2:3 poster artwork, release years, MPAA/content ratings, director & cast credits, and plot synopses, persisted in ~/.config/robos/movie-public-metadata-cache.json.
3. Local Sidecars & ffprobe / ffmpeg Fallback: Parses Kodi/Jellyfin .nfo XML files, inspects container streams via ffprobe, and extracts a real video frame at 10% runtime via ffmpeg whenever a personal home video has no public poster.

7. SFTP Data Sources & Cloud HTTP 206 Byte-Range Streaming

Your video library doesn't have to fit on your laptop's internal SSD. RobOS Movie Player connects directly to RobOS Data Sources (SSH/SFTP servers) and RobOS Cloud Accounts (Google Drive, Microsoft OneDrive, Dropbox, S3):

• Metadata-Only Indexing (lib/cloud-storage.js): Walks remote SFTP directories (such as /downloads/movies and /downloads/shows) or cloud folders and indexes filenames, sizes, and season/episode structures in seconds without copying video bytes.
• Zero-Cloud LAN HTTP 206 Partial Content Streamer (lib/cast-service.js): When you press Play on desktop or on your Roku TV, Movie Player serves `/cloud-stream/:trackId` with full HTTP byte-range (`Range: bytes=...`) support and a 2 GB LRU disk cache (`~/.cache/robos/movie-player/cloud`), enabling instant scrubbing and hardware decoding on Roku OS, Google TV, and desktop.

8. Architecture, File Layout & Reproducible CLI

# Build the renderer bundle and run the 19-test Movie & TV Show verification suite
cd packages/movie-player && npm run build && npm test

# Launch RobOS Movie Player and inspect via the DOM Snapshot server (:19214)
npx electron packages/movie-player --no-sandbox
node packages/robos-lib/snapshot-cli.js movie-player --text
node packages/robos-lib/snapshot-cli.js movie-player --screenshot /tmp/movie-player.png