Skip to content

Commit

Permalink
added troubleshooting guide and corrected errors
Browse files Browse the repository at this point in the history
  • Loading branch information
hardikvasa authored Feb 28, 2018
1 parent b130089 commit 6efc092
Showing 1 changed file with 50 additions and 3 deletions.
53 changes: 50 additions & 3 deletions README.rst
Original file line number Diff line number Diff line change
Expand Up @@ -27,20 +27,34 @@ Installation

$ pip install google_images_download

**Manually:**
**Manually using CLI:**

::

$ git clone https://github.com/hardikvasa/google-images-download.git
$ cd google-images-download && sudo python setup.py install

**Manually using UI:**

Go to the `repo on github <https://github.com/hardikvasa/google-images-download>`__ ==> Click on 'Clone or Download' ==> Click on 'Download ZIP' and save it on your local disk.

Usage
-----

If installed via pip or using CLI, use the following command:

::

$ googleimagesdownload [Arguments...]

If downloaded via the UI, unzip the file downloaded, go to the 'google_images_download' directory and use one of the below commands:

::
$ python3 google_images_download.py [Arguments...]
OR
$ python google_images_download.py [Arguments...]

Arguments
~~~~~~~~~

Expand Down Expand Up @@ -184,7 +198,7 @@ Examples

- To download images which are similar to the image in the image URL that you provided (Reverse Image search).

``python3 pr.py -si <image url> -l 10``
``googleimagesdownload -si <image url> -l 10``

- To download images from specific website or domain name for a given keyword

Expand All @@ -195,13 +209,46 @@ Examples

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

SSL Errors
Troubleshooting
----------

**## SSL Errors**

If you do see SSL errors on Mac for Python 3,
please go to Finder —> Applications —> Python 3 —> Click on the ‘Install Certificates.command’
and run the file.

**## googleimagesdownload: command not found**

While using the above commands, if you get ``Error: -bash: googleimagesdownload: command not found`` then you have to set the correct path variable.

To get the details of the repo, run the following command:
::
$ pip show -f google_images_download

you will get the result like this:
::
Location: /Library/Frameworks/Python.framework/Versions/2.7/lib/python2.7/site-packages
Files:
../../../bin/googleimagesdownload

together they make: ``/Library/Frameworks/Python.framework/Versions/2.7/bin`` which you need add it to the path:
::
$ export PATH="/Library/Frameworks/Python.framework/Versions/2.7/bin


**## [Errno 13] Permission denied creating directory 'downloads'**

When you run the command, it downloads the images in the current directory (the directory from where you are running the command). If you get permission denied error for creating the `downloads directory`, then move to a directory in which you have the write permission and then run the command again.


**## Permission denied while installing the library**

On MAC and Linux, when you get permission denied when installing the library using pip, try using shifting to sudo user and run the command.
::
$ sudo pip install google_images_download


Contribute
----------

Expand Down

1 comment on commit 6efc092

@rachmadaniHaryono
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Please sign in to comment.