Manual:Pywikibot/panoramiopicker.py

Panoramiopicker is a free Python program for easy upload of large numbers of images from Panoramio to Wikimedia Commons. The program is part of Pywikibot and is currently in pre-alpha state.

Installation
Panoramiopicker is 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) is 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).