How abstractmachine/head-irad-playable-cinema works
Playable Cinema is a research project for connecting gameplay with historical film; its software includes Crossing Tool for training and playback, plus a separate Nickelodeon playback application. The map highlights media identity and annotation, frame matching and search, visual analysis, and engraving, alongside playback. The sampled references show several data and service dependencies, but not the full CLI or visualization wiring; those links are omitted where evidence is unavailable.
Main entry points: frame_match.py Frame Matching · metadata.py Media Metadata · app.py Nickelodeon App · annotate.py Shot Annotation
Components 22
Crossing Tool
- Crossing CLI
code/crossing-tool/cli.py - Visualizer Launcher
code/crossing-tool/visualizers/launcher.py - Sync Visualizer
code/crossing-tool/visualizers/sync_visualizer.py - MCP Server
code/crossing-tool/mcp_server/mcp_server.py
Media and Annotation
- Media Metadata
code/crossing-tool/data/metadata.py - Media Identity
code/crossing-tool/data/media_id.py - Shotlists
code/crossing-tool/data/shotlist.py - Shot Annotation
code/crossing-tool/data/annotate.py - Resource Locations
code/crossing-tool/data/resource_locations.py - Resource Registry
code/crossing-tool/data/resource_storage.py
Analysis and Generation
- Frame Matching
code/crossing-tool/services/frame_match.py - Frame Retrieval
code/crossing-tool/services/frame_retrieval.py - Shot Search
code/crossing-tool/services/search.py - Scene Detection
code/crossing-tool/services/scene_detection.py - Visual Generators
code/crossing-tool/generators - Engraving Pipeline
code/crossing-tool/services/engraving_local_pipeline.py
Playback
- Nickelodeon App
code/playable-nickelodeon/app.py - Film Catalog
code/playable-nickelodeon/cinematheque.py - Media Player
code/playable-nickelodeon/player.py - Playback Switcher
code/playable-nickelodeon/switcher.py - Control Server
code/playable-nickelodeon/server.py
Other components
- Researcher
Connections 26
- Researcher → Crossing CLI: uses
- Media Metadata → Media Identity: computes IDs
code/crossing-tool/data/metadata.py - Media Metadata → Resource Registry: uses registry
code/crossing-tool/data/metadata.py - Media Metadata → Resource Locations: resolves paths
code/crossing-tool/data/metadata.py - Shot Annotation → Resource Registry: uses registry
code/crossing-tool/data/annotate.py - Shot Annotation → Resource Locations: resolves paths
code/crossing-tool/data/annotate.py - Shot Annotation → Shotlists: updates
code/crossing-tool/data/annotate.py - Frame Matching → Shot Annotation: reads and updates
code/crossing-tool/services/frame_match.py - Frame Matching → Media Metadata: reads
code/crossing-tool/services/frame_match.py - Frame Matching → Shotlists: reads
code/crossing-tool/services/frame_match.py - Frame Matching → Resource Locations: resolves paths
code/crossing-tool/services/frame_match.py - Frame Matching → Resource Registry: uses registry
code/crossing-tool/services/frame_match.py - Frame Retrieval → Frame Matching: calls
code/crossing-tool/services/frame_retrieval.py - Frame Retrieval → Shot Search: calls
code/crossing-tool/services/frame_retrieval.py - Frame Retrieval → Visual Generators: uses mosaic
code/crossing-tool/services/frame_retrieval.py - Sync Visualizer → Frame Matching: uses
code/crossing-tool/visualizers/sync_visualizer.py - Sync Visualizer → Media Metadata: reads
code/crossing-tool/visualizers/sync_visualizer.py - Sync Visualizer → Media Identity: uses
code/crossing-tool/visualizers/sync_visualizer.py - Nickelodeon App → Film Catalog: uses
code/playable-nickelodeon/app.py - Nickelodeon App → Playback Switcher: uses
code/playable-nickelodeon/app.py - Nickelodeon App → Media Player: uses
code/playable-nickelodeon/app.py - Nickelodeon App → Control Server: uses
code/playable-nickelodeon/app.py - Media Player → Film Catalog: reads catalog
code/playable-nickelodeon/player.py - Media Player → Playback Switcher: uses
code/playable-nickelodeon/player.py - Playback Switcher → Film Catalog: reads catalog
code/playable-nickelodeon/switcher.py - Control Server → Film Catalog: gets films
code/playable-nickelodeon/server.py