How rvcgeeks/filenamecluster works
File Name Cluster is a desktop app for turning timestamped files into event folders. The user chooses storage and optional input folders, previews events, adjusts options, then applies clustering or flattens folders; the app scans names and supported metadata, learns event boundaries, and plans file moves. The graph includes the documented timeline/calendar and clash-handling capabilities. Some links reflect README-described behavior because those implementations were not sampled; edges without direct source evidence are omitted.
Main entry points: pipeline.py Clustering pipeline · read.py Container capture-time readers · __main__.py Application startup · previewing.py Preview coordination
Components 22
Desktop interface
- Application startup
filenamecluster/src/filenamecluster/__main__.py - Window and views
filenamecluster/src/filenamecluster/ui/view/view.py - Action controller
filenamecluster/src/filenamecluster/ui/controller/controller.py - Session model
filenamecluster/src/filenamecluster/ui/model/model.py - Preview presentation
filenamecluster/src/filenamecluster/ui/model/display.py - Preview coordination
filenamecluster/src/filenamecluster/ui/controller/previewing.py
Timestamp extraction
- Folder scan and timestamp parse
filenamecluster/src/filenamecluster/core/parser/scan.py - Filename timestamp rules
filenamecluster/src/filenamecluster/core/parser/patterns.py - Container capture-time readers
filenamecluster/src/filenamecluster/core/exif/read.py - Image metadata
filenamecluster/src/filenamecluster/core/exif/image.py - TIFF metadata
filenamecluster/src/filenamecluster/core/exif/tiff.py - Video metadata
filenamecluster/src/filenamecluster/core/exif/video.py - PDF dates
filenamecluster/src/filenamecluster/core/exif/pdf.py
Event clustering
- Clustering pipeline
filenamecluster/src/filenamecluster/core/operations/pipeline.py - Event grouping
filenamecluster/src/filenamecluster/core/algorithm/cluster.py - Gap-pattern fitting
filenamecluster/src/filenamecluster/core/algorithm/fit.py - Boundary decision
filenamecluster/src/filenamecluster/core/algorithm/split.py
Folder organization
- Preview and move planning
filenamecluster/src/filenamecluster/core/operations/preview.py - Saved options and learned model
filenamecluster/src/filenamecluster/core/operations/model.py - Apply and flatten operations
filenamecluster/src/filenamecluster/core/operations/organize.py - File placement
filenamecluster/src/filenamecluster/core/operations/placement.py
Other components
- User
Connections 25
- User → Application startup: starts app
README.md - Application startup → Window and views: builds window
- Application startup → Action controller: composes
- Application startup → Session model: composes
- Action controller → Preview coordination: delegates preview
filenamecluster/src/filenamecluster/ui/controller/controller.py - Preview coordination → Clustering pipeline: runs scan
filenamecluster/src/filenamecluster/ui/controller/previewing.py - Preview coordination → Session model: updates state
filenamecluster/src/filenamecluster/ui/controller/previewing.py - Window and views → Action controller: sends actions
- Session model → Preview presentation: projects preview
filenamecluster/src/filenamecluster/ui/model/model.py - Clustering pipeline → Folder scan and timestamp parse: scans files
filenamecluster/src/filenamecluster/core/operations/pipeline.py - Folder scan and timestamp parse → Filename timestamp rules: parses names
filenamecluster/src/filenamecluster/core/parser/scan.py - Clustering pipeline → Container capture-time readers: reads capture time
filenamecluster/src/filenamecluster/core/operations/pipeline.py - Container capture-time readers → Image metadata: dispatches images
filenamecluster/src/filenamecluster/core/exif/read.py - Container capture-time readers → TIFF metadata: dispatches TIFF
filenamecluster/src/filenamecluster/core/exif/read.py - Container capture-time readers → Video metadata: dispatches video
filenamecluster/src/filenamecluster/core/exif/read.py - Container capture-time readers → PDF dates: dispatches PDFs
filenamecluster/src/filenamecluster/core/exif/read.py - Clustering pipeline → Event grouping: groups timestamps
filenamecluster/src/filenamecluster/core/operations/pipeline.py - Event grouping → Gap-pattern fitting: fits gaps
filenamecluster/src/filenamecluster/core/algorithm/cluster.py - Gap-pattern fitting → Boundary decision: uses boundary
filenamecluster/src/filenamecluster/core/algorithm/fit.py - Clustering pipeline → Saved options and learned model: loads and saves
filenamecluster/src/filenamecluster/core/operations/pipeline.py - Preview coordination → Preview and move planning: prepares preview
filenamecluster/src/filenamecluster/core/operations/preview.py - Preview and move planning → Clustering pipeline: calculates events
filenamecluster/src/filenamecluster/core/operations/preview.py - Preview and move planning → Saved options and learned model: reads options
filenamecluster/src/filenamecluster/core/operations/preview.py - Action controller → Apply and flatten operations: applies or flattens
README.md - Apply and flatten operations → File placement: moves files
README.md