Manual:Pywikibot/panoramiopicker.py

Panoramiopicker was a free Python program for easy upload of large numbers of images from Panoramio to Wikimedia Commons. The program was part of Pywikibot and was deprecated after panoramio was closed.

Installation
Panoramiopicker was part of Pywikibot. You first need to install pywikibot. At Using the pywikibot you can find a manual on how to install pywikibot.
 * Pywikibot

We need to install 2 more packages. For this we need setuptools. You can download the latest version at http://pypi.python.org/pypi/setuptools
 * Easy install

Python Image Library (PIL) was used to show the image. You can install it by running the command at a command prompt:
 * Python Image Library

If you recently installed pywikibot your user-config.py contains a panoramio section, otherwise you have to add it to user-config.py yourself. Edit user-config.py with your favorite text editor. panoramio = { 'review': False, # Do we use automatically make our uploads reviewed? (True or False) 'reviewer': 'REVIEWER_NAME', # If so, under what reviewer name? }
 * Configuration
 * 1) Configuration of panoramiopicker.py
 * review : If you want to mark all images as review automatically. Use "True" only if you have a reviewer or sysop flag on Commons!
 * reviewer : Add your username here if you want to mark images as reviewed by you.

Usage
To run Panoramiopicker you have to browse to the Pywikibot folder. Then type the following:

You are presented with various options:
 * Options to tell what images to work on:
 * set - The id of the Panoramio user to work on. Works on all images uploaded by a user. Username is not an id! For example, id for user Alexxx1979 is 5528490 (you can find it in URL).
 * -start_id - Start at the photo with this id (useful for resuming uploads). Use this in combination with -set
 * -end_id - Stop at the photo with this id (useful if you just want to do a part of the upload and later resume with -start_id)
 * Options to tell how to work on each image:
 * -tags - Filter out a certain tag (only one at the moment, will be changed to support multiple tags).
 * -panoramioreview - Mark as panoramioreviewed, this overrides the settings in your user-config.py
 * -reviewer - Set the reviewer for panoramioreview, this overrides the settings in your user-config.py
 * -override - Remove the licensing part and replace it with something custom. Can be used for transfering copyrighted photo's for which you have OTRS permission. Use with care!
 * -addcategory - Manually add a category (will be changed to support multiple categories)
 * -autonomous - For autonomous uploading without showing of each image. Use with care!

Syntax:

Troubleshooting
Traceback (most recent call last): File "panoramiopicker.py", line 28, in    from PIL import Image, ImageTk    # see: http://www.pythonware.com/products/pil/ ImportError: No module named PIL

You can fix this by manually PIL installation (not by easy_install).