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.
• ✅ AI Image Analysis – Smart, content-aware image cropping powered by Ultralytics YOLO26 object recognition to keep the most important parts of every photo in view.

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

pipx install Photo-Composition-Designer

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.

  Family vacation at the beach [no-calendar]
  [no-description]

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 🧡.