This is a shortened help. Full version available in Polish.
Currently PbnTools has following funcionalities:
Program is started with the file PbnTools.exe (Windows) or pbntools (linux).
The program uses following software:
Windows version uses also:
This html document was generated using the LaTeX2HTML translator.
Source codes are available in section Download (5.2).
Polish tournaments published in Kops format can be found on pages of Polish Contract Bridge Association (PZBS). Here are sample results. The best tournaments are labeled Chorz�w.
Program requires a link to a tournament. It should be a link labeled Wyniki, leading to a screen consisting of 2 frames: results and boards. Generated files are inserted into working directory (Configuration), in a subdirectory kops. Subdirectory is generated automatically.
Polish tournaments published in Pary format can be found on page warsbrydz, Wyniki, WOB, Stare.
Tournaments or hand records may be downloaded.
The PBN file obtained with this download contains also bidding and play information.
Download process doesn't overload the server much, just like viewing all travellers.
Use option Download hands / Hands type: Bbo.
The link that should be pasted into Download hands dialog should be obtained from Bridge Base Online , then Hand Records, results of recent tournaments, Pairs. The right link is under Show boards label.
Use option Download hands / Hands type: Bbo Hand records.
Hands history link should be used, obtained from Hand records screen by Get hands button. Example link:
https://www.bridgebase.com/myhands/hands.php?username=playersnick&start_time=1617573600&end_time=1617746400
Tournament Calculator is current software used in Polish tournaments, like MZBS. It replaced Kops and Pary. For download use the main link for results, e.g. 260330.
Dealing cards is done by showing cards to an internet camera, which "finds" the card in a given board and points to whom it should be dealt. Pointing is done by displaying player's sign and speaking it through the speaker. Currently Polish words are used: jeden, dwa, trzy, cztery, respectively for N, E, S, W.
Zbarcam parameters consist of built-in program defaults and user-configured options. They are visible in the dealing process in the textual window.
PCard and PCard2 modes are mutually exclusive; reading both at once may lead to false detections. By default only one standard is active; you can override that using your configuration.
Default parameters are not always optimal. Scanning may be slow or produce
false reads. You can speed up scanning using prescale and reduce false
positives using uncertainty.
Enable or disable a barcode standard. Last occurrence wins.
Example: -Spcard2.disable will disable PCard2 standard.
Camera often produces high resolution images which are unnecessary and
slow scanning. You may rescale the image, e.g. --prescale=640x480.
Provided dimensions must be supported by the camera as one of its modes.
Number of consecutive camera frames on which the barcode must appear.
Higher value increases certainty but takes proportionally longer.
Minimum value is 1. Default is 2.
Example: -Spcard2.uncertainty=3
Lin to Pbn conversion may be performed using GUI or command line interface.
/dev/video1.
Default (first) device has number 0.
To select which cards to use, you should disable the ones you don't have.
Initially both PCard and PCard2 is enabled.
You can add for example -Spcard.disable, then only PCard2 will be active.
Full options list is available in file zbarcam.html.
Part of the program functionality is available through command line interface. For example downloading tournaments.
pbntools -dtk http://www.strona-turniejow.pl/turniej999/index.html
Command line options may also be applied when calling jar file directly, for example:
java -jar PbnTools.jar -dtk http://www.strona-turniejow.pl/turniej999/index.html
For details on command line options please launch
pbntools -h
Additional configuration may be applied using Java virtual machine (JVM) properties. The following properties are available:
jsoup.log.folder Directory, to which all files
downloaded by JSoup library will be saved.
Used for diagnostics purposes.
user.language Set to pl or en to force the UI language.
An example of running the program with JVM parameter:
java -Djsoup.log.folder=C:/temp/bbo-jsoup -jar PbnTools.jar -dtk http://www.tournaments.pl/tour999/index.html
Java, version 6, is required. Platforms supported: Windows and Linux.
Current version, 1.6.0:
Old binaries: 1.5.0: Windows Linux , 1.4.0: Windows Linux , 1.3.3: Windows Linux , 1.3.2: Windows Linux , 1.3.1: Windows Linux , 1.3.0: Windows Linux , 1.2.7: Windows Linux , 1.2.6: Windows Linux , 1.2.5: Windows Linux , 1.2.4: Windows Linux , 1.2.3: Windows Linux , 1.2.2: Windows Linux , 1.2.1: Windows Linux , 1.2.0: Windows Linux , 1.1.0: Windows Linux
Sources for Apache HttpClient, Kotlin can be downloaded through maven repository. One can use gradle task, which is capable of downloading library sources.
Program is written mainly in Java. I encourage to contribute either by programming or by submitting bug reports and suggestions.
Following development means are available:
git clone https://github.com/jarekczek/pbntools.git
svn checkout svn://svn.code.sf.net/p/pbntools/code/trunk pbntools-code-directory
Browse code on-line, PbnTools at sourceforge,
Guidelines for source code are in file README.SRC.txt, in source code archive, see: Download, 5.
%USERPROFILE%/.PbnTools/PbnTools.log).
T instead of 10.
I am open for suggestions. I will be grateful for informations about incorrect operation of the program or a web-page.
Jarek Czekalski , last modification June 25 2026