|Warning: You take full responsibility for any action you perform using AutoWikiBrowser. You must understand Wikipedia policies and use this tool within these policies, or risk losing access to the tool or even being blocked from editing.|
AutoWikiBrowser is not an automatic bot—edits made using this software are the responsibility of the editor using it. Although AWB does have an automatic mode enabled for some bot accounts, it normally just assists a human.
|Original author(s)||Bluemoose (retired)|
|Stable release||126.96.36.199 (July 8, 2021)|
|Preview release||SVN (SVN)|
|Operating system||Windows Vista and later|
AutoWikiBrowser (AWB) is a semi-automated MediaWiki editor designed to make tedious or repetitive editing tasks quicker and easier. It is a .NET desktop application which includes a browser that follows a user-generated list of pages to modify, presenting changes to implement within each of those pages, then progressing to the next page in the list once the changes are confirmed or skipped by the user. When set to do so, it suggests some changes (typically formatting) that are generally meant to be incidental to the main change.
AWB is written for Windows operating system versions Vista and newer. It also functions reasonably well under Wine on Mac and some versions of Linux but is not officially supported.
At present, AWB can create a list of pages from single or multiple categories, "what links here", the wiki links on a page, a text file, a Google search, a user's watchlist, or a user's contributions. AWB also comes with an integrated program to search Wikipedia database dumps. The edit box of AWB supports the Microsoft Text Services Framework for use with speech recognition/handwriting applications.
The sources are available under the GPLv2 (see Documentation page). It is written in C# using Microsoft Visual C# Express Edition/Visual Studio, which is freely available at Microsoft downloads.
There is an AWB IRC channel at #AutoWikiBrowser connect.
See also: Wikipedia:Bot policy § Bot-like editing
Request permission at Wikipedia:Requests for permissions/AutoWikiBrowser if you would like to use the software. Once your username is added to the list on the check page, you can then use AutoWikiBrowser on the English Wikipedia.
Anyone can be registered, but only if an admin approves your registration. As a general rule, only users with more than 250 non-automated mainspace edits or 500 total mainspace edits will be registered. You will probably not be contacted when your registration has been approved, so look at the check page periodically for your name or watchlist the page. Admin accounts are automatically approved for using the software, even without being registered. Admins with pseudo-bot or flooder (not available on the English Wikipedia) will still need to add themselves into the bots section of the CheckPage to be able to use the Bots tab.
If you are planning to use only the "Make list" or "List comparer" options, then there is no need to register. These parts of the software do not prompt for a username or check the account permissions.
Download the release version here. Please ensure that you click on the correct download button on the SourceForge page, as there may be more than one. The correct button is green and inside the box containing the description, just above the screenshots.
If you want to run the latest SVN version, see Wikipedia:AutoWikiBrowser/Sources.
AutoWikiBrowser requires Windows Vista or newer to edit on Wikimedia wikis. AutoWikiBrowser does not work on Windows XP as XP does not meet Wikimedia's security standards. On other wikis, AutoWikiBrowser may work with Windows XP, although the tool is likely no longer maintained.
AWB comes in a zip file, and it is recommended that it be unzipped to a new directory, rather than running, for example, straight from the desktop. AWB is not installed on the PC and runs mostly as a standalone application: AutoWikiBrowser.exe (the provided WikiFunctions.dll file is also required). AWB can be unzipped to any directory; however, on some machines there can be permissions problems that stop AWB working correctly if the directory used is on a network drive. If you're unsure, unzip AWB to somewhere on the machine's C: drive, for example, within 'Downloads'.
Main page: Wikipedia:AutoWikiBrowser/Mono and Wine
On Linux, AWB mostly works with Wine with .NET 4.5 installed and is suitable for use for regular editing. The installation process is the same as Wikipedia:Huggle/Wine.
AWB can also be started on Mono, albeit with some strange errors, and the web browser component does not yet work under Mono. AWB under Mono is not yet suitable for use for regular editing.
On macOS, AWB is not natively available, but one option is to use virtualization with Parallels Desktop for Mac (subject to meeting supported operating systems requirements) and then run Microsoft Windows virtually with AWB as the Windows instructions above. A paid license is required for both Parallels Desktop for Mac and Microsoft Windows. Another option is to use Boot Camp to install Windows, although it is not supported on Macs with the Apple M1 chip. An alternative is to use the free VirtualBox, although a paid license for Microsoft Windows is still required. AWB can also be used under Wine on a Mac. WineHQ has a page on Wine under MacOS. A package manager such as Homebrew can be used to install Wine; see Wine on a Mac using homebrew.
See also: Wikipedia:AutoWikiBrowser/User manual
Refer to the FAQ for more information, including problems with other software and Wikipedia skins.
AutoWikiBrowser's main feature is to easily make the same type of edit to a large number of pages. For example, fixing a typo, adding a navbox, or adding a category to dozens or hundreds of pages.
AutoWikiBrowser also has some other features.
AWB includes a database scanner that can be used to create lists of pages to be checked, without causing extra unnecessary load on Wikimedia servers. This is useful for building lists of titles to perform AutoWikiBrowser tasks on, and for performing searches that would time out on-wiki searches.
Database dumps are created from time to time (more info here) and are available for free download. As the page states, the best/most useful dump is the enwiki-latest-pages-articles.xml.bz2 (dir). Visiting the database dump progress site allows you to view the status of the current dump and easily browse to the downloads in it.
After downloading, the archive needs to be uncompressed; this will turn it from a ~18 GB bz2 archive into an XML database dump around 79 GB.
A scannable .xml file of selected files can also be generated by visiting Special:Export.
Main page: Wikipedia:AutoWikiBrowser/Custom Modules
AWB allows you to write your own C# or VB.NET code and execute it inside the program, via Custom Modules. This can be accessed via Tools -> Make module.
Main page: Wikipedia:AutoWikiBrowser/Plugins
AWB can also load and use fully customized plugins. These plugins can process page text and extend the user interface, and are in the form of libraries (.dll files) which can be made in any .NET language such as C# or Visual Basic .NET. When AWB loads, it automatically checks to see if there are any plugins in the folder from which it was executed. Any plugins found are loaded and initialized without further intervention by the user.
AWB ships with WikiFunctions.dll, which can be referenced by other standalone projects. The DLL includes a wiki-ready web browser control, a simple page editor, a listmaker, and other tools and components.
((Wikipedia:AutoWikiBrowser/Userbox 2))generates the userbox below