🦖🍼 Automatic (Baby) Photo & Video Organizer - Organize precious moments chronologically with intelligent automation.
MomentKeeper automatically organizes baby photos and videos into monthly folders based on birth date and timestamps extracted from filenames. Transform thousands of media files from chaos to chronological perfection in minutes.
| Simulation Preview | Analytics Dashboard | Insights |
|---|---|---|
 |
 |
 |
| Preview organization before moving files | Track your photo habits with detailed metrics | Discover patterns in your photo collection |
Want to try MomentKeeper without your own photos? Check out our demo setup guide for a ready-to-use test environment with sample photos.
- Smart Organization: Automatically sorts photos and videos into monthly folders (0-1months, 1-2months, etc.)
- Media Support: Handles photos (.jpg, .jpeg, .png, .heic, .webp) and videos (.mp4, .mov, .avi, .mkv, .m4v, .3gp, .wmv)
- Date Intelligence: Extracts dates from filename patterns (
YYYYMMDD_description.jpg) - Multilingual Interface: Available in French and English with persistent language preference
- Analytics Dashboard: Track your photo habits with insights and visualizations
- Gallery View: Browse organized photos with multiple viewing modes (random, chronological, highlights, timeline)
- Baby's Name Personalization: Add your baby's name for personalized messages and insights
- Configuration Persistence: Settings are saved automatically and restored on next launch
- Safe Operation: Simulation mode before actual organization
- Reset Capability: Undo organization if needed
- Error Handling: Robust handling of invalid dates and file formats
- Interactive Folder Selection: Browse and select folders with native dialogs
OrganisateurPhotos: Main organization logic with calendar-accurate age calculationPhotoCopier: Safe file operations with move/copy capabilitiesAnalytics: Photo statistics, insights generation, and visualizationsConfig: Centralized configuration managementConfigManager: Persistent configuration storage in JSON formatTheme: UI styling and color paletteTranslations: Multilingual support (FR/EN)
- Configuration: Set root folder, photos subfolder, and baby's birth date
- Simulation: Preview organization without moving files
- Confirmation: User validates the plan
- Organization: Execute the actual file organization
- Reset: Optional rollback capability
project-folder/ (root directory)
└── photos/ (subfolder with photos to organize)
├── 20240315_first_smile.jpg
├── 20240420_crawling.jpg
├── 20240515_sitting_up.jpg
└── ...
project-folder/ (root directory)
├── photos/ (original photos subfolder)
├── 0-1months/ (organized by age - created in root)
│ └── 20240315_first_smile.jpg
├── 1-2months/
│ └── 20240420_crawling.jpg
├── 2-3months/
│ └── 20240515_sitting_up.jpg
└── ...
# Windows
python -m venv venv
venv\Scripts\Activate.ps1
# Linux/MacOS
python -m venv venv
source venv/bin/activate# Install dependencies
pip install -r requirements.txt
# Run the Streamlit web interface
streamlit run app.py- Simulation First: Always preview before acting
- File Validation: Check file existence and format
- Calendar-Accurate Age Calculation: Proper month-based age calculation
- Error Recovery: Graceful handling of edge cases and file conflicts
- Rollback Capability: Complete reset to original state
- New Parents: Organize growing photo collections
- Family Archives: Sort historical baby photos
- Photo Enthusiasts: Maintain chronological photo libraries
- Memory Keeping: Create timeline-based photo albums
- High Speed: Processes ~750,000 photos per minute
- Low Memory: < 35MB RAM usage for 10,000+ files
- Scalable: Tested efficiently from 100 to 10,000+ photos
- Cross-Platform: Verified on Windows 11, Python 3.13
- ✅
20240315_photo.jpg- Standard format - ✅
20240315_long_description.jpg- With description - ✅
20240315_été_vacances.jpg- Special characters - ❌
2024-03-15_photo.jpg- Hyphens not supported - ❌
photo_20240315.jpg- Date must be at start
- All formats: Successfully tested up to 1GB per file
- Path compatibility: Supports spaces and special characters in folder names
- Memory efficient: Linear scaling with collection size
- Filename pattern must include
YYYYMMDD_descriptionformat - Date extraction from filenames only (EXIF support planned for v2.0)
- Requires Python 3.9+ and dependencies listed in requirements.txt
💡 Benchmark results based on real testing with the included benchmark scripts in
/scripts/
# Install development dependencies
pip install -r requirements-dev.txt
# Install pre-commit hooks (recommended)
pre-commit install
# Run code formatting manually
black src tests
isort src tests
# Run linting manually
ruff check src tests
# Run all pre-commit hooks manually
pre-commit run --all-files
# Run tests (when implemented)
pytestmoment-keeper/
├── src/moment_keeper/ # Main package
│ ├── organizer.py # Core organization logic
│ ├── photo_copier.py # File operations
│ ├── analytics.py # Statistics and insights
│ ├── config.py # Configuration constants
│ ├── config_manager.py # Persistent configuration
│ ├── theme.py # UI theming
│ └── translations.py # i18n support
├── app.py # Streamlit web interface
├── notebooks/ # Jupyter notebooks
├── tests/ # Unit tests
└── requirements*.txt # Dependencies
We welcome contributions! Please see our Contributing Guide for details on:
- Development setup
- Code style and quality standards
- Submitting pull requests
- Running tests
This project is licensed under the Apache License 2.0 - see LICENSE for details.
If you use MomentKeeper in your project, a mention would be appreciated! 🦖
- Inspired by the chaos of 10,000 unsorted baby photos
- T-Rex mascot because parenting is like having a tiny dinosaur 🦖
Built with ❤️ for preserving precious family moments