How elliotttate/spatialslideshow works
Spatial Slideshow is a native Mac app that turns Photos-album or local-image selections into moving 3D scenes or video clips. The principal workflow selects sources, prepares them (including optional edge expansion), then queues and plays prepared items; playback can also render cached scenes live. The graph preserves documented model setup, music, and screen-saver capabilities. Several runtime modules are unsampled, so their internal call relationships are omitted rather than inferred.
Main entry points: SlideshowApp.swift Slideshow App · PlaybackPipeline.swift Preparation Pipeline · PhotoExpansion.swift Photo Expansion · AlbumBrowser.swift Album Browser
Components 21
App and Playback
- Slideshow App
Sources/SlideshowApp.swift - Album Browser
Sources/AlbumBrowser.swift - Playback Options
Sources/SlideshowOptions.swift - Continuous Playback
Sources/ContinuousPlayback.swift - Live Scene Surface
Sources/LivePlaybackSurface.swift - Music Playback
Sources/MusicPlayback.swift
Preparation and Rendering
- Preparation Pipeline
Sources/PlaybackPipeline.swift - Album Preparation Queue
Sources/AlbumPreparationQueue.swift - Scene Generation
Sources/GenerateScene.swift - Helper Process
Sources/HelperProcess.swift
Models and Expansion
- Photo Expansion
Sources/PhotoExpansion.swift - Apple Expansion
Sources/ExpandPhoto.swift - Draw Things Engine
Sources/ExpandPhotoDrawThings.py - Klein Engine
Sources/ExpandPhotoKlein.py - Model Runtime Setup
Sources/RuntimeInstaller.swift
Caches and Destinations
- Clip Cache
Sources/ClipCacheCatalog.swift - Scene Cache
Sources/SceneCache.swift - Video Cache
Sources/VideoClipCache.swift - Screen Saver
Sources/ScreenSaverController.swift
Other components
- Viewer
- Apple Photos
Connections 22
- Viewer → Slideshow App: starts slideshow
- Slideshow App → Album Browser: browses albums
Sources/SlideshowApp.swift - Album Browser → Apple Photos: loads assets
- Slideshow App → Playback Options: configures playback
Sources/SlideshowApp.swift - Slideshow App → Album Preparation Queue: prepares items
Sources/SlideshowApp.swift - Slideshow App → Preparation Pipeline: requests renders
Sources/SlideshowApp.swift - Preparation Pipeline → Photo Expansion: expands input
Sources/PlaybackPipeline.swift - Photo Expansion → Apple Expansion: runs backend
Sources/PhotoExpansion.swift - Photo Expansion → Draw Things Engine: runs backend
Sources/PhotoExpansion.swift - Photo Expansion → Klein Engine: runs backend
Sources/PhotoExpansion.swift - Photo Expansion → Model Runtime Setup: checks runtime
Sources/PhotoExpansion.swift - Preparation Pipeline → Scene Generation: generates scene
Sources/PlaybackPipeline.swift - Preparation Pipeline → Clip Cache: uses clip cache
Sources/PlaybackPipeline.swift - Preparation Pipeline → Scene Cache: uses scene cache
Sources/PlaybackPipeline.swift - Preparation Pipeline → Video Cache: uses video cache
Sources/PlaybackPipeline.swift - Preparation Pipeline → Helper Process: runs helpers
Sources/PlaybackPipeline.swift - Slideshow App → Continuous Playback: feeds prepared items
Sources/SlideshowApp.swift - Continuous Playback → Live Scene Surface: renders live scenes
Sources/SlideshowPlayerView.swift - Slideshow App → Music Playback: controls music
Sources/SlideshowApp.swift - Slideshow App → Screen Saver: manages screen saver
Sources/SlideshowApp.swift - Screen Saver → Scene Cache: reads scene cache
- Viewer → Model Runtime Setup: sets up models