Metadata-Version: 2.1
Name: pilgram
Version: 1.0.3
Summary: library for instagram filters
Home-page: https://github.com/akiomik/pilgram
Author: Akiomi Kamakura
Author-email: akiomik@gmail.com
License: Apache License 2.0
Description: # pilgram
        
        [![PyPI](https://img.shields.io/pypi/v/pilgram.svg)](https://python.org/pypi/pilgram)
        [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/pilgram.svg)](https://python.org/pypi/pilgram)
        [![Build Status](https://travis-ci.org/akiomik/pilgram.svg?branch=master)](https://travis-ci.org/akiomik/pilgram)
        [![codecov](https://codecov.io/gh/akiomik/pilgram/branch/master/graph/badge.svg)](https://codecov.io/gh/akiomik/pilgram)
        
        A python library for instagram filters.
        
        ![screenshot](screenshot.png)
        
        The filter implementations are inspired by [CSSgram](https://una.im/CSSgram/).
        
        ## Requirements
        
        - Python 2 or 3
        - [Pillow](https://pillow.readthedocs.io/en/stable/) or [pillow-simd](https://github.com/uploadcare/pillow-simd)
        
        ## Install
        
        ```sh
        pip install pillow # or pip install pillow-simd
        pip install pilgram
        ```
        
        ## Usage
        
        Available instagram filters on `pilgram`: `_1977`, `aden`, `brannan`, `brooklyn`, `clarendon`, `earlybird`, `gingham`, `hudson`, `inkwell`, `kelvin`, `lark`, `lofi`, `maven`, `mayfair`, `moon`, `nashville`, `perpetua`, `reyes`, `rise`, `slumber`, `stinson`, `toaster`, `valencia`, `walden`, `willow`, `xpro2`
        
        ```python
        from PIL import Image
        import pilgram
        
        im = Image.open('sample.jpg')
        pilgram.aden(im).save('sample-aden.jpg')
        ```
        
        Similarly, pilgram provides css filters and blend modes as a by-product.
        
        Available css filters on `pilgram.css`: `contrast`, `grayscale`, `hue_rotate`, `saturate`, `sepia`
        
        ```python
        from PIL import Image
        import pilgram.css
        
        im = Image.open('sample.jpg')
        pilgram.css.sepia(im).save('sample-sepia.jpg')
        ```
        
        Available blend modes on `pilgram.css.blending`: `color`, `color_burn`, `color_dodge`, `exclusion`, `hard_light`, `hue`, `overlay`, `soft_light`
        
        ```python
        from PIL import Image
        import pilgram.css.blending
        
        backdrop = Image.open('backdrop.jpg')
        source = Image.open('source.jpg')
        pilgram.css.blending.color(backdrop, source).save('blending.jpg')
        ```
        
        ## Demo
        
        [![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/github/akiomik/pilgram/blob/master/examples/example.ipynb)
        
        - [examples/example.ipynb](examples/example.ipynb) 
        
        ## Test
        
        ```sh
        pipenv install --dev
        make test     # python 3
        make test-tox # python 2 and 3
        ```
        
Keywords: pillow,instagram,instagram-filters,css-filters,image-blending,blend-modes,image-processing,data-augmentation
Platform: any
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
Description-Content-Type: text/markdown
