Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rafpyprog/imagesoup

Python library designed for quick search and downloading images from Google Images.
https://github.com/rafpyprog/imagesoup

google-images image-processing python

Last synced: 5 days ago
JSON representation

Python library designed for quick search and downloading images from Google Images.

Host: GitHub
URL: https://github.com/rafpyprog/imagesoup
Owner: rafpyprog
License: mit
Created: 2017-09-08T03:00:48.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2020-03-11T09:56:20.000Z (over 4 years ago)
Last Synced: 2024-11-07T13:48:36.443Z (8 days ago)
Topics: google-images, image-processing, python
Language: Python
Homepage:
Size: 2.78 MB
Stars: 69
Watchers: 6
Forks: 10
Open Issues: 2
Metadata Files:
- Readme: README.rst
- License: LICENSE

Awesome Lists containing this project

README

        ImageSoup: Image Searching for Humans

=====================================

.. image:: https://img.shields.io/pypi/v/imagesoup.svg

  :target: https://pypi.python.org/pypi/imagesoup

.. image:: https://img.shields.io/pypi/l/imagesoup.svg

  :target: https://pypi.python.org/pypi/imagesoup

.. image:: https://img.shields.io/pypi/pyversions/imagesoup.svg

  :target: https://pypi.python.org/pypi/imagesoup

.. image:: https://travis-ci.org/rafpyprog/ImageSoup.svg?branch=master

  :target: https://travis-ci.org/rafpyprog/ImageSoup

.. image:: https://codecov.io/gh/rafpyprog/ImageSoup/branch/master/graph/badge.svg

  :target: https://codecov.io/gh/rafpyprog/ImageSoup

  

.. image:: https://img.shields.io/pypi/dm/imagesoup.svg

  :target: https://pypi.org/project/imagesoup/

  

Quick Tutorial  

--------------

.. code-block:: python

    

    >>> from imagesoup import ImageSoup

    >>>

    >>> soup = ImageSoup()    

    >>> images = soup.search('"Arya Stark"', n_images=10)

    >>>

    >>> arya = images[0]

    >>> arya.URL

    'https://upload.wikimedia.org/wikipedia/en/3/39/Arya_Stark-Maisie_Williams.jpg'

    >>> arya.show()

.. image:: https://upload.wikimedia.org/wikipedia/en/3/39/Arya_Stark-Maisie_Williams.jpg

.. code-block:: python

    >>> arya.size

    (300, 404)

    >>> arya.dpi

    (72, 72)

    >>> arya.color_count

    7269

    >>> arya.main_color(n=2)

    [('black', 0.6219224422442244), ('darkslategrey', 0.27796204620462045)]

    >>> arya.to_file('arya.jpg')

Installation

------------

To install ImageSoup, simply use pip:

.. code-block:: bash

    $ pip install imagesoup

Advanced Search

---------------

**image_size:** string, tuple(width, height)

    Find images in any size you need.

* (width, height)

* icon

* medium

* large

* 400x300+

* 640x480+

* 800x600+

* 1024x768+

* 2mp+

* 4mp+

* 8mp+

* 10mp+

* 12mp+

* 15mp+

* 20mp+

* 40mp+

* 70mp+

**aspect_ratio:** string

    Specify the shape of images.

* tall

* square

* wide

* panoramic

.. code-block:: python

    >>> from imagesoup import ImageSoup

    >>>

    >>> soup = ImageSoup()

    >>> images = soup.search('Cersei Lannister', image_size='icon', aspect_ratio='square')

    >>>

    >>> im = images[0]

    >>> im.URL

    'http://cdn.images.express.co.uk/img/dynamic/galleries/64x64/264415.jpg'

    >>> im.size

    (64, 64)

    >>> im.show()

.. image:: http://cdn.images.express.co.uk/img/dynamic/galleries/64x64/264415.jpg