BBO Extractor

Release Notes

BBOtoXML webapp version 1.3 - 5th August 2020

Supports conversion of BBO Swiss Teams events. Awards per match are calculated for EBU (36+ boards and 6+ boards per round), SBU (20+ boards/5+ boards per round), WBU (36+ boards, 1+ bpr).

BBOtoXML webapp version 1.2.9 - 1st August 2020

Version 1.2.9 includes several new features:

BBOtoXML will report an error, and will not do the merge, if any of the above conditions is not met.

The procedure for merging is similar that for merging two Teams of Four matches:

BBOtoXML webapp version 1.2.8 - 10th July 2020

Version 1.2.8 includes several new features:

  1. Phase 1 of Swiss Pairs support - see Notes below

  2. A League match between two teams of four can be played on BBO as two events, with the NS and EW pairs of one team swapping places for the second event. Such events can now be merged in BBOtoXML and uploaded as a single event to Bridgewebs, Pianola, EBU/UMS etc. See Notes below.

  3. Date and Event Title can be edited (use the Review/Edit CSV menu button). See Notes below

  4. Scoring now calculates a true Ave+, or Ave-, e.g. if 60% is entered, and the pair scored an average of more than 60% across other boards, then that value is used in place of 60%


Swiss Pairs:

League Matches between two Teams of Four, played as two BBO events:

  1. Run BBO Extractor to produce a CSV file for each event
  2. Run BBOtoXML. Select "Review/Edit CSV" to load the first Teams Event.
  3. Select "Merge CSV" to load the second Teams event.
  4. Two new buttons will appear - "Generate PBN" and "Save CSV"
  5. You can edit the title of the combined event and the date
  6. Use the two buttons to generate a PBN file for the combined event and a CSV file for the combined event (boards for the second event are automatically renumbered, e.g 17 upwards, or 33 upwards, to preserve the vulnerability pattern)
  7. Click on Go Back to go back to the main BBOtoXML screen.
  8. Click on "Create XML..." and select the CSV of the merged event to generate the XML for the merged event

The above procedure requires that the same player names appear in both events, i.e. the names have to be identical, though it will normally be the case that EW and NS have swapped places in one of the teams.

Modification of Date

The BBO results pages always appear to show the date in the time zone of the BBO server, irrespective of the location of the person who is extracting the event data. This means, for example, that ACBL evening events may have the wrong date, depending on the time at which the event commenced. The date modification feature provides a way of correcting this prior to conversion to XML.

BBOtoXML webapp version 1.2.7 - 5th July 2020

Changes in the BBOtoXML release v1.2.7:

  1. EBU masterpoints now supported for 25+ tables single winner movements

  2. ABF masterpoints – new implementation.

  3. CBAI masterpoints updated.

  4. ACBL multicoloured masterpoints and strats implemented.

BBO Extractor Version 1.3.1 - 25th June 2020

This release speeds up the extraction process. When the extractor is updated in the browser, you will be asked to allow new permissions.

BBOtoXML webapp version 1.2.5 - 23rd June 2020

This release adds several new features:

  1. Contract/Score editing, which means it is no longer necessary to import the XML file produced by BBOtoXML into a scoring program, if the only reason for doing so is to correct scores
  2. It's now possible to generate a list of "missing names", i.e. bbonames who played in the event, but for which no match was found in the names file
  3. It's also possible to generate a list of "missing NBO IDs", i.e. bbonames who played in the event, and had a matching player name, but had no NBO Player ID in the names file
  4. List of identified substitutions. Almost all cases where substitutions occur are now detected and resolved automatically. BBOtoXML can show a "substitutions table" which lists, for each pair number where substitution occurred, all the pair names identified as corresponding to that pair number

See BBOtoXML Web App for details.

BBOtoXML webapp version 1.2.4 - 22nd June 2020

The Masterpoint area has been redesigned to support not just EBU but also some other bridge unions. EBU, ACBL and SBU (Scotland) master points are now supported, work is still in progress to complete the masterpoints for the other bridge unions.

