Skip to main content

library for instagram filters

Project description

pilgram

PyPI PyPI - Python Version Python CI codecov

A python library for instagram filters.

screenshot

The filter implementations are inspired by CSSgram.

Requirements

Install

pip install pillow>=4.1.0 # or pip install pillow-simd
pip install numpy
pip install pilgram2

Usage

Available instagram filters on pilgram2:

  • _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
from PIL import Image
import pilgram2

im = Image.open('sample.jpg')
pilgram2.aden(im).save('sample-aden.jpg')

Similarly, pilgram2 provides css filters and blend modes as a by-product.

Available css filters on pilgram2.css:

  • contrast
  • grayscale
  • hue_rotate
  • saturate
  • sepia
from PIL import Image
import pilgram2.css

im = Image.open('sample.jpg')
pilgram2.css.sepia(im).save('sample-sepia.jpg')

Available blend modes on pilgram2.css.blending:

  • color
  • color_burn
  • color_dodge
  • darken
  • difference
  • exclusion
  • hard_light
  • hue
  • lighten
  • multiply
  • normal
  • overlay
  • screen
  • soft_light
from PIL import Image
import pilgram2.css.blending

backdrop = Image.open('backdrop.jpg')
source = Image.open('source.jpg')
pilgram2.css.blending.color(backdrop, source).save('blending.jpg')

Performance

filter performance comparison

Test

pipenv install --dev
make test     # pytest
make test-tox # pytest with tox

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pilgram2-2.0.0.tar.gz (784.4 kB view hashes)

Uploaded Source

Built Distribution

pilgram2-2.0.0-py3-none-any.whl (832.4 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page