https://github.com/adrienverge/PhotoCollage

Graphical tool to make photo collage posters
https://github.com/adrienverge/PhotoCollage

Last synced: about 2 months ago
JSON representation

Graphical tool to make photo collage posters

• Host: GitHub
• URL: https://github.com/adrienverge/PhotoCollage
• Owner: adrienverge
• License: gpl-2.0
• Created: 2013-11-21T03:32:32.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2024-08-09T16:01:49.000Z (4 months ago)
• Last Synced: 2024-10-22T16:46:08.315Z (about 2 months ago)
• Language: Python
• Homepage:
• Size: 2.05 MB
• Stars: 431
• Watchers: 22
• Forks: 73
• Open Issues: 45
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

• awesome-python-applications - Repo
• awesome-python-applications - Repo

README

        
PhotoCollage

============

.. image::

   https://travis-ci.org/adrienverge/PhotoCollage.svg?branch=master

   :target: https://travis-ci.org/adrienverge/PhotoCollage

   :alt: CI tests status

*Graphical tool to make photo collage posters*

PhotoCollage allows you to create photo collage posters. It assembles the input

photographs it is given to generate a big poster. Photos are automatically

arranged to fill the whole poster, then you can change the final layout,

dimensions, border or swap photos in the generated grid. Eventually the final

poster image can be saved in any size.

The algorithm generates random layouts that place photos while taking advantage

of all free space. It tries to fill all space while keeping each photo as

large as possible.

PhotoCollage does more or less the same as many commercial websites do, but

for free and with open-source code.

.. image::

   screenshots/photocollage-1.4-preview.png

   :alt: screenshot

It provides a library to create photo layouts and posters, and a GTK graphical

user interface. PhotoCollage is written in Python (compatible with versions 2

and 3) and requires the Python Imaging Library (PIL).

Features:

* generate random new layouts until one suits the user

* choose border color and width

* possible to swap photos in the generated grid

* save high-resolution image

* works even with a large number of photos (> 100)

* integrates into the GNOME environment

* available in English, French, German, Czech, Italian, Bulgarian, Dutch, Russian, Spanish, Polish and Ukrainian

Installation

------------

* Fedora 19+:

  .. code:: bash

   sudo dnf install photocollage

* Debian 9+ / Ubuntu 16.10+:

  .. code:: bash

   sudo apt-get install photocollage

* Using pip, the Python package manager:

  .. code:: bash

   sudo pip3 install photocollage

Usage

-----

After install a launcher for PhotoCollage will appear in your desktop menu.

If it doesn't, just run the command:

.. code:: bash

 photocollage

Hacking

-------

* If you changed the source and want to test your modifications, run:

  .. code:: bash

   PYTHONPATH=. bin/photocollage

  or:

  .. code:: bash

   python3 -c 'from photocollage import gtkgui; gtkgui.main()'

* If you need to build a package from source and install it:

  .. code:: bash

   # Install dependencies

   sudo dnf install python3-pillow python3-gobject

   sudo apt-get install python3-pil python3-gi

   sudo pacman -S python-pillow python-gobject

   # Install PhotoCollage

   python3 setup.py sdist

   pip3 install --user --upgrade dist/photocollage-*.tar.gz

* If you wish to contribute, please lint your code and pass tests:

  .. code:: bash

   flake8 .

   python3 -m unittest tests/test_*.py