How soulca-prjkt/book-foto-automatico works
Book Foto Automatico is a Windows GUI for turning a folder of photos into a Word catalog. The user selects source and destination folders and a filename; the GUI discovers and naturally sorts supported images, then calls the document generator. That generator lays images out in an A4 grid, adds filenames, reports progress, and saves a .docx file. The generator also uses Pillow to open and orient images, and python-docx to create the document. The README documents the intended catalog features; source excerpts show implementation details, including a hard-coded 5.5 cm image height.
Main entry points: gui.py GUI workflow · word_generator.py Word generator · image_utils.py Image discovery · main.py App entry
Components 9
User interface
- App entry
main.py - GUI workflow
app/gui.py
Image discovery
- Source images
- Image discovery
app/image_utils.py
Document generation
- Word generator
app/word_generator.py - Pillow
- python-docx
- Word document
Other components
- User
Connections 11
- User → App entry: launches
- App entry → GUI workflow: starts
- User → GUI workflow: selects folders
- GUI workflow → Image discovery: finds images
- Image discovery → Source images: reads and sorts
- Image discovery → GUI workflow: returns paths
- GUI workflow → Word generator: generates catalog
- Word generator → Pillow: opens images
- Word generator → python-docx: builds document
- python-docx → Word document: saves .docx
- Word generator → GUI workflow: reports progress