Skip to main content

Concat photos together in a matrix

Project description

Overview

Simple command-line application which concatenates a list of photos into a single photo showing them in a matrix (in other words, a grid).

Installation

First of all, you need Python 3.7 or greater installed in your system.

Then, as photomatrix is a command line application, open a terminal and be ready to type commands.

Install automatically with pip

photomatrix is available from the Python Package Index (PyPI), so installable with pip:

pip3 install photomatrix

You should now have photomatrix available in your shell. For example, print the command help:

photomatrix -h

Build locally

Alternatively, you can build locally from source code. First, clone this project from Github.

Cd into the root folder.

Create a virtual environment (e.g. named my_env) and activate it:

python3 -m venv my_venv
source my_venv/bin/activate

Install the dev dependencies and the app dependencies into the virtual environment:

pip3 install -r requirements_dev.txt
pip3 install -e .

Run like this:

python3 -m photomatrix -h

Usage

The basic usage is:

photomatrix INPUT_IMAGES OUTPUT_IMAGE

where all the images found in the specified input path will be loaded, sorted, combined in a matrix and the result will be written in the specified output path.

Further options that you can customize are:

  • Number of rows vs columns
  • Resize and crop
  • Sorting
  • Border
  • Text to print (e.g. filename or Exif original date)

See the command help (with -h) for more info on these options.

Examples

The following examples use these test input images:

up to

Matrix with border

To build a matrix with a simple border:

photomatrix "data/input/*.jpg" data/output/matrix_border.jpg --border-width-ratio 0.1

resulting in:

Matrix sorted and with text

To build a matrix with inverse filename order, printing the filename in top center position:

photomatrix "data/input/*.jpg" data/output/matrix_sort_text.jpg --sort filename_desc --text-type filename --text-position top_center

resulting in:

Integration Tests

Run the integration tests with:

python3 -m pytest tests/integration

Project details


Download files

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

Files for photomatrix, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size photomatrix-0.0.5-py3-none-any.whl (13.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size photomatrix-0.0.5.tar.gz (7.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page