Getting started
Pillbug is composed of 3 tabs: Config, Code, and Review. You can switch between tabs using the navbar on the top right.
Config is where you can log in, install nodepacks, and decide what pages you will edit, either by manually typing out a list, or by using the generator functionality.
Logging in / creating a BotPassword
Currently, Pillbug only supports BotPasswords as a login method, however OAuth is planned for future updates. To obtain a BotPassword, visit Special:BotPasswords on the MediaWiki instance you'll use Pillbug on. (Remember to also set the Wiki origin to that). For example, to create a BotPassword on English Wikipedia, I would go to https://en.wikipedia.org/wiki/Special:BotPasswords, type in a name in the "Create a new bot password" prompt, and give it the "High-volume (bot) access," "Edit existing pages," and optionally the "Edit protected pages" grants.
The page queue is the queue of pages to "work" on, i.e. the pages that will be processed by the code in the Code tab and be reviewed in the Review tab. It can either be manually created, or generated using the queue generator.
At the top of the queue generator is the process ahead? toggle. Pillbug will always fetch upcoming pages in the queue and run the skip graph, with process ahead? enabled, it will also run the process graph, meaning that reviewing edits will be slightly faster in some cases.
Queue generation relies on the Action API, and as such you need to be logged in. Results are capped at about 5,000 titles per generation; extra matches are truncated.
Pick one source with the radio on the left, fill its fields, optionally set Namespace, then press Generate. That replaces the current queue with the generated titles (you can still edit the textarea afterward and press Set queue).
Members of a category (title like Category:Example; Category: is added if missing).
- pages - normal pages in the category
- subcategories - subcategory pages. By default, even when filtered for the Category namespace, subcategories are excluded.
- files - file pages in the category. By default, even when filtered for the File namespace, files are excluded.
Select at least one of those types.
Pages that link to a given title.
- wikilinks - pages that link to the target, see also Help:Links
- transclusions - pages that transclude the target
-
file usage - pages that use the file (target is treated as
File:...if needed)
There is also redirect filtering.
- both - redirects and non-redirects
- redirects - only redirect pages
- non-redirects - only non-redirects
When using wikilinks, Include links to redirects controls whether to also follow through redirects of the target.
Titles starting with a given string.
-
Strict prefix search (on) - uses the all-pages list API for an exact prefix per selected namespace (good for precise searches, like
User:Example/). - Strict prefix search (off) - uses prefix search (more "search-box" style matching across the selected namespaces).
Outgoing wikilinks to existing pages from a page. Namespace filters which linked namespaces are kept.
Full wiki search. See the CirrusSearch help page.
The Namespace list filters queue generator results to the namespaces you select. Click to toggle; selected namespaces stay highlighted.
Nodepacks are installable bundles of graph nodes (extra building blocks for the Code tab), beyond Pillbug's defaults. Packs are typically installed once per browser; as they persist across reloads. After installing, switch to Code to place the new nodes in the process/skip graphs. If a pack fails to load, the Config column will show an error. A template nodepack is available here.