How stippiedot/videocull works
VideoCull is a local Windows video-triage app: users load folders, inspect generated thumbnail strips in a grid or focused player, mark review decisions, compare duplicates, and confirm deletion. The graph captures the renderer-to-Electron workflow plus cache, media processing, and duplicate analysis; export and maintenance are retained as documented capabilities. Arrows use explicit README statements or shown references/calls; unsampled subsystems are linked only where documentation supports the relationship.
Main entry points: main.js Electron main process · App.tsx App shell · store.ts Renderer state · SettingsModal.tsx Settings and export
Components 20
Review interface
- App shell
src/App.tsx - Video grid
src/components/GridMode.tsx - Focused player
src/components/ReviewMode.tsx - Search and filters
src/components/Sidebar.tsx - Settings and export
src/components/SettingsModal.tsx - Duplicate review
src/components/DuplicateGroupsView.tsx - App commands
src/appCommands.ts
Desktop orchestration
- Electron main process
electron/main.js
Media analysis
- Folder scanner
electron/scanner.js - Thumbnail and metadata processor
electron/processor.js
Review state and cache
- Renderer state
src/store.ts - SQLite cache
electron/cache.js - Cache migration
electron/cache-migration.js
Duplicate comparison
- Duplicate detection
electron/duplicates.js - Visual comparison worker
electron/visual-worker.js
Other components
- Video reviewer
- Video folders
- Windows Recycle Bin
- External video player
- HTML report
Connections 26
- Video reviewer → App shell: reviews videos
README.md - App shell → Video grid: renders
src/App.tsx - App shell → Focused player: renders
src/App.tsx - App shell → Search and filters: renders
src/App.tsx - App shell → Settings and export: renders
src/App.tsx - App shell → Duplicate review: renders
src/App.tsx - Video grid → Renderer state: reads and updates
src/components/GridMode.tsx - Focused player → Renderer state: reads and updates
src/components/ReviewMode.tsx - Search and filters → Renderer state: filters and updates
src/components/Sidebar.tsx - Settings and export → Renderer state: updates settings
src/components/SettingsModal.tsx - Duplicate review → Renderer state: reads duplicate state
src/components/DuplicateGroupsView.tsx - App shell → Electron main process: invokes desktop APIs
- App commands → Electron main process: dispatches commands
src/appCommands.ts - Electron main process → Folder scanner: scans directories
electron/main.js - Folder scanner → Video folders: reads video files
README.md - Electron main process → Thumbnail and metadata processor: processes videos
electron/main.js - Thumbnail and metadata processor → Video folders: samples video frames
README.md - Electron main process → SQLite cache: reads and writes state
electron/main.js - Electron main process → Cache migration: runs migration
electron/main.js - SQLite cache → Video folders: persists review and media data
README.md - Electron main process → Duplicate detection: runs duplicate detection
electron/main.js - Duplicate detection → Visual comparison worker: delegates visual comparison
electron/visual-worker.js - Duplicate detection → SQLite cache: uses cached video data
- Settings and export → HTML report: generates report
README.md - Electron main process → Windows Recycle Bin: moves confirmed deletes
README.md - App commands → External video player: opens video
src/appCommands.ts