Skip to main content

Feature-rich Python project template for Photo-Composition-Designer.

Project description

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.

Github CI Status GitHub release Read the Docs License GitHub issues PyPI Downloads

🛠️ 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.

Main GUI


Installation via executable:

Download the latest executable:

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

Run GUI from command line

Photo-Composition-Designer

🔄 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

Settings GUI

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/
├── 📁 0-Title/
    ├── 2024-01-01_ski_trip.jpg
├── 📁 Week 1/
    ├── 2024-02-14_valentines_dinner in London.jpg

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

Generating the Calendar 🖼️

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


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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

photo_composition_designer-0.1.3.tar.gz (4.1 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

photo_composition_designer-0.1.3-py3-none-any.whl (47.6 kB view details)

Uploaded Python 3

File details

Details for the file photo_composition_designer-0.1.3.tar.gz.

File metadata

File hashes

Hashes for photo_composition_designer-0.1.3.tar.gz
Algorithm Hash digest
SHA256 8c8343a264f541a49933577ee56e4ea3d1ed43d677a9e53d946de54286b71e33
MD5 dcbd16933b8e53843f280c44be05cf0b
BLAKE2b-256 772408537c060057daf49fd3e02a371de20be22c4e52e6896bda69bfd2bff28c

See more details on using hashes here.

File details

Details for the file photo_composition_designer-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for photo_composition_designer-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 48c5f8524ba13bcb29ad6380d99fa82ffb2576eee7261e830c355115293c22f7
MD5 d7fd146d5321ec552b2bf0bfcfb45955
BLAKE2b-256 f6430a02c0d0a5536ef809d8471070e4b3bbc9e31fca6dfc07701f13d7661859

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page