AutoWikiBrowser

Note: To see the red link image, go to Help:Using AutoWikiBrowser

ℹ️️

**Current issues**

If you are unable to sign in when using AWB, ensure you are on the latest update of AWB. This update cannot be downloaded through the auto-updater and would have to be downloaded manually and overwrite your files in the AWB directory.

If you are trying to use AWB on a wiki migrated to fandom.com, you will have to use a 'custom' domain rather than 'wikia' in the project area (see #Choosing a community). Ensure that the HTTP/HTTPS drop-down is set to HTTPS and fully write out the domain, eg: **flintstones.fandom.com**

If you have any other issues, please contact Staff.

This tutorial will lead you through the process of creating a bot using the **AutoWikiBrowser** program through the example of changing a word on pages of the 'Fandubbing Wiki'.

A more in-depth user manual is available on Wikipedia.

## Step 1: Create your bot account

*Note: If you already have a bot account, skip this step*

Your bot must use a separate account (for more info check this article).

1. Many users prefer to have their bot account include the word "bot", to signify that they are a bot.
2. On the user page of this account; post info about the bot's owner and all the needed details (mentioned here). To make it simple you can use this template: Template:Bot (just copy it on your wiki).
3. Contact FANDOM staff and request a bot flag for this account. This stops your bot from filling up RecentChanges.

## Step 2: Get the program

 File:Bots Tutorial 1.jpg
Download AutoWikiBrowser to your computer. The basic operation of the software is:

1. Launch AutoWikiBrowser
2. Log in to the bot account using AutoWikiBrowser
3. Specify what the bot is to do
4. Specify what pages the bot should do

Note that AutoWikiBrowser doesn't have to be run in bot mode. It can also be run in "semi-automated" mode, where you check each edit and automatically open the new page after saving. This may be handy if you want to edit a bunch of pages one after another.

## Step 3: Learn how to use the program

 File:Bots Tutorial 2 with marks.jpg
In this example, we will set up our bot and then use it to replace a short phrase on many pages of our wiki.

### Choosing a community

1. Launch AutoWikiBrowser.
2. Go to **Options → Preferences → Site**
3. From the drop-down list choose "Wikia" and then type the URL of your community. In the example, this community is "pl.fandubbing".
4. When you are done, save changes with the OK button.

Your program may freeze for few seconds. After this on the bottom bar you will see that program is synchronized with the given community:

File:Bots Tutorial 3 with marks.jpg

### Logging in

 File:Bots Tutorial 4.jpg
Once you have chosen a wiki, you must log into your bot account. In the example, the bot is named "fandubbing.wikia", after the wiki it runs on.

* Go to **File → Log in/Profiles...**
* Enter the bot's username and password
* Press "Login"

Your bottom bar will now show that you are fully logged in:

 File:Bots Tutorial 5.jpg

Now the bot is set and ready to work!

**Note:** Some wikis use a check page that may limit login to specific usernames as well as whether the bot status is false (human semi-automatic editing) and/or true (fully automatic editing).

### Choosing edit options

 File:Bots Tutorial 6 with marks.jpg
In this example, we will use the bot to replace all badly entered artist names.

1. Make a list of pages to edit. For example, you can choose all the pages in a given category.
2. Choose the edition options from the middle panel. In this example in the "Find and Replace" section we used "Normal Settings" and entered the phrase and its replacement.

**TIP:** To make a list of all pages in the main namespace, in the "Make List" panel choose "Special Page" as the source. When you press "Make List" an additional window should appear. Choose "All Pages", select namespace "Main:" and press OK.

**TIP**: Untick all settings you are not sure of! To learn more about what all of those do, see the manual.

### Starting the edits

 File:Bots Tutorial 7 with marks.jpg
When you are ready to begin, go to the "Start" tab from the middle section.

1. Enter the default edit summary. It will be shown as a summary of each edit.
2. Press Start!

The program will start searching through the previously listed pages. When it finds the phrase it searches for, it will apply all previously defined changes and show them in the top window.

In case you are not satisfied with the changes you can edit the page using the edit box on the right.

When you are done press "Save" to save changes. If the page doesn't need to be edited, press "Skip" to leave the page unchanged.

**TIP:** In "Skip Options" tab check the option "Skip if no changes are made". This will cause AutoWikiBrowser to automatically skip pages that won't have any changes.

### Fully automatic bot

The example above shows semi-automatic editing. It is quite fast and safe, as you can control each change being made. However, if you wish you can go to "Bots" tab and check "Auto save" option.

AutoWikiBrowser will now save each change automatically, without any confirmation. **Use this option with care**, running a few semi-automatic test edits before turning auto save on to test if the bot is functioning properly is recommended.