Manual:Pywikibot/imagetransfer.py

Imagetransfer.py is a Pywikibot script that copies images from one wiki to another wiki. To transfer image to Wikimedia Commons use imagecopy.py.

Usage

edit
$ python pwb.py imagetransfer [common-arguments] pagename [-interwiki] [-tolang:xx] [-tofamily:yy] [-keepname]

or

$ python pwb.py imagetransfer [common-arguments] [-file:zz] [-interwiki] [-tolang:xx] [-tofamily:yy] [-keepname]

Arguments

edit
-interwiki    Look for images in pages found through interwiki links.
-keepname     Keep the filename and do not verify description while replacing
-tolang:xx    Copy the image to the wiki in language xx
-tofamily:xyz Copy the image to a wiki in the family xyz 
-file:zz      Upload many files from textfile: [[Image:xx]]
                                              [[Image:yy]]
-force_if_shared For those with override rights, to override where a file exists on Commons, and is being copied to a sister wiki

If pagename is an image description page, the script offers to copy the image to the target site.

If pagename is a normal page, it will offer to copy any of the images used on that page.

If -interwiki is used, any of the images used on a page are reachable via interwiki links. (i.e. The interwiki link [[Food]] is found on the page Cake. The bot will search both the food and the cake page for images). If copying from Commons you will also need to direct to the work -site:commons:commons


Global arguments available

These options will override the configuration in user-config.py settings.

Global options
Parameter Description Config variable
-dir:PATH Read the bot's configuration data from directory given by PATH, instead of from the default directory.  
-config:file The user config filename. Default is user-config.py. user-config.py
-lang:xx Set the language of the wiki you want to work on, overriding the configuration in user-config.py. xx should be the language code. mylang
-family:xyz Set the family of the wiki you want to work on, e.g. wikipedia, wiktionary, wikitravel, ... This will override the configuration in user-config.py. family
-user:xyz Log in as user 'xyz' instead of the default username. usernames
-daemonize:xyz Immediately return control to the terminal and redirect stdout and stderr to file xyz. (only use for bots that require no input from stdin).  
-help Show the help text.  
-log Enable the log file, using the default filename 'script_name-bot.log' Logs will be stored in the logs subdirectory. log
-log:xyz Enable the log file, using 'xyz' as the filename. logfilename
-nolog Disable the log file (if it is enabled by default).  
-maxlag Sets a new maxlag parameter to a number of seconds. Defer bot edits during periods of database server lag. Default is set by config.py maxlag
-putthrottle:n
-pt:n
-put_throttle:n
Set the minimum time (in seconds) the bot will wait between saving pages. put_throttle
-debug:item
-debug
Enable the log file and include extensive debugging data for component "item" (for all components if the second form is used). debug_log
-verbose
-v
Have the bot provide additional console output that may be useful in debugging. verbose_output
-cosmeticchanges
-cc
Toggles the cosmetic_changes setting made in config.py or user-config.py to its inverse and overrules it. All other settings and restrictions are untouched. cosmetic_changes
-simulate Disables writing to the server. Useful for testing and debugging of new code (if given, doesn't do any real changes, but only shows what would have been changed). simulate
-<config var>:n You may use all given numeric config variables as option and modify it with command line.