Open main menu
This project page in other languages:

Shortcut: COM:BRFA

Bot help and list · Requests to operate a bot · Requests for work to be done by a bot  · Requests for batch uploads

If you want to run a bot on Commons, you must get permission first. To do so, file a request following the instructions below.

Please read Commons:Bots before making a request for bot permission.

Requests made on this page are automatically transcluded in Commons:Requests and votes for wider comment.


Requests for permission to run a botEdit

Before making a bot request, please read the new version of the Commons:Bots page. Read Commons:Bots#Information on bots and make sure you have added the required details to the bot's page. A good example can be found here.

When complete, pages listed here should be archived to Commons:Bots/Archive.

Any user may comment on the merits of the request to run a bot. Please give reasons, as that makes it easier for the closing bureaucrat. Read Commons:Bots before commenting.

JhealdBot (talk · contribs) (7)Edit

Operator: Jheald (talk · contributions · Number of edits · recent activity · block log · User rights log · uploads · Global account information)

Bot's tasks for which permission is being sought:

Add a date-key to the file categorisation in an old maps category, where the file information includes a creation date before 1900, and where there is no existing key or defaultsort.

Automatic or manually assisted:

Closely-supervised automatic

Edit type (e.g. Continuous, daily, one time run):

Small batches, run from time to time

Maximum edit rate (e.g. edits per minute):


Bot flag requested: (Y/N):

Bot already has it.

Programming language(s):

Perl, using MediaWiki::Bot

More detailed explanation:

It's useful for "old maps" categories to be broadly ordered by date. (See eg Category:Old maps of whole Wales (alone) for example). This tends to group like together with like, allows maps from a particular period to be more easily found, and allows the historical flow of treatments of the subject to be seen on the category page -- so, in the Wales category, it groups the early "Cambriae Typus" maps together, before later maps become more divergent.
The ordering is achieved by adding a sort key (ie |xxxx) representing the map's year to its categorisation. (Or, alternatively, via a Defaultsort). A lot of old maps already have this, particular those acquired as part of a systematic batch uploading. But also very many do not.
The present request, which is more for an assistance-tool than a full-on bot, is to help with the adding of such date tags, by seeing whether the map has an original creation date set in its information template, and using that for the sort-key for the target category if possible.
It is not intended that the tool should run freely. Rather, it would run on a single category at a time, adjusting only the keys for that category. Indeed, in its current form, it relies on being fed a list of the files in that category obtained from a manually executed quarry query, such as quarry:query/36370, which needs to be adjusted and then re-run for each new category that is to be done. The script's application also tends to be rather limited, as many many files either have no information template, or no creation date, or a creation date corresponding to when they were uploaded, rather than when the map was actually made. So the process of ordering a category remains primarily manual; but the script I think would be a helpful assist, to take care of the most easy cases.
Furthermore there are some files which are perhaps not best placed in the main date sequence -- for example it may make sense to separately group together old maps with a particular sub-area of the category subject, distinct from the main sequence that depict the whole of the category subject. The script therefore ignores any files that already have a sort-key for the category, or have a defaultsort, leaving these for manual assessment; and it is intended that any actions will be closely reviewed, category by category.
As a result, in a test run on Category:Old maps of the Electorate of Trier, out of seventeen maps, the script only added a single sort-key. (diff); the rest were all added by hand.
Nevertheless, despite its limited application, for the easy cases I think the script could be a useful effort-saver, so I would welcome its approval.

Jheald (talk) 20:25, 23 May 2019 (UTC)


  • Test run on Category:Old maps of Germany. (Edit history, 20:59 to 21:01). Worked as expected, though category is a bit too heterogeneous to really show the advantages. Bot was editing a little fast, so I have slowed it down x2. Jheald (talk) 21:11, 23 May 2019 (UTC)
    Looks OK for me, but it'll be great add same information to meta-data when related properties will be enabled on Commons. --EugeneZelenko (talk) 13:36, 24 May 2019 (UTC)
  • Adding sort keys is pretty obvious good housekeeping. Rather than bot scope changes needing separate requests, could you not write a more generalized request for this and other types of map or GLAM related housekeeping? After running so many projects, your judgement as to what would then go out of scope, or be potentially controversial and need a new consensus should be sufficient. -- (talk) 23:02, 23 May 2019 (UTC)

Valerio Bozzolan bot (talk · contribs)Edit

Operator: Valerio Bozzolan (talk · contributions · Number of edits · recent activity · block log · User rights log · uploads · Global account information)

Bot's tasks for which permission is being sought:

The bot will import photos from the Lega Pallavolo Serie A consortium of volleyball teams. These ~1000/1400 photos of volleyball players will be categorized and automatically filled with a description on our best efforts (also after the upload). The list of the involved photos is specified in this Legavolley dataset. As you can see the human community is are already doing this task since a lot of years: Category:2011 files from Legavolley stream, Category:2012 files from Legavolley stream, etc. so we will try to replicate that behavior.

The legal owner will release an OTRS authorization as usual.

Automatic or manually assisted: manually assisted.

Edit type (e.g. Continuous, daily, one time run): one time run

Maximum edit rate (e.g. edits per minute): ~5 edit pm

Bot flag requested: (Y/N): N

Programming language(s): PHP

Repository: [1]

Thank your for your time. Valerio Bozzolan (talk) 18:00, 20 May 2019 (UTC)


  • Please make test run. --EugeneZelenko (talk) 13:58, 21 May 2019 (UTC)
    Hello @EugeneZelenko:! Thank you, test run done. --Valerio Bozzolan (talk) 09:14, 25 May 2019 (UTC)
    Please use language tags for Description and Author fields. In some files Date and Author fields merged into one line. Could you bot add content category (particular player or volleyball players of Italy) and meta-data (description, depicts)? --EugeneZelenko (talk) 14:21, 25 May 2019 (UTC)

BMacZeroBot (talk · contribs) 6Edit

Operator: BMacZero (talk · contributions · Number of edits · recent activity · block log · User rights log · uploads · Global account information)

Bot's tasks for which permission is being sought: Perform a batch upload from NPGallery, the US National Park Service's photo repository (Commons:Batch uploading/NPGallery). Licensing for these images is all over the place, so I'm being careful to determine public domain status before uploading; I'll be starting with pre-1924 images, images credited only as "NPS Photo", and images credited to people who are whitelisted as NPS employees.

Automatic or manually assisted: Automatic

Edit type (e.g. Continuous, daily, one time run): One-time

Maximum edit rate (e.g. edits per minute): 6 uploads per minute (given the speed of the source site, it will in all likelihood be far slower)

Bot flag requested: (Y/N): Already has.

Programming language(s): C#

BMacZero (talk) 05:33, 10 May 2019 (UTC)


Test run can be found in Category:Images from NPGallery to check. For the first few I made hand edits after uploading - in each case, I also updated the bot to do those things automatically. BMacZero (talk) 05:33, 10 May 2019 (UTC)

Please use language tags for Photographer and Depicted place fields. I also don't think that photos like File:Photo Op (5b2a2b65-0ba5-422a-8b04-dc47d36ee650).jpg and File:Posing (ad003174-6386-48df-a200-59eece4f59ce).jpg fit into Commons:Project scope. --EugeneZelenko (talk) 13:47, 10 May 2019 (UTC)
@EugeneZelenko: Good catch, will add the language tags. I'm not sure it's possible for me to effectively detect photos that are primarily of specific people and therefore out of scope. I can try looking for phrases like "a man" and "two women" in the text, but I think we'd probably miss some good images that way. Maybe I can add such images to an additional check category for humans to review? BMacZero (talk) 16:02, 10 May 2019 (UTC)
Users with quibbles are free to nominate any image for deletion. The overall value of the collection outweighs the odd out-of-scope random selfie shot. And images of specific non-notable people doing activities (or in locations) which are poorly illustrated on Commons can have educational use. Users of Wikivoyage or Wikibooks might like to use an image of everyday hikers in Denali National Park, without the inherent distraction in depicting a celebrity. Commons does not exist solely as a servant of Wikipedia, nor is it restricted to only Wikimedia projects. --Animalparty (talk) 17:49, 10 May 2019 (UTC)
Sorry, but I don't see big value to have pictures of everyday hikers in every possible place to hike. Places are more then enough for Wikivoyage. --EugeneZelenko (talk) 13:44, 11 May 2019 (UTC)
@EugeneZelenko: I added the logic I described above and put the images it would catch into Category:Images from NPGallery to check for scope. I'll can monitor this as I go and add more conditions as I spot them. If you'd rather we make the decision preemptively and not upload these at all, I can open a wider discussion to see if there is a consensus one way or the other. BMacZero (talk) 17:17, 11 May 2019 (UTC)
Sure, it's good idea to organize project to post-process files in mass uploads in many respects: reviewing, categorization, adding metadata, etc. --EugeneZelenko (talk) 14:08, 12 May 2019 (UTC)
Another useful field/addition to include is the NPGallery Album name of the images, to greatly improve categorization. This photo of a squirrel, categorized only at the National Park level (which are prone to crowding anyway), is one of 148 images in the Album: Squirrels in Denali: having the category name machine readable would greatly facilitate placing into Category:Mammals of Denali National Park or new subsidiary categories. --Animalparty (talk) 18:13, 10 May 2019 (UTC)
@Animalparty: Good catch, I forget to grab those on the download run. I've added an Album(s) line to the uploads. I also added the "NPS Unit Code". I did another 10 uploads with the changes. BMacZero (talk) 04:00, 11 May 2019 (UTC)
Please also take a look on recent uploads. For example, language tags are missing in some fields in File:Ranger-Led Hike (bb4d7778-d65b-4ba3-8ddc-464d63ae1f4e).jpg, will be good idea to use plain text in description. --EugeneZelenko (talk) 14:08, 12 May 2019 (UTC)
@EugeneZelenko: I added code to strip the spans and brs, though I am adding the paragraphs to separate the different elements that are going into the Description. I also code to add en tags to any text fields missing them (not the Unit Code, though, since it's a technical code). BMacZero (talk) 19:09, 13 May 2019 (UTC)

Hazard-Bot (talk · contribs) [17]Edit

Operator: Hazard-SJ (talk · contributions · Number of edits · recent activity · block log · User rights log · uploads · Global account information)

Bot's tasks for which permission is being sought: Removing empty daily sections from Commons:Village pump

My bot currently adds these sections daily, and the purpose of this request is to seek approval to also remove them once all their subsections are archived.
The level 1 headings were being incorrectly archived by ArchiverBot as part of the preceding level 2 section, as described in this discussion. In order to continue having the dated sections, but not have them being incorrectly archived, the User:SpBot is currently archiving the VP.
However, regardless of which bot does the archival, if both bots leave the level 1 section heading behind, then they will need to be manually removed (e.g. Special:Diff/347530623, Special:Diff/347675949, Special:Diff/348857696, Special:Diff/348554724, etc.).

I am seeking permission to have my bot also remove these sections if they are empty (and not for the current day).

Automatic or manually assisted: automatic

Edit type (e.g. Continuous, daily, one time run): daily

Maximum edit rate (e.g. edits per minute): under 5 edits per day (and usually not that many) - depending on how frequently the page is archived, I'll try to have it run fairly close in trail to reduce the amount of time the empty sections sit around, so this may get tweaked based on which bot is archiving etc.

Bot flag requested: (Y/N): N

Programming language(s): Python

See Commons talk:Village_pump#First section header (permalink above) for the current discussion about this issue. Hazard SJ 21:29, 5 May 2019 (UTC)


  •   Comment On average, removal should only happen once a day, but you could check as often as the API allows.   — Jeff G. please ping or talk to me 21:43, 5 May 2019 (UTC)
  • Please make a test run. Probably empty daily header should be added artificially. --EugeneZelenko (talk) 13:57, 6 May 2019 (UTC)
    • I found at least one such removal was done. whym (talk) 11:22, 7 May 2019 (UTC)
      @Euku: In the edit before that, SpBot did not archive the "Commons:Photo challenge February results" section from "April 08", do you know why?   — Jeff G. please ping or talk to me 11:35, 7 May 2019 (UTC)
      There's a comment in that section from April 24, which is not yet 14 days old.  Hazard SJ  14:32, 7 May 2019 (UTC)
  •   Support If a bot adds section headers, it is sensible for the same bot to remove them, after they become unnecessary. As I understand, this change is a necessary step to complete Hazard-Bot and SpBot's job there. (I think I could re-enable ArchiverBot, but apparently that's not necessary?) whym (talk) 11:22, 7 May 2019 (UTC)
    @Whym: If ArchiverBot continues to treat headings like any other text within the section above it, then not quite: it will continue to archive a level 1 heading that immediately follows a level 2 section that is being archived (re-using the example Jeff G. shared, Special:Diff/326974187 and Special:Diff/326974179), which is undesirable behavior that had gone unnoticed for a long time (SpBot doesn't seem to have that issue). If it can properly treat it as a separate section instead, then yes; I had left a comment that may or may not help with ArchiverBot supporting that (not sure if you saw it): Special:Diff/347181763.  Hazard SJ  14:46, 7 May 2019 (UTC)
@Whym: For a setup like in the VP and HD the ArchiveBot is not necessary at all, but SpBot does not support all of the Miszabot config features.
@Hazard-SJ: For the test run as requested by Eugene you could set the timeout span for SpBot to 7 days like it was set up before (I’ve set it to 14; I would be happy if you’d let a notice for me about this). Then you wait for SpBot’s job, so you should get plenty of empty level 1 sections and could test your bot. — Speravir – 00:14, 9 May 2019 (UTC)
@Speravir: Done just now, thanks for the suggestion.  Hazard SJ  17:21, 13 May 2019 (UTC)
I see. While I might try fixing it later, I'm happy with the current setup of VP that does not contain ArchiverBot, to be clear. whym (talk) 11:43, 14 May 2019 (UTC)
@EugeneZelenko, Hazard-SJ: The test run was successful: Special:Diff/350162226/350162432. Is this enough or should there be more of these? — Speravir – 16:42, 14 May 2019 (UTC)
Looks OK for me. You could differentiate edit summaries for section adding and removal, but this is not critical. --EugeneZelenko (talk) 13:51, 15 May 2019 (UTC)
I actually planned to do that (I’m already keeping track of how many sections were removed and whether or not a new section was added), but haven’t gotten around to fully testing and implementing that into the summary as yet. Technically, a single edit could contain removals and an addition. I hope to look more into that in a week or so when I should have more time to finish that up; I could get back to you when that’s done.  Hazard SJ  18:10, 16 May 2019 (UTC)
Even for addition and removal in single edit you could list added and removed sections. --EugeneZelenko (talk) 14:23, 18 May 2019 (UTC)