Welcome to Photo-Composition-Designer#

Photo-Composition-Designer is a tool designed to automate the creation of beautiful image-based calendars. The system sorts images, generates collages, adds descriptions and maps, and formats everything into a structured calendar layout.

🛠️ Features#

• ✅ Automated Calendar Generation – Generates a full image-based calendar.
• ✅ Configurable Settings – Modify sizes, layouts, and text via config.yaml.
• ✅ Anniversaries & Events – Load anniversaries and special dates using anniversaries.ini.
• ✅ Location-Based Maps – Integrate maps showing image locations using gps meta-data or image names and locations.ini.
• ✅ GUI Configuration Tool – Easily modify configurations via a dynamic UI.
• ✅ Folder Management – Automatically structures and organizes images into necessary folders.

Installation via executable:#

Download the latest executable:

• ⬇️ Download for Windows
• ⬇️ Download for Linux
• ⬇️ Download for macOS

Installation via pypi#

Get an impression of how your own project could be installed and look like.

Download from PyPI.

💾 For more installation options see install.

pip install Photo-Composition-Designer

or

pipx install Photo-Composition-Designer

Run GUI from command line

Photo-Composition-Designer-gui

🔄 Workflow#

1️⃣ Configuring the parameters#

You can adjust the result by setting up your own parameters like size, margins and colors. For more details, see Configuration Parameters. Modify your settings inside the config.yaml or using the GUI: - Image sizes (mm converted to pixels internally) - Calendar layout - Paths to anniversaries.ini and locations.ini - Fonts and Colors

2️⃣ Sorting Images into Folders#

Organize your images in the images/ directory before running the generator. You can use one of the distribution methods to distribute your plain images inside this directory into sub-folders that represent your weekly collage content.

📁 images/
├── 📁 title/
│   └── 🖼️ title_image.jpg
├── 📁 week_1/
│   ├── 🖼️ valentines_dinner_in_London.jpg
│   └── 🖼️ ski_trip.jpg
├── 📁 week_2/
│   ├── 🖼️ new_year_hike.jpg
│   ├── 🖼️ cooking_class.jpg
│   ├── 🖼️ first_snowfall.jpg
│   └── ...
└── 📄 descriptions.txt

3️⃣ Provide Descriptions 🖥️#

Provide descriptions for every week to describe the events.

You can use one single description.txt file that can be generated using the GUI or you can put individual txt files into every single weekly sub folder.

4️⃣ Setting up the birthday dates 🎂📅#

Provide the birthday information of your friends and family by using the anniversaries.ini

[Birthdays]

Paul = 6.1.1984
Peter = 08.01.99
Liz = 09.01.
Anna = 10.01.

[Weddings]
Mary & Josh = 02.01.2021    ; ⚭ Symbol is used for Weddings

5️⃣ Generating the Calendar 🖼️#

Use Generate Composition to generate all collages and one PDF file containing all your compositions.

6️⃣ Printing the Calendar 🖨️#

Send the generated PDF to your printer or local print shop for high-quality printing.

A very good print shop for Germany is WIRmachenDRUCK .

If you find this app helpful, Funding is highly appreciated 🧡.