BBO Extractor Version 1.2.8 - 7th June 2020


  1. Bug fix in Team support for matches between 2 Teams of Four. When a tournament page is retrieved via a hand record search, rather than via the BBO tournament history, it has an additional parameter of the form "u=bboname", where bboname is the username of a player. If that particular player played East/West in the match, then the polarity of the results on the tournament page is shown reversed, but BBO Extractor did not take account of this. The issue has been corrected in the new release.
  2. Allocated NS and EW pair numbers now fall into two non-overlapping ranges. Previously they could be interspersed in the case of a multi-section event, and this situation could not be handled correctly by EBUScore if the event was imported.
  3. More cases where substitutions occur, or where a robot pair is used, are now resolved automatically (i.e. the pair number is allocated automatically, rather than requiring the CSV to be edited to resolve pair numbers with a "Sub" prefix)
  4. Conversion from bbonames to player names now includes substituting the player names in the BBO play data, so that they will be displayed in the top left of the Bridge Solver Online display (when clicking on a "Play" link in the last column of a Bridgewebs traveller).

BBO Extractor Version 1.2.6 and
BBOtoXML webapp Version 1.2.3 - 3rd June 2020

The latest releases of BBO Extractor (v1.2.6) and BBOtoXML (v1.2.3) now support extraction and conversion to XML for BBO matches of two Teams of Four.

BBO Extractor Version 1.2.4-1.2.5 - 19 May 2020

The latest release of BBO Extractor now completes the extraction process much faster for large events. Previously, it used to obtain the detailed results by scanning player scorecards. The new release is optimised to minimise the number of BBO retrievals required, by scanning either scorecards or travellers depending on the relative number of pairs and boards. For example, for a 24 board event with fewer than 12 tables it is more efficient to scan scorecards, but for a larger number of tables it is quicker to scan travellers. This means that extracting the results for an event with 90 tables will take no longer than for an event with 12 tables, assuming a 24 board event in both cases.

This improvement is implemented in BBO Extractor v1.2.4 onward (now v1.2.5). Your chrome browser will normally update automatically if you close all browser windows and re-open it.

We have also updated the website. In particular it now contains more detail about uploading to Bridgewebs. This procedure has been a source of confusion to some clubs, who have uploaded the XML file produced by BBOtoXML, but at the same time have attempted to utilise the "BBO Online" tab in Bridgewebs results admin to link to a BBO version of the results. Doing the latter overrides some of the data uploaded via the XML route, with unpredictable effects on the Bridgewebs results display. Hopefully, this will be fixed in BridgeWebs soon, but please make others, who may not be on our contacts list, aware of this issue and of the aforementioned link.

With the recent enhancements we believe that BBO Extractor/BBOtoXML is now the best solution for getting detailed results from a BBO tournament onto a club website:

  1. Completely browser based, so runs on PC or Mac (using google chrome, or any browser that supports chrome extensions, e.g latest downloadable version of Microsoft Edge). Can even run on android phone/tablet using Yandex browser.
  2. Choice of Neuberg scoring, or matching BBO Results (which do not use Neuberg)
  3. Optimises extraction speed depending on relative number of tables and pairs in a tournament.
  4. When uploaded to BridgeWebs, displays a "play" link for each row of the Bridgewebs traveller, allowing bidding/play of the hand at any table to be reviewed/replayed/explored with double dummy card by card guidance.

BBOtoXML webapp Version 1.2.0 - 15 May 2020
  1. It is now possible to perform the BBO names to player names conversion in this app, rather than in BBO Extractor. Use the "Load Names" button to import the names prior to clicking on "Create XML...".

  2. The previous version of the app presented the results as calculated by BBO. However, BBO does not apply the Neuberg formula, which is generally used with electronic scoring. Therefore, we have introduced the option to enable Neuberg scoring. For compatibility with the previous app version, the default setting when the new app is initially loaded is still "Scoring Matches BBO", but if "Enhanced Scoring (Neuberg)" is selected it will become the new default for subsequent sessions unless deselected again. Selecting Neuberg scoring may of course affect pair ranking order in some cases, such that it is different to the order shown on BBO's own results pages.