PbnTools - help
This is a shortened help. Full version available in Polish.
- 1 Introduction
- 2 License
- 3 Functionality
- 3.1 Download Kops
- 3.2 Download Pary
- 3.3 Download Bbo
- 3.4 Deal cards
- 3.5 Converting LIN to PBN
- 3.6 Configuration
- 3.7 Command line
- 3.8 Options through Java parameters
- 4 Requirements
- 5 Download
- 6 Development
- 7 Version history
- 8 Ending
PbnTools is intended as a toolkit for files containing bridge deals. Most popular format for these is PBN.
Currently PbnTools has following funcionalities:
- Download Kops
- Downloads tournaments in Kops format and saves it as PBN files.
- Download Pary
- Downloads tournaments in Pary format and saves it as PBN files.
- Download Bbo
- Downloads tournaments from BBO server and saves it as PBN files.
- Deal cards
- Help in manual duplication of bridge boards from pbn files. Requires an internet camera and barcoded playing cards.
Program is started with the file PbnTools.exe (Windows) or pbntools (linux).
GNU GPL license, version 3 or later. Some individual files are licensed with more permissive MIT License, but this regards only to files that contain MIT License header.
The program uses following software:
is a JAVATM library that decodes, converts and plays MP3 files in real-time.
Distributed under LGPL license.
See files jlayer_LICENSE.txt and jlayer_README.txt in program directory.
jsoup is a Java library for working with real-world HTML.
It provides a very convenient API for extracting and manipulating data,
using the best of DOM, CSS, and jquery-like methods.
Distributed under MIT license.
See jsoup_LICENSE.txt in program directory.
(or its clone
is an open source software suite for reading bar codes from various sources,
such as video streams, image files and raw intensity sensors.
Distributed under LGPL 2.1 (or later) license.
Here is applied a limited version reading pictures from a video camera.
A license file: zbar_LICENSE.txt
Windows version uses also:
- wget for windows,
belonging to GnuWin32,
is a tool for recursive download of web pages, together with all needed files.
License file: wget_COPYING.txt.
This html document was generated using the LaTeX2HTML translator.
Source codes are available in section Download (5.2).
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.
Bridge Base Online , then Hand Records, results of recent tournaments, Pairs. The right link is under Show boards label.
The PBN file obtained with this download contains also bidding and play information.
Donwload process doesn't overload the server much, just like viewing all travellers.
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.
- Internet video camera
- The best in this case are cameras with manual focus adjustment (with a knob).
- Karty z kodami paskowymi
- Cards licensed by Jannersten should be used, format WIN.
Lin to Pbn conversion may be performed using GUI or command line interface.
- Working directory
- Zbarcam options
- Additional options passed to zbarcam.
A video device may be specified this way as e.g.
/dev/video1. Default (first) device has number 0. Full options list is available in file zbarcam.html.
- User agent
- User agent parameter for www requests. An empty string is equivalent of PbnTools/version.
- www delay
- A delay between consecutive www requests, in seconds.
Minimum: 1. For Bbo the value of 4 is suggested,
otherwise 503 errors may appear in download log.
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
Additional configuration may be applied using Java virtual machine (JVM) properties. The following properties are available:
jsoup.log.folderDirectory, to which all files downloaded by JSoup library will be saved. Used for diagnostics purposes.
ento 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.2.4:
- PbnTools 1.2.4 PbnTools 1.2.3 , PbnTools 1.2.2 , PbnTools 1.2.1 , PbnTools 1.2.0 , PbnTools 1.1.0 or see Development, section 6
- jsoup-1.7.3-sources.jar jsoup-1.7.1-sources.jar jsoup-1.6.1-sources.jar
- wget for windows
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:
submit bugs and suggestions.
- Dedicated forum
- GIT - source code, thanks to
git clone https://github.com/jarekczek/pbntools.git svn checkout svn://svn.code.sf.net/p/pbntools/code/trunk pbntools-code-directory
Guidelines for source code are in file README.SRC.txt, in source code archive, see: Download, 5.
- Sun Java Development Kit, JDK 1.6.
- ant, Debian package name: ant. Main build tool.
- BeanShell, bsh-2.0b4.jar (or newer) pointed in build.xml
- launch4j, to create exe file for Windows.
- Latex tools for documentation. Debian package name: latex2html.
- For building zbar additional tools are needed. Building zbar is not necessary.
- for auto-test targets.
- 1.2.4, 12.04.2018
- Messages on BBO login failure.
- 1.2.3, 17.03.2018
- results.csv and results_ranked.csv files from BBO, colon as separator.
- 1.2.2, 12.03.2018
- BBO download with authentication (obligatory) 64 .
- results.csv file generation from BBO (experimental).
- 1.2.1, 27.11.2013
- 1.2.0, 24.11.2013
- Downloading of Bbo tournaments.
- Lin to pbn conversion.
- User agent option in configuration dialog.
- New configuration option: www delay.
- Pary download improvements.
- 1.1.0, 16.09.2012
- Downloading tournaments in Pary format, i.e. warsbrydz , Wyniki, WOB, stare.
- Switched barcode video library for dealing cards on Windows to the one using DirectShow driver instead of Video for Windows. This should remove most problems experienced by Windows users.
- 1.0.3, 05.04.2012
- Check for updates option in About window.
- Zbar modification, to handle cameras providing picture in MJPG format.
- Made the app visible in taskbar.
- 1.0.2, 01.11.2011
- Fixing PBN format.
- Fixing PBN format.
- 1.0.1, 01.11.2011
- Ignoring robots.txt file during tournament download.
- 1.0.0, 01.11.2011
- First official release, under GNU GPL 3.0.
- Option Deal cards
- 0.5, 07.03.2010
- Private version.
- Option Download Kops.
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 April 12 2018