Photo-Composition-Designer 1.0.5__tar.gz → 1.0.7__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (183) hide show
  1. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/build-linux.yml +2 -2
  2. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/build-macos.yml +2 -2
  3. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/build-win.yml +2 -2
  4. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/main.yml +3 -3
  5. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/release.yml +3 -3
  6. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/workflows/update_readme.yml +2 -2
  7. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.gitignore +77 -0
  8. photo_composition_designer-1.0.7/AGENTS.md +94 -0
  9. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/HISTORY.md +77 -0
  10. {photo_composition_designer-1.0.5/src/Photo_Composition_Designer.egg-info → photo_composition_designer-1.0.7}/PKG-INFO +39 -4
  11. photo_composition_designer-1.0.5/docs/index.md → photo_composition_designer-1.0.7/README.md +44 -7
  12. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/config.yaml +2 -0
  13. photo_composition_designer-1.0.7/docs/_static/img/gui_main.png +0 -0
  14. photo_composition_designer-1.0.7/docs/_static/img/gui_settings.png +0 -0
  15. photo_composition_designer-1.0.5/README.md → photo_composition_designer-1.0.7/docs/index.md +38 -5
  16. photo_composition_designer-1.0.7/docs/usage/cli.md +60 -0
  17. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/usage/config.md +8 -7
  18. photo_composition_designer-1.0.7/images/descriptions.txt +9 -0
  19. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/scripts/update_readme.py +4 -2
  20. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/_version.py +3 -3
  21. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/__init__.py +40 -0
  22. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_designer_factory.py +60 -0
  23. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/composition_workflow.py +124 -0
  24. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/application/photo_distribution_workflow.py +74 -0
  25. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/cli.py +4 -4
  26. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/config.py +7 -0
  27. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/base.py +229 -0
  28. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_builder.py +139 -0
  29. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_io.py +127 -0
  30. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_layout.py +73 -0
  31. photo_composition_designer-1.0.7/src/Photo_Composition_Designer/core/composition_renderer.py +171 -0
  32. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/gui.py +44 -129
  33. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CalendarRenderer.py +219 -76
  34. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/CollageRenderer.py +5 -1
  35. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/DescriptionRenderer.py +2 -2
  36. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info}/PKG-INFO +39 -4
  37. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/SOURCES.txt +13 -3
  38. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/scm_file_list.json +134 -124
  39. photo_composition_designer-1.0.7/src/Photo_Composition_Designer.egg-info/scm_version.json +8 -0
  40. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_CalendarRenderer.py +25 -2
  41. photo_composition_designer-1.0.7/tests/test_CompositionDesigner.py +259 -0
  42. photo_composition_designer-1.0.7/tests/test_application_workflows.py +274 -0
  43. photo_composition_designer-1.0.7/tests/test_cli.py +44 -0
  44. photo_composition_designer-1.0.7/tests/test_composition_components.py +141 -0
  45. photo_composition_designer-1.0.5/AGENTS.md +0 -94
  46. photo_composition_designer-1.0.5/docs/_static/img/gui_main.png +0 -0
  47. photo_composition_designer-1.0.5/docs/_static/img/gui_settings.png +0 -0
  48. photo_composition_designer-1.0.5/docs/usage/cli.md +0 -59
  49. photo_composition_designer-1.0.5/images/descriptions.txt +0 -9
  50. photo_composition_designer-1.0.5/src/Photo_Composition_Designer/core/base.py +0 -373
  51. photo_composition_designer-1.0.5/src/Photo_Composition_Designer.egg-info/scm_version.json +0 -8
  52. photo_composition_designer-1.0.5/tests/test_CompositionDesigner.py +0 -33
  53. photo_composition_designer-1.0.5/tests/test_cli.py +0 -49
  54. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/FUNDING.yml +0 -0
  55. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/bug_report.md +0 -0
  56. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/ISSUE_TEMPLATE/feature_request.md +0 -0
  57. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/PULL_REQUEST_TEMPLATE.md +0 -0
  58. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/actions/setup-environment/action.yml +0 -0
  59. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/dependabot.yml +0 -0
  60. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/init.sh +0 -0
  61. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/release_message.sh +0 -0
  62. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/rename_project.sh +0 -0
  63. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.github/update_funding.py +0 -0
  64. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.idea/runConfigurations/config_generate.xml +0 -0
  65. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_cli.xml +0 -0
  66. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.idea/runConfigurations/module_gui.xml +0 -0
  67. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.idea/vcs.xml +0 -0
  68. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.pre-commit-config-linux.yaml +0 -0
  69. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.pre-commit-config.yaml +0 -0
  70. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/.readthedocs.yaml +0 -0
  71. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/LICENSE +0 -0
  72. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/Makefile +0 -0
  73. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/anniversaries.ini +0 -0
  74. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/.nav.yml +0 -0
  75. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/_static/img/collages.png +0 -0
  76. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/_static/img/favicon.png +0 -0
  77. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/_static/img/logo.png +0 -0
  78. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/css/custom.css +0 -0
  79. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/funding/funding.md +0 -0
  80. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/getting-started/install.md +0 -0
  81. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/docs/getting-started/virtual-environment.md +0 -0
  82. /photo_composition_designer-1.0.5/images/title/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt → /photo_composition_designer-1.0.7/images/title/This is a description for this calender collage page.txt +0 -0
  83. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/title/image_02.jpg +0 -0
  84. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_1/description.txt +0 -0
  85. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_1/image_01.jpg +0 -0
  86. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_2/image_04.jpg +0 -0
  87. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_2/image_13.jpg +0 -0
  88. /photo_composition_designer-1.0.5/images/week_3/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt → /photo_composition_designer-1.0.7/images/week_3/This is a description for this calender collage page.txt +0 -0
  89. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_3/image_02.jpg +0 -0
  90. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_3/image_03.jpg +0 -0
  91. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_3/image_07.jpg +0 -0
  92. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_4/image_08.jpg +0 -0
  93. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_4/image_09.jpg +0 -0
  94. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_4/image_10.jpg +0 -0
  95. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_4/image_13.jpg +0 -0
  96. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_5/Lisbon.jpg +0 -0
  97. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_5/image_05.jpg +0 -0
  98. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_5/image_06.jpg +0 -0
  99. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_5/image_07.jpg +0 -0
  100. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_5/image_13.jpg +0 -0
  101. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/bundschatten-sheep-7039994_1920.jpg +0 -0
  102. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/falkenpost-cars-1638594_1920.jpg +0 -0
  103. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_6_testimages_3/valdemarvan2003-vietnam-8121062_1920.jpg +0 -0
  104. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/fietzfotos-london-2928889_1920.jpg +0 -0
  105. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/piper60-spanish-84795_1920.jpg +0 -0
  106. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/sippakorn-cows-4708901_1920.jpg +0 -0
  107. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_7_testimages_4/tuananhngo-street-vendor-4176310_1920.jpg +0 -0
  108. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_one_bicycle_left.jpg +0 -0
  109. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/landscape_two_persons_right.jpg +0 -0
  110. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_one_person_top.jpg +0 -0
  111. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_cars_bottom.jpg +0 -0
  112. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/images/week_8_testimages_5/portrait_two_persons_bottom.jpg +0 -0
  113. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/locations_de.ini +0 -0
  114. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/locations_en.ini +0 -0
  115. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/mkdocs.yml +0 -0
  116. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/pyproject.toml +0 -0
  117. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/pytest.ini +0 -0
  118. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.README.html +0 -0
  119. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.VERSION.txt +0 -0
  120. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.cpg +0 -0
  121. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.dbf +0 -0
  122. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.prj +0 -0
  123. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shp +0 -0
  124. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shx +0 -0
  125. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.README.html +0 -0
  126. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.VERSION.txt +0 -0
  127. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.cpg +0 -0
  128. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.dbf +0 -0
  129. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.prj +0 -0
  130. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shp +0 -0
  131. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shx +0 -0
  132. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/res/yolo/yolo26n.onnx +0 -0
  133. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/scripts/generate_config_docs.py +0 -0
  134. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/scripts/project_structure.py +0 -0
  135. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/scripts/show_filelist.py +0 -0
  136. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/setup.cfg +0 -0
  137. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__init__.py +0 -0
  138. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/__main__.py +0 -0
  139. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__init__.py +0 -0
  140. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/cli/__main__.py +0 -0
  141. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Anniversaries.py +0 -0
  142. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Locations.py +0 -0
  143. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/MoonPhase.py +0 -0
  144. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/Photo.py +0 -0
  145. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/common/__init__.py +0 -0
  146. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/config/__init__.py +0 -0
  147. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/core/__init__.py +0 -0
  148. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/GuiLogWriter.py +0 -0
  149. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__init__.py +0 -0
  150. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/gui/__main__.py +0 -0
  151. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/MapRenderer.py +0 -0
  152. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/ObjectDetector.py +0 -0
  153. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/SmartCrop.py +0 -0
  154. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/image/__init__.py +0 -0
  155. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/DescriptionsFileGenerator.py +0 -0
  156. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/GeoPlotter.py +0 -0
  157. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/Helpers.py +0 -0
  158. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/ImageDistributor.py +0 -0
  159. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer/tools/__init__.py +0 -0
  160. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/dependency_links.txt +0 -0
  161. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/entry_points.txt +0 -0
  162. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/requires.txt +0 -0
  163. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/Photo_Composition_Designer.egg-info/top_level.txt +0 -0
  164. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/__init__.py +0 -0
  165. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/firewall_handler.py +0 -0
  166. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/main.py +0 -0
  167. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/src/path_handler.py +0 -0
  168. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/template.yml.url +0 -0
  169. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/TestHelper.py +0 -0
  170. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/__init__.py +0 -0
  171. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_CollageRenderer.py +0 -0
  172. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_DescriptionRenderer.py +0 -0
  173. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_DescriptionsFileGenerator.py +0 -0
  174. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_GeoPlotter.py +0 -0
  175. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_ImageDistributor.py +0 -0
  176. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_Locations.py +0 -0
  177. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_MapRenderer.py +0 -0
  178. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_MoonPhase.py +0 -0
  179. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_ObjectDetector.py +0 -0
  180. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_Photo.py +0 -0
  181. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_SmartCrop.py +0 -0
  182. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/tests/test_anniversaries.py +0 -0
  183. {photo_composition_designer-1.0.5 → photo_composition_designer-1.0.7}/uv.lock +0 -0
@@ -17,10 +17,10 @@ jobs:
17
17
 
18
18
  steps:
19
19
  - name: Checkout repository
20
- uses: actions/checkout@v4
20
+ uses: actions/checkout@v6
21
21
 
22
22
  - name: Set up Python
23
- uses: actions/setup-python@v5
23
+ uses: actions/setup-python@v6
24
24
  with:
25
25
  python-version: ${{ matrix.python-version }}
26
26
 
@@ -17,10 +17,10 @@ jobs:
17
17
 
18
18
  steps:
19
19
  - name: Checkout repository
20
- uses: actions/checkout@v4
20
+ uses: actions/checkout@v6
21
21
 
22
22
  - name: Set up Python
23
- uses: actions/setup-python@v5
23
+ uses: actions/setup-python@v6
24
24
  with:
25
25
  python-version: '3.11'
26
26
 
@@ -16,10 +16,10 @@ jobs:
16
16
  runs-on: ${{ matrix.os }}
17
17
  steps:
18
18
  - name: Checkout repository
19
- uses: actions/checkout@v4
19
+ uses: actions/checkout@v6
20
20
 
21
21
  - name: Set up Python
22
- uses: actions/setup-python@v5
22
+ uses: actions/setup-python@v6
23
23
  with:
24
24
  python-version: '3.11'
25
25
 
@@ -22,7 +22,7 @@ jobs:
22
22
  os: [ubuntu-latest]
23
23
  runs-on: ${{ matrix.os }}
24
24
  steps:
25
- - uses: actions/checkout@v4
25
+ - uses: actions/checkout@v6
26
26
  - uses: actions/setup-python@v5
27
27
  with:
28
28
  python-version: ${{ matrix.python-version }}
@@ -44,7 +44,7 @@ jobs:
44
44
  os: [windows-latest]
45
45
  runs-on: ${{ matrix.os }}
46
46
  steps:
47
- - uses: actions/checkout@v4
47
+ - uses: actions/checkout@v6
48
48
  - uses: actions/setup-python@v5
49
49
  with:
50
50
  python-version: ${{ matrix.python-version }}
@@ -66,7 +66,7 @@ jobs:
66
66
  os: [ ubuntu-latest, macos-latest ]
67
67
  runs-on: ${{ matrix.os }}
68
68
  steps:
69
- - uses: actions/checkout@v4
69
+ - uses: actions/checkout@v6
70
70
  - uses: actions/setup-python@v5
71
71
  with:
72
72
  python-version: ${{ matrix.python-version }}
@@ -21,7 +21,7 @@ jobs:
21
21
  permissions:
22
22
  contents: write
23
23
  steps:
24
- - uses: actions/checkout@v4
24
+ - uses: actions/checkout@v6
25
25
  with:
26
26
  # by default, it uses a depth of 1
27
27
  # this fetches all history so that we can read each commit
@@ -37,9 +37,9 @@ jobs:
37
37
  needs: release
38
38
  runs-on: ubuntu-latest
39
39
  steps:
40
- - uses: actions/checkout@v4
40
+ - uses: actions/checkout@v6
41
41
  - name: Set up Python
42
- uses: actions/setup-python@v4
42
+ uses: actions/setup-python@v6
43
43
  with:
44
44
  # Use a specific Python version, e.g., 3.11, consistent with your build
45
45
  python-version: '3.11'
@@ -12,9 +12,9 @@ jobs:
12
12
  sync:
13
13
  runs-on: ubuntu-latest
14
14
  steps:
15
- - uses: actions/checkout@v4
15
+ - uses: actions/checkout@v6
16
16
  - name: Set up Python
17
- uses: actions/setup-python@v5
17
+ uses: actions/setup-python@v6
18
18
  with:
19
19
  python-version: "3.11"
20
20
  - name: Update README.md
@@ -203,3 +203,80 @@ cython_debug/
203
203
  /release/Photo-Composition-Designer.exe
204
204
  /release/README.md
205
205
  /temp/*
206
+ /collages/output.pdf
207
+ /collages/title.jpg
208
+ /collages/week_1.jpg
209
+ /collages/week_2.jpg
210
+ /collages/week_3.jpg
211
+ /collages/week_4.jpg
212
+ /collages/week_5.jpg
213
+ /collages/week_6_testimages_3.jpg
214
+ /collages/week_7_testimages_4.jpg
215
+ /collages/week_8_testimages_5.jpg
216
+ /.codebase-memory/.gitattributes
217
+ /.codebase-memory/artifact.json
218
+ /.codebase-memory/graph.db.zst
219
+ /logs/config_cli_gui.log.1
220
+ /logs/config_cli_gui.log.2
221
+ /logs/config_cli_gui.log.3
222
+ /logs/config_cli_gui.log.4
223
+ /release/collages/collage_title.jpg
224
+ /release/collages/collage_week_1.jpg
225
+ /release/collages/collage_week_2.jpg
226
+ /release/collages/collage_week_3.jpg
227
+ /release/collages/collage_week_4.jpg
228
+ /release/collages/collage_week_5.jpg
229
+ /release/collages/output.pdf
230
+ /release/docs/_static/img/favicon.png
231
+ /release/docs/_static/img/logo.png
232
+ /release/docs/css/custom.css
233
+ /release/docs/develop/contributing.md
234
+ /release/docs/develop/make_windows.md
235
+ /release/docs/develop/naming_convention.md
236
+ /release/docs/develop/pypi_release.md
237
+ /release/docs/funding/funding.md
238
+ /release/docs/getting-started/install.md
239
+ /release/docs/getting-started/virtual-environment.md
240
+ /release/docs/usage/cli.md
241
+ /release/docs/usage/config.md
242
+ /release/docs/.nav.yml
243
+ /release/docs/index.md
244
+ /release/images/title/image_02.jpg
245
+ /release/images/title/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt
246
+ /release/images/week_1/description.txt
247
+ /release/images/week_1/image_01.jpg
248
+ /release/images/week_2/image_04.jpg
249
+ /release/images/week_2/image_13.jpg
250
+ /release/images/week_3/image_02.jpg
251
+ /release/images/week_3/image_03.jpg
252
+ /release/images/week_3/image_07.jpg
253
+ /release/images/week_3/This is a description for all photos of this calender collage page. It will be displayed in one line between the photos and the calendar items..txt
254
+ /release/images/week_4/image_08.jpg
255
+ /release/images/week_4/image_09.jpg
256
+ /release/images/week_4/image_10.jpg
257
+ /release/images/week_4/image_13.jpg
258
+ /release/images/week_5/image_05.jpg
259
+ /release/images/week_5/image_06.jpg
260
+ /release/images/week_5/image_07.jpg
261
+ /release/images/week_5/image_13.jpg
262
+ /release/images/week_5/Lisbon.jpg
263
+ /release/images/descriptions.txt
264
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.cpg
265
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.dbf
266
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.prj
267
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.README.html
268
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shp
269
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.shx
270
+ /release/res/maps/ne_50m_admin_0_countries/ne_50m_admin_0_countries.VERSION.txt
271
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.cpg
272
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.dbf
273
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.prj
274
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.README.html
275
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shp
276
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.shx
277
+ /release/res/maps/ne_50m_rivers_lake_centerlines_scale_rank/ne_50m_rivers_lake_centerlines_scale_rank.VERSION.txt
278
+ /release/anniversaries.ini
279
+ /release/locations_de.ini
280
+ /release/locations_en.ini
281
+ /release/Photo-Composition-Designer
282
+ /tests/logs/
@@ -0,0 +1,94 @@
1
+ # AGENTS.md
2
+
3
+ ## Core Principles
4
+
5
+ - **Think before coding.** Identify the goal, assumptions, constraints, and success criteria before implementation. If ambiguity materially affects the solution, ask before proceeding. Point out simpler alternatives and relevant trade-offs.
6
+ - **Simplicity first.** Implement the simplest solution that fully meets the requirements. Avoid speculative features, unnecessary abstractions, premature optimization, and unrequested configurability.
7
+ - **Surgical changes.** Modify only what the task requires. Preserve existing conventions and avoid unrelated refactoring. Remove only dead code made obsolete by your changes; report unrelated issues without fixing them.
8
+ - **Correctness over cleverness.** Prioritize clarity, maintainability, reliability, and measurable performance. Optimize algorithms, memory usage, and runtime where justified by actual requirements. Use vectorization or parallelization when beneficial.
9
+
10
+ ## Workflow
11
+
12
+ 1. **Inspect** the relevant code, project structure, configuration, dependencies, and existing tests before making changes.
13
+ 2. **Plan** briefly for nontrivial tasks. Define concrete, verifiable success criteria.
14
+ 3. **Implement** the smallest complete solution, following existing project conventions.
15
+ 4. **Verify** changes with relevant tests, formatting, linting, and type checking. Fix issues introduced by the changes.
16
+ 5. **Report** what changed, which checks passed, and any remaining limitations.
17
+
18
+ Do not claim that checks passed unless they were actually executed. If verification is impossible, explain why.
19
+
20
+ ## Python Code Quality
21
+
22
+ - Follow PEP 8 and the existing project style. Use 4 spaces for indentation and keep lines within 100 characters where practical.
23
+ - Use descriptive names, `snake_case` for functions and variables, `PascalCase` for classes, and `UPPER_CASE` for constants.
24
+ - Add type hints to all function signatures. Avoid `Any` unless genuinely necessary.
25
+ - Write docstrings for public functions, classes, and methods. Document parameters, return values, and raised exceptions where relevant.
26
+ - Prefer small, focused functions and classes with clear responsibilities. Limit function parameters to five where practical; use early returns to reduce nesting.
27
+ - Never use mutable default arguments. Use `is` for comparisons with `None`, `True`, and `False`.
28
+ - Prefer f-strings, context managers, and explicit imports. Avoid wildcard imports and redundant comments.
29
+ - Handle errors explicitly. Catch specific exceptions, provide meaningful context, and never silently suppress unexpected failures.
30
+ - Use dataclasses for simple data containers and composition over inheritance where appropriate.
31
+ - Never use emoji or emoji-like Unicode characters in code, comments, or documentation unless explicitly required for tests or functionality.
32
+
33
+ ## Dependencies and Tooling
34
+
35
+ - Use `uv` for dependency management and virtual environments when available or when initializing a project.
36
+ - Declare and manage dependencies in `pyproject.toml`. Avoid unnecessary dependencies and preserve existing project tooling.
37
+ - Prefer established project commands and configuration over introducing new tools or conventions.
38
+ - Use `ruff` for formatting and linting and `mypy` for static type checking when configured or appropriate.
39
+ - Use `pytest` for tests. Add or update tests for new behavior, bug fixes, and meaningful edge cases. Mock external dependencies where appropriate.
40
+ - Never introduce tooling or dependencies solely for marginal benefits.
41
+
42
+ ## Testing and Delivery
43
+
44
+ Before completing a task, run the relevant checks available in the repository. Prefer existing commands, such as:
45
+
46
+ ```bash
47
+ make fmt
48
+ make lint
49
+ make test
50
+ ```
51
+
52
+ These documentation artifacts are generated by the command
53
+
54
+ ```bash
55
+ make syncdocs
56
+ ```
57
+
58
+ which triggers
59
+ ```bash
60
+ @uv run ./scripts/generate_config_docs.py
61
+ @uv run ./scripts/update_readme.py
62
+ @uv run ./.github/update_funding.py
63
+ ```
64
+
65
+ ```text
66
+ Generated: config.yaml
67
+ Generated: docs/usage/config.md
68
+ Generated: docs/usage/cli.md
69
+ Generated: README.md updated from docs/index.md
70
+ Generated: docs/funding/funding.md
71
+ ```
72
+
73
+ Never edit these artifacts directly. If you want e.g. the CLI.md or config.yaml/md
74
+ you have to adjust the **ConfigCategory** Classes that are passed into the **ConfigManager** class
75
+ and then run `make syncdocs`
76
+
77
+ Run only commands that exist and are appropriate for the task. Check the project configuration for additional requirements, including type checking.
78
+
79
+ - Test bug fixes with regression tests whenever practical.
80
+ - Test boundary conditions and failure cases where relevant.
81
+ - Keep tests deterministic and independent of external services unless integration testing explicitly requires them.
82
+ - Use mock only if really required. Implement "Tests with Teeth"
83
+ - Do not weaken or remove tests merely to make them pass.
84
+
85
+ ## Decision Rules
86
+
87
+ - Do not assume when uncertainty matters. State assumptions and ask concise clarifying questions when necessary.
88
+ - Do not add features, abstractions, error handling, or configuration without a concrete need.
89
+ - Do not refactor unrelated code or reformat entire files unnecessarily.
90
+ - When multiple solutions are viable, prefer the simplest maintainable option that fits the existing architecture.
91
+ - If requirements conflict with existing behavior, security, correctness, or maintainability, explain the conflict before making consequential changes.
92
+ - Treat repository instructions and established project conventions as authoritative unless they conflict with explicit user requirements or higher-priority instructions.
93
+
94
+ **Guiding principle:** Make the smallest correct change, keep the code maintainable, and verify the result.
@@ -4,6 +4,83 @@ Changelog
4
4
 
5
5
  (unreleased)
6
6
  ------------
7
+ - Update AGENTS.md. [Paul Magister]
8
+ - Vibe-coding session: [Paul Magister]
9
+
10
+ CompositionDesigner verwendet jetzt den CompositionFileOperations-Vertrag. Die Application-Factory bündelt den Aufbau der Datei- und Renderer-Kollaboratoren und injiziert sie; direkte Konstruktion bleibt als Kompatibilitätspfad erhalten. Echte Integrationstests rendern temporäre Fotos und prüfen JPEG- und PDF-Ausgaben. Außerdem löscht der CLI-Test keine projektweiten Collagen mehr.
11
+ - Vibe-coding session: [Paul Magister]
12
+
13
+ Die erste große Verbesserung ist umgesetzt: CLI und GUI erstellen Composition-Workflows jetzt über einen gemeinsamen CompositionApplicationFactory. Auch Vorschauen verwenden dieselbe Designer-Factory; sie nutzen die Seitengröße des bestehenden Designers, statt dafür einen zusätzlichen Designer zu erzeugen. Die GUI greift für Verzeichnisse und Cache-Steuerung über den Workflow zu. Fortschritt wird typisiert beim Erzeugen übergeben; leere Verarbeitungsläufe lösen keinen GUI-Fehler mehr aus.
14
+ - Vibe-coding session: [Paul Magister]
15
+
16
+ Die Renderer-Abhängigkeiten werden jetzt im neuen CompositionRendererBuilder aufgebaut und als typisierte CompositionRenderComponents an CompositionDesigner übergeben. Bestehende Aufrufe bleiben kompatibel; Tests können die Komponenten gezielt injizieren. In TODO.md habe ich den bereits vorhandenen Schnitt als erledigt markiert, die nächsten Architekturthemen priorisiert und „tests with teeth“ ergänzt.
17
+ - Vibe-coding session: [Paul Magister]
18
+
19
+ CompositionDesigner ist jetzt in fokussierte Komponenten aufgeteilt: CompositionLayout berechnet Maße und Beschreibungsoptionen, CompositionPageRenderer rendert die Seite und CompositionIO übernimmt Fotoeingabe sowie Bild-/PDF-Ausgabe. Die Designer-Klasse koordiniert diese Aufgaben weiter; bei der Stapelverarbeitung werden Fotoordner nur noch einmal aufgelistet.
20
+ - Vibe-coding session: [Paul Magister]
21
+
22
+ Die erste Architekturverbesserung ist umgesetzt: MainGui delegiert Kompositionsmodi, Vorschau-Erstellung und Fotoverteilung jetzt an UI-unabhängige Dienste im neuen Paket src/Photo_Composition_Designer/application/. Tkinter, Hintergrundthreads und Fortschrittsanzeige bleiben in der GUI; das bisherige Verhalten der Abläufe bleibt erhalten.
23
+ - Fix text color: Only red text if holiday. [Paul Magister]
24
+ - #5 vertical calendar: first approach. [Paul Magister]
25
+ - #5 vertical calendar: first approach. [Paul Magister]
26
+ - Add tests for new flag feature. [Paul Magister]
27
+ - Merge pull request #2 from
28
+ pamagister/dependabot/github_actions/actions/setup-python-6. [Paul
29
+ Magister]
30
+
31
+ Bump actions/setup-python from 4 to 6
32
+ - Merge branch 'main' into dependabot/github_actions/actions/setup-
33
+ python-6. [Paul Magister]
34
+ - Bump actions/setup-python from 4 to 6. [dependabot[bot]]
35
+
36
+ Bumps [actions/setup-python](https://github.com/actions/setup-python) from 4 to 6.
37
+ - [Release notes](https://github.com/actions/setup-python/releases)
38
+ - [Commits](https://github.com/actions/setup-python/compare/v4...v6)
39
+
40
+ ---
41
+ updated-dependencies:
42
+ - dependency-name: actions/setup-python
43
+ dependency-version: '6'
44
+ dependency-type: direct:production
45
+ update-type: version-update:semver-major
46
+ ...
47
+ - #4 fix filename length. [Paul Magister]
48
+ - Introduce flags in description: - `[no-calendar]` — prevents a
49
+ calendar from being generated for this photo. - `[no-description]` —
50
+ suppresses the generated photo description. [Paul Magister]
51
+ - Merge pull request #3 from
52
+ pamagister/dependabot/github_actions/actions/checkout-6. [Paul
53
+ Magister]
54
+
55
+ Bump actions/checkout from 4 to 6
56
+ - Bump actions/checkout from 4 to 6. [dependabot[bot]]
57
+
58
+ Bumps [actions/checkout](https://github.com/actions/checkout) from 4 to 6.
59
+ - [Release notes](https://github.com/actions/checkout/releases)
60
+ - [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
61
+ - [Commits](https://github.com/actions/checkout/compare/v4...v6)
62
+
63
+ ---
64
+ updated-dependencies:
65
+ - dependency-name: actions/checkout
66
+ dependency-version: '6'
67
+ dependency-type: direct:production
68
+ update-type: version-update:semver-major
69
+ ...
70
+
71
+
72
+ 1.0.6 (2026-06-25)
73
+ ------------------
74
+ - Docs: Update HISTORY.md for release 1.0.6. [Paul Magister]
75
+ - Fix gui: no duplicated button frame. [Paul Magister]
76
+ - Add documentation for new feature, fix links in README.md, new images.
77
+ [Paul Magister]
78
+ - Transparent description text. [Paul Magister]
79
+
80
+
81
+ 1.0.5 (2026-06-24)
82
+ ------------------
83
+ - Docs: Update HISTORY.md for release 1.0.5. [Paul Magister]
7
84
  - Collages in Portrait mode: improve layouting for portrait collages.
8
85
  [Paul Magister]
9
86
  - Collages in Portrait mode: improve layouting for portrait collages.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: Photo-Composition-Designer
3
- Version: 1.0.5
3
+ Version: 1.0.7
4
4
  Summary: Feature-rich Python project template for Photo-Composition-Designer.
5
5
  Author: pamagister
6
6
  Requires-Python: <4.0,>=3.11
@@ -60,6 +60,8 @@ Photo-Composition-Designer is a tool designed to automate the creation of beauti
60
60
  * ✅ **Location-Based Maps** – Integrate maps showing image locations using gps meta-data or image names and `locations.ini`.
61
61
  * ✅ **GUI Configuration Tool** – Easily modify configurations via a dynamic UI.
62
62
  * ✅ **Folder Management** – Automatically structures and organizes images into necessary folders.
63
+ * ✅ **AI Image Analysis** – Smart, content-aware image cropping powered by [Ultralytics YOLO26](https://docs.ultralytics.com/)
64
+ object recognition to keep the most important parts of every photo in view.
63
65
 
64
66
  ![Main GUI](_static/img/gui_main.png)
65
67
 
@@ -78,9 +80,10 @@ Download the latest executable:
78
80
 
79
81
  Get an impression of how your own project could be installed and look like.
80
82
 
81
- Download from [PyPI](https://pypi.org/).
83
+ Download from [PyPI](https://pypi.org/). For more installation options see [install](getting-started/install.md).
82
84
 
83
- 💾 For more installation options see [install](getting-started/install.md).
85
+ <details open>
86
+ <summary>💡 Details PyPI Installation</summary>
84
87
 
85
88
  ```bash
86
89
  pip install Photo-Composition-Designer
@@ -96,6 +99,9 @@ Run GUI from command line
96
99
  Photo-Composition-Designer-gui
97
100
  ```
98
101
 
102
+ </details>
103
+
104
+
99
105
  ---
100
106
 
101
107
 
@@ -118,6 +124,9 @@ Organize your images in the `images/` directory before running the generator.
118
124
  You can use one of the distribution methods to distribute your plain images inside this directory
119
125
  into sub-folders that represent your weekly collage content.
120
126
 
127
+ <details open>
128
+ <summary>💡 Details Photo Directory Structure</summary>
129
+
121
130
  ```plaintext
122
131
  📁 images/
123
132
  ├── 📁 title/
@@ -134,15 +143,38 @@ into sub-folders that represent your weekly collage content.
134
143
 
135
144
  ```
136
145
 
146
+ </details>
147
+
148
+
137
149
  ### 3️⃣ **Provide Descriptions** 🖥️
138
150
  Provide descriptions for every week to describe the events.
139
151
 
140
152
  You can use one single `description.txt` file that can be generated using the GUI
141
153
  or you can put individual txt files into every single weekly sub folder.
142
154
 
155
+ <details>
156
+ <summary>💡 Optional control flags</summary>
157
+
158
+ The following flags can be added anywhere in the photo description:
159
+
160
+ - `[no-calendar]` — prevents a calendar from being generated for this photo.
161
+ - `[no-description]` — suppresses the generated photo description.
162
+
163
+ Example:
164
+
165
+ ```text
166
+ Family vacation at the beach [no-calendar]
167
+ [no-description]
168
+ ```
169
+ </details>
170
+
171
+
143
172
  ### 4️⃣ **Setting up the birthday dates** 🎂📅
144
173
  Provide the birthday information of your friends and family by using the `anniversaries.ini`
145
174
 
175
+ <details open>
176
+ <summary>💡 Details</summary>
177
+
146
178
  ```plaintext
147
179
  [Birthdays]
148
180
 
@@ -154,11 +186,14 @@ Anna = 10.01.
154
186
  [Weddings]
155
187
  Mary & Josh = 02.01.2021 ; ⚭ Symbol is used for Weddings
156
188
  ```
189
+ </details>
190
+
191
+
157
192
 
158
193
  ### 5️⃣ **Generating the Calendar** 🖼️
159
194
  Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
160
195
 
161
- ![collages.png](_static/img/collages.png)
196
+ ![Collages_Preview](_static/img/collages.png)
162
197
 
163
198
  ### 6️⃣ **Printing the Calendar** 🖨️
164
199
  Send the generated PDF to your printer or local print shop for high-quality printing.
@@ -1,3 +1,5 @@
1
+ <!-- This README.md is auto-generated from docs/index.md -->
2
+
1
3
  # Welcome to Photo-Composition-Designer
2
4
 
3
5
  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.
@@ -20,8 +22,10 @@ Photo-Composition-Designer is a tool designed to automate the creation of beauti
20
22
  * ✅ **Location-Based Maps** – Integrate maps showing image locations using gps meta-data or image names and `locations.ini`.
21
23
  * ✅ **GUI Configuration Tool** – Easily modify configurations via a dynamic UI.
22
24
  * ✅ **Folder Management** – Automatically structures and organizes images into necessary folders.
25
+ * ✅ **AI Image Analysis** – Smart, content-aware image cropping powered by [Ultralytics YOLO26](https://docs.ultralytics.com/)
26
+ object recognition to keep the most important parts of every photo in view.
23
27
 
24
- ![Main GUI](_static/img/gui_main.png)
28
+ ![Main GUI](docs/_static/img/gui_main.png)
25
29
 
26
30
  ---
27
31
 
@@ -38,9 +42,10 @@ Download the latest executable:
38
42
 
39
43
  Get an impression of how your own project could be installed and look like.
40
44
 
41
- Download from [PyPI](https://pypi.org/).
45
+ Download from [PyPI](https://pypi.org/). For more installation options see [install](docs/getting-started/install.md).
42
46
 
43
- 💾 For more installation options see [install](getting-started/install.md).
47
+ <details open>
48
+ <summary>💡 Details PyPI Installation</summary>
44
49
 
45
50
  ```bash
46
51
  pip install Photo-Composition-Designer
@@ -56,6 +61,9 @@ Run GUI from command line
56
61
  Photo-Composition-Designer-gui
57
62
  ```
58
63
 
64
+ </details>
65
+
66
+
59
67
  ---
60
68
 
61
69
 
@@ -63,14 +71,14 @@ Photo-Composition-Designer-gui
63
71
 
64
72
  ### 1️⃣ **Configuring the parameters**
65
73
  You can adjust the result by setting up your own parameters like size, margins and colors.
66
- For more details, see [Configuration Parameters](usage/config.md).
74
+ For more details, see [Configuration Parameters](docs/usage/config.md).
67
75
  Modify your settings inside the `config.yaml` or using the GUI:
68
76
  - Image sizes (mm converted to pixels internally)
69
77
  - Calendar layout
70
78
  - Paths to `anniversaries.ini` and `locations.ini`
71
79
  - Fonts and Colors
72
80
 
73
- ![Settings GUI](_static/img/gui_settings.png)
81
+ ![Settings GUI](docs/_static/img/gui_settings.png)
74
82
 
75
83
 
76
84
  ### 2️⃣ **Sorting Images into Folders**
@@ -78,6 +86,9 @@ Organize your images in the `images/` directory before running the generator.
78
86
  You can use one of the distribution methods to distribute your plain images inside this directory
79
87
  into sub-folders that represent your weekly collage content.
80
88
 
89
+ <details open>
90
+ <summary>💡 Details Photo Directory Structure</summary>
91
+
81
92
  ```plaintext
82
93
  📁 images/
83
94
  ├── 📁 title/
@@ -94,15 +105,38 @@ into sub-folders that represent your weekly collage content.
94
105
 
95
106
  ```
96
107
 
108
+ </details>
109
+
110
+
97
111
  ### 3️⃣ **Provide Descriptions** 🖥️
98
112
  Provide descriptions for every week to describe the events.
99
113
 
100
114
  You can use one single `description.txt` file that can be generated using the GUI
101
115
  or you can put individual txt files into every single weekly sub folder.
102
116
 
117
+ <details>
118
+ <summary>💡 Optional control flags</summary>
119
+
120
+ The following flags can be added anywhere in the photo description:
121
+
122
+ - `[no-calendar]` — prevents a calendar from being generated for this photo.
123
+ - `[no-description]` — suppresses the generated photo description.
124
+
125
+ Example:
126
+
127
+ ```text
128
+ Family vacation at the beach [no-calendar]
129
+ [no-description]
130
+ ```
131
+ </details>
132
+
133
+
103
134
  ### 4️⃣ **Setting up the birthday dates** 🎂📅
104
135
  Provide the birthday information of your friends and family by using the `anniversaries.ini`
105
136
 
137
+ <details open>
138
+ <summary>💡 Details</summary>
139
+
106
140
  ```plaintext
107
141
  [Birthdays]
108
142
 
@@ -114,11 +148,14 @@ Anna = 10.01.
114
148
  [Weddings]
115
149
  Mary & Josh = 02.01.2021 ; ⚭ Symbol is used for Weddings
116
150
  ```
151
+ </details>
152
+
153
+
117
154
 
118
155
  ### 5️⃣ **Generating the Calendar** 🖼️
119
156
  Use **Generate Composition** to generate all collages and one PDF file containing all your compositions.
120
157
 
121
- ![collages.png](_static/img/collages.png)
158
+ ![Collages_Preview](docs/_static/img/collages.png)
122
159
 
123
160
  ### 6️⃣ **Printing the Calendar** 🖨️
124
161
  Send the generated PDF to your printer or local print shop for high-quality printing.
@@ -127,4 +164,4 @@ A very good print shop for Germany is [WIRmachenDRUCK ](https://www.wir-machen-d
127
164
 
128
165
  ---
129
166
 
130
- If you find this app helpful, [Funding](funding/funding.md) is highly appreciated 🧡.
167
+ If you find this app helpful, [Funding](docs/funding/funding.md) is highly appreciated 🧡.
@@ -31,6 +31,8 @@ calendar:
31
31
  startDate: '2025-12-29T00:00:00'
32
32
  # Number of collages to be generated (e.g. number of weeks) | type=int
33
33
  collagesToGenerate: 53
34
+ # Align the calendar horizontally (False means vertical) | type=bool | [CLI] | choices=[True, False]
35
+ horizontalOrientation: true
34
36
  style:
35
37
  # Background color (RGB) | type=Color
36
38
  backgroundColor: '#141414'