Metadata-Version: 2.1
Name: niceposter
Version: 0.1.5
Summary: Image Manipulation Tool - Used for creating & modifying image posters
Home-page: https://github.com/amajai/niceposter
License: GPL-3.0-or-later
Keywords: pillow,poster,image-processing,editor
Author: A.A.Isa
Author-email: aabdulmajeed.isa@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Pillow (>=8.0.1,<9.0.0)
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/amajai/niceposter/main/res/icon.png" width="180">
<p>

# Niceposter
![PyPI](https://img.shields.io/pypi/v/niceposter?label=latest%20version)
![Pillow](https://img.shields.io/badge/Built%20with-Pillow-yellow) 

  
A library that allows you to create your own image poster which you can use to share on social media. Implemented in Python using the PIL module.


 <img src="https://raw.githubusercontent.com/amajai/niceposter/main/res/demo.gif">



## **Installation**
```elm
pip install niceposter
```
__Important:__ depending on your system, make sure to use `pip3` and `python3` instead.


**That's all! 🎉**   

>If you would like to install a specific version of Niceposter you may do so with:
>```elm
>pip install niceposter==0.1.1
>```
#### Using Niceposter

To start creating an image poster, you have to initialize it, like so: 
```python
from niceposter import Create

bg_image = Create.Poster() # default size of 500x500
```

Then use any one of the methods to make or add changes to an image. Examples:
```python
bg_image.add_image('cool-image.png', position='cc', scale=20)
bg_image.text('Interesting text!', position(50,50), color='red', align='center')
bg_image.frame(thickness=10)
bg_image.filter(rgb=(255,255,255), opacity=50)
```

#### Updating Niceposter
```elm
pip install niceposter -U
```
## Basic functions
[**In progress**]

## Features in progress
⬜ Add `add_shape` method option to provide variety of available shapes

⬜ Add image transformations options

⬜ Add image effects options

## Documentation
Contributions are welcome, and they are greatly appreciated! Every little bit
helps, and credit will always be given.



