Manual:Pywikibot/imagetransfer.py

⧼tpt-languages-legend/Pywikibot/imagetransfer.py⧽

<translate> Wikimedia [[<tvar|1>Special:MyLanguage/Gerrit</>|Git repository]] has this file:</translate> scripts/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

<translate> Global arguments available</translate>

<translate> These options will override the configuration in <tvar|1>user-config.py </> settings. </translate>

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