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

$ 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

-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.