Metadata-Version: 2.4
Name: concat-images
Version: 0.2.0
Summary: Combine multiple images into one with customizable orientation, spacing, and alignment
Author: Aleš Kancilija
License-Expression: MIT
Project-URL: Homepage, https://github.com/mrpesho/concat-images
Project-URL: Repository, https://github.com/mrpesho/concat-images
Project-URL: Issues, https://github.com/mrpesho/concat-images/issues
Keywords: image,concatenate,combine,pillow,cli
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Multimedia :: Graphics
Classifier: Typing :: Typed
Requires-Python: >=3.8
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: Pillow>=10.0.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Dynamic: license-file

# concat-images

Combine multiple images into one with customizable orientation, spacing, and alignment.

## Installation

```bash
pip install concat-images
```

## Python Usage

```python
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

```bash
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

```bash
concat-images result.png a.png b.png c.png -o horizontal -s 10 -a center
```

## Development

```bash
git clone https://github.com/mrpesho/concat-images.git
cd concat-images
pip install -e .[dev]
pytest
```
