concat-images
Combine multiple images into one with customizable orientation, spacing, and alignment.
Installation
pip install concat-images
Python Usage
from concat_images import load_images, concatenate_images
images = load_images(['a.png', 'b.png', 'c.png'])
result = concatenate_images(images, orientation='horizontal', spacing=10, alignment='center')
result.save('output.png')
# With custom background (transparent)
result = concatenate_images(images, 'vertical', 0, 'center', background=(0, 0, 0, 0))
CLI Usage
concat-images output.png img1.png img2.png [img3.png ...]
Options
| Option | Description | Default |
|---|---|---|
-o, --orientation |
vertical or horizontal |
vertical |
-s, --space |
Pixels between images | 0 |
-a, --align |
begin, center, or end |
center |
-b, --background |
Background color as R,G,B, R,G,B,A, or transparent |
255,255,255,255 |
Example
concat-images result.png a.png b.png c.png -o horizontal -s 10 -a center
Development
git clone https://github.com/mrpesho/concat-images.git
cd concat-images
pip install -e .[dev]
pytest
1 maintainer
Metadata
1 maintainer
Release files for concat-images 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| concat_images-0.2.0.tar.gz | 4.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| concat_images-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 10.0 kB
Release files / concat_images-0.2.0.tar.gz
| Download URL | concat_images-0.2.0.tar.gz |
|---|---|
| Size | 4.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fabee860a6f80bbdba14a9d87cb01db7da4cdce5833d533a1ed0eaf97be3e6f
|
|
BLAKE2b-256 checksum How to use checksums |
423165a45252ff4a3fe43e97d890d7543f6df69b6f24248bba8b035b651b4b08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
Release files / concat_images-0.2.0-py3-none-any.whl
| Download URL | concat_images-0.2.0-py3-none-any.whl |
|---|---|
| Size | 5.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
da35f55c0240ebaa706487ba73f505220cddb36bedc80a0fb42add345d5e607c
|
|
BLAKE2b-256 checksum How to use checksums |
819fc376f5b4e02af1ed5181b633c1181cdb200b8c544719d77e45818aedbaf8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.3
|
