📷 Python package and CLI utility to create photo mosaics.

Last update: Oct 29, 2022

Overview

Python package and CLI utility to create photo mosaics.

phomo lets you create photographic mosaics. It arranges the tile images to best recreate a master image. To achieve this, phomo computes a distance matrix between all the tiles and the master image regions, looking not just at the average colour but the norm of the colour distributions differences. Once this distance matrix is computed, each tile is assigned to the region of the master with the smallest distance between the colour distributions.

Installation

Requires python 3

In a terminal:

$ pip install phomo

As always, it is usually a good idea to use a virtual environment.

If you're just interested in command line usage, consider using pipx.

Usage

Python package

See the examples folder for usage as a python package.

CLI

Once it is installed, you can use the phomo command.

It would go something like:

$ phomo master.png tile_directory -S 20 20 -o mosaic.png

If in doubt see the help:

usage: phomo [-h] [-o OUTPUT] [-c MASTER_CROP_RATIO] [-s MASTER_SIZE [MASTER_SIZE ...]]
              [-C TILE_CROP_RATIO] [-S TILE_SIZE [TILE_SIZE ...]] [-n N_APPEARANCES] [-v] [-b] [-g]
              [-d SUBDIVISIONS [SUBDIVISIONS ...]]
              master tile_dir

positional arguments:
  master                Master image path.
  tile_dir              Directory containing the tile images.

optional arguments:
  -h, --help            show this help message and exit
  -o OUTPUT, --output OUTPUT
                        Mosiac output path.
  -c MASTER_CROP_RATIO, --master-crop-ratio MASTER_CROP_RATIO
                        Crop the master image to width/height ratio.
  -s MASTER_SIZE [MASTER_SIZE ...], --master-size MASTER_SIZE [MASTER_SIZE ...]
                        Resize master image to width, height.
  -C TILE_CROP_RATIO, --tile-crop-ratio TILE_CROP_RATIO
                        Crop the tile images to width/height ratio.
  -S TILE_SIZE [TILE_SIZE ...], --tile-size TILE_SIZE [TILE_SIZE ...]
                        Resize tile images to width, height.
  -n N_APPEARANCES, --n-appearances N_APPEARANCES
                        The number of times a tile can appear in the mosaic.
  -v, --verbose         Verbosity.
  -b, --black_and_white
                        Black and white.
  -g, --show-grid       Show the tile grid, don't build the mosiac.
  -d SUBDIVISIONS [SUBDIVISIONS ...], --subdivisions SUBDIVISIONS [SUBDIVISIONS ...]
                        Grid subdivision thresholds.

Note

The grid subdivision feature was inspired by photomosaic.

📷 Python package and CLI utility to create photo mosaics.

Related tags

Overview

Python package and CLI utility to create photo mosaics.

Installation

Usage

Python package

CLI

Note

TODO

Owner

Loic Coyle

Kimimaro: Skeletonize Densely Labeled Images

Python wrappers for external BART computational imaging tools and internal libraries

Gbs-image-colorizer - A tool to convert colorful pictures to GB Studio-compatible colorized backgrounds.

An async Python library to automate solving ReCAPTCHA v2 by audio using Playwright.

A script to generate a profile picture and a banner that show the same image on Discord.

Hacking github graph with a easy python script

PyGtk Color - A couple of python scripts to select a color (for scripting usage)

Simple program to easily view Euler parameters in 3D.

Plots is a graph plotting app for GNOME.

Tools for making image cutouts from sets of TESS full frame images

Gaphor is the simple modeling tool

㊙️ Create standard barcodes with Python. No external dependencies. 100% Organic Python.

🖼️ Draw Images or GIFs in your terminal

Image-Viewer is a Windows image viewer based on Python 3.

This is a new web-based photo management application. Run it on your home server and it will let you find the right photo from your collection on any device. Smart filtering is made possible by object recognition, location awareness, color analysis and other ML algorithms.

Anime2Gif - an algorithm that detects scenes in a video and generates gifs from it

HCaptcha solver using requests and an image recognition package!

A drop-in replacement for django's ImageField that provides a flexible, intuitive and easily-extensible interface for quickly creating new images from the one assigned to the field.

Generate meme GIFs in which an image you choose can be viewed by the user only after they wait a whole hour.

A Icon Maker GUI Made - Convert your image into icon ( .ico format ).