How dilharajay/mediasort-studio works
MediaSort scans event-photo folders, classifies images, records routing decisions, supports human review, and reconciles/export bins without modifying originals. Users enter through either the desktop GUI or CLI; the GUI calls a local FastAPI sidecar. The graph preserves the documented classification, review, configuration, and delivery stages. Some subsystem links reflect README or SOURCE INDEX references; unsampled route and export internals are not inferred beyond those references.
Main entry points: cli.py CLI · server.py FastAPI server · classify.py Classification API · config.py Event settings
Components 26
User clients
- Desktop app
mediasort-ui/src/App.jsx - Review panels
mediasort-ui/src/components - API client
mediasort-ui/src/api.js - CLI
mediasort/cli.py - Electron sidecar
mediasort-ui/electron/sidecar.js
Local API
- FastAPI server
mediasort/api/server.py - Event and manifest
mediasort/api/routes/manifest.py - Classification API
mediasort/api/routes/classify.py - Image API
mediasort/api/routes/images.py - Review API
mediasort/api/routes/review.py - Export API
mediasort/api/routes/export.py - Configuration API
mediasort/api/routes/config.py
Image processing
- Folder scanner
mediasort/ingest/scanner.py - Image decoder
mediasort/ingest/decoder.py - Thumbnail service
mediasort/api/thumbnails.py
Classification and review
- Semantic and aesthetic
mediasort/classify/clip.py - Face and blink analysis
mediasort/classify/face.py - Technical quality
mediasort/classify/iqa.py - Score and routing
mediasort/classify/fusion.py - Interactive review
mediasort/review_cli.py
Manifest and delivery
- Event manifest
mediasort/manifest/models.py - Event settings
mediasort/config.py - Bin reconciliation
mediasort/copy_cli.py - Delivery export
mediasort/commit_cli.py - XMP sidecars
mediasort/xmp.py
Other components
- Photographer
Connections 48
- Photographer → Desktop app: reviews photos
- Photographer → CLI: runs stages
- Desktop app → API client: requests data
mediasort-ui/src/App.jsx - Desktop app → Review panels: renders
mediasort-ui/src/App.jsx - API client → FastAPI server: HTTP and WebSocket
mediasort-ui/src/api.js - Electron sidecar → FastAPI server: launches locally
- FastAPI server → Event and manifest: registers
mediasort/api/server.py - FastAPI server → Classification API: registers
mediasort/api/server.py - FastAPI server → Image API: registers
mediasort/api/server.py - FastAPI server → Review API: registers
mediasort/api/server.py - FastAPI server → Export API: registers
mediasort/api/server.py - FastAPI server → Configuration API: registers
mediasort/api/server.py - Event and manifest → Folder scanner: scans event folder
mediasort/api/routes/manifest.py - Event and manifest → Event manifest: loads and saves
mediasort/api/routes/manifest.py - Classification API → Folder scanner: scans images
mediasort/api/routes/classify.py - Classification API → Semantic and aesthetic: classifies
mediasort/api/routes/classify.py - Classification API → Face and blink analysis: analyzes faces
mediasort/api/routes/classify.py - Classification API → Technical quality: scores quality
mediasort/api/routes/classify.py - Classification API → Event settings: reads settings
mediasort/api/routes/classify.py - Classification API → Event manifest: records results
- Image API → Thumbnail service: serves thumbnails
mediasort/api/routes/images.py - Image API → Event and manifest: reads manifest
mediasort/api/routes/images.py - Review API → Event and manifest: updates decisions
mediasort/api/routes/review.py - Export API → Bin reconciliation: runs reconciliation
mediasort/api/routes/export.py - Export API → Delivery export: runs delivery export
mediasort/api/routes/export.py - Configuration API → Event settings: reads and updates
- CLI → Folder scanner: scans
mediasort/cli.py - CLI → Image decoder: decodes
mediasort/cli.py - CLI → Semantic and aesthetic: classifies
mediasort/cli.py - CLI → Face and blink analysis: analyzes faces
mediasort/cli.py - CLI → Technical quality: scores quality
mediasort/cli.py - CLI → Score and routing: routes scores
mediasort/cli.py - CLI → Interactive review: starts review
mediasort/cli.py - CLI → Bin reconciliation: reconciles bins
mediasort/cli.py - CLI → Delivery export: exports delivery
mediasort/cli.py - Image decoder → Folder scanner: checks RAW type
mediasort/ingest/decoder.py - Image decoder → Event settings: uses decode settings
mediasort/ingest/decoder.py - Thumbnail service → Image decoder: decodes previews
mediasort/api/thumbnails.py - Semantic and aesthetic → Event settings: uses taxonomy
mediasort/classify/clip.py - Face and blink analysis → Event settings: uses face settings
mediasort/classify/face.py - Technical quality → Event settings: uses quality settings
mediasort/classify/iqa.py - Score and routing → Event settings: uses routing settings
mediasort/classify/fusion.py - Interactive review → Event manifest: reads decisions
mediasort/review_cli.py - Bin reconciliation → Event manifest: reconciles from
mediasort/copy_cli.py - Delivery export → Event manifest: reads decisions
mediasort/commit_cli.py - Delivery export → XMP sidecars: writes sidecars
mediasort/commit_cli.py - Desktop app → Event settings: edits settings
- Desktop app → Event manifest: shows live results