Manual:Pywikibot/Compat/Basic use
< Manual:Pywikibot​‎ | Compat
Translate this page
Other languages:
Bahasa Indonesia • ‎English • ‎español • ‎français • ‎italiano • ‎polski • ‎português • ‎svenska • ‎čeština • ‎Ελληνικά • ‎русский • ‎српски / srpski • ‎العربية • ‎中文 • ‎日本語 • ‎한국어
This page is documentation for Pywikipedia Compat, which is no longer supported. This page is kept for historical interest. It may document scripts and features that are obsolete and/or no longer supported. Do not rely on the information here being up-to-date.
1.1Select and run a bot script
2.1Command-line arguments
3Permission on Wikimedia projects
See Create a shortcut for Windows users.
Select and run a bot script​[​edit​]
Now that you have installed python and Pywikibot, you need to get to a textual interface to your Operating System.
Accessing pywikibot
After you have created the file that is named​, you can access pywikibot.
On Windows this is done by opening the start menu, and clicking on 'Run'. You are asked to give the name of a program, type "​cmd.exe​".
The following steps might need to be done:
On Mac, find in /Applications/Utilities, see Mac Installation​.
On Linux or any other Unix, use any terminal application such as gnome-terminal, konsole, xterm, or simply the text-mode console.
In compat, run the script by typing "python". If you don't have yet, this command will interactively create it.
In core, from the core directory, run the script by typing "python login". If you don't have yet, this command will interactively create it. does add the core directory to the `PATH` variable so that python sees the pywikibot directory. There are other ways to fix this like adding the core directory (or any directory containing the pywikibot directory) to `PATH` or `PYTHONPATH`.
Entering password
Python will then return:
Password for user your_bot on your_site:en:
Use the password you used for the bot's login name. Note that your input will not be visible for privacy reasons. The bot can't work anonymously. Unless you change your password, you normally need to run this program only once, the bot usually does not get logged off.
Using a bot
The bots are in the main pywikibot folder when downloaded.
If necessary, use the command cd to go to the directory where the bot files are saved.
Now run any of the bots here by typing "python" (If you are using Windows, you can leave out "python").
Main page: Manual:Pywikibot/Scripts
Command-line arguments​[​edit​]
Although many bot scripts have their own command line arguments, which should be documented on their respective pages (or in their source code), all bots unless specifically stated to the contrary recognize the following command line arguments:
(full list here: Manual:Pywikibot/Global Options)
Print a list of global bot arguments (this list), followed by bot-specific help if available.
Set the language of the wiki you want to work on to language code xx, overriding the configuration in​.
Set the family of the wiki you want to work on, e.g., wikipedia, wiktionary, wikitravel, ... This will override the configuration in​.
Log in as user 'xyz' instead of the default username.
Enable the logfile. Logs will be stored in the logs subdirectory.
Enable the logfile, using xyz as the filename.
Disable the logfile (if it's enabled by default).
Set the minimum time (in seconds) the bot will wait between saving pages. The default value is 10.
For example, python -family:wiktionary will run the "scriptname" bot on wiktionary articles, overriding the default family setting in your user configuration.
Permission on Wikimedia projects​[​edit​]
Make sure that your bot is approved by the wiki community where you are going to use it: see the global Bot policy for guidance. Strictness differs greatly between various projects.
Using your normal browser, create a login name and password for the bot. It is best to use a name that makes clear that it is a bot, and preferably also who is operating it. A common method is to use your own login name and add the word 'bot' to it, but several other forms also exist.
Categories: Pages kept for historical interestPywikibot compat
This page was last edited on 31 October 2020, at 12:43.
Text is available under the Creative Commons Attribution-ShareAlike License; additional terms may apply. See Terms of Use for details.
Privacy policy
Code of Conduct
Mobile view
Cookie statement
TalkContributionsCreate accountLog in
ReadEditView history
Visit the main pageMain pageGet MediaWikiGet extensionsTech blogContributeUser helpFAQTechnical manualSupport deskCommunicationBug trackerCode docsCode repositoryStatisticsCommunity portalRecent changesTranslate contentRandom pageVillage pumpSandboxWhat links hereRelated changesUpload fileSpecial pagesPermanent linkPage informationCite this pageCreate a bookDownload as PDFPrintable versionAdd links