Caissa Tools

Nederlands English

If you are interested in a version in your language then you can always contact me. I will send you a file with the texts that you need to translate and I will add them to the application with a word of thank to you.


Caissa Tools is a toolbox of tools that can be used to convert chess information from one format into another. At this moment there are 7 tools:

  1. Convert PGN games into DGT ChessTheatre input.
  2. Calculate the ELO for the players in a PGN file or files.
  3. Convert PGN games into 2 HTML pages.
  4. Convert PGN games into JSON format.
  5. Convert PGN games into LaTeX format.
  6. Create a PGN file for a tournament with all games.
  7. Create statistics on all games in a PGN file.
  8. Translate PGN on all games in a PGN file or from the command line.
+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Caissa Tools
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.1.2 | 2014-12-31 15:44:36

  ChessTheatre      Convert a file with PGN games into input for ChessTheatre.
  ELOBerekenaar     Calculate the ELO rating for the players in the PGN file.
  PgnToHtml         Convert the PGN file with games from a tournament into 2
                    HTML files. One file with the standing and the other with
                    the result matrix.
  PgnToJson         Convert the PGN file with games from a tournament into a
                    JSON file.
  PgnToLatex        Convert the PGN file with games from a tournament into a
                    .tex file.
  StartPgn          Make a PGN file with all games that need to be played
                    between the given users.
  SpelerStatistiek  Makes statistics on all games of a given player.
  VertaalPgn        Translate the piece codes from one language into another.

You can force the language to English with the parameter -Duser.language=en just before the -jar parameter.


top ChessTheatre

Description

On Windows it is no problem to publish your chess games with DGT ChessTheatre. On Linux there is nothing available. Lucky for us DGT is very open on this product. This tool gives you the possibility to publish your chess games with DGT ChessTheatre.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | ChessTheatre
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar ChessTheatre [OPTION...] --bestand=<PGN file>

  --bestand      The file with games in PGN format.
  --charsetin    The characterset of <bestand> if it is different from [cp].
  --charsetuit   The characterset of the output if it is different from
                 [cp].
  --maxBestanden Maximum number of files to hold the games. Default value is 50.
  --minPartijen  Minimum number of games per file. Default value is the total
                 number of games divided by maxBestanden.
  --uitvoerdir   Directory in which the output files are written.
  --zip          Name (can include a directory directory) of the zip file with
                 the games. Thise zip file is not created by the application.

Only parameter bestand is mandatory.

You will find the XML files in the same directory as <bestand> or in the directory that you defined in the uitvoerdir parameter. If you do not have that many chess games then the default value of 50 XML files might be a bit high. You can set the maxBestanden to a smaller value or set the minPartijen to a value that gives you less XML files.


top ELO Calculator

Description

The ELO rating is used to 'measure' the strength of a chess player. With this tool you calculate the rating of chess players with a PGN file of a tournament. The calculated ELO ratings are stored in a CVS file (spelerBestand) and can be used later as an input together with another PGN file to ajust the ELO ratings. Every change in rating is stored in the geschiedenisBestand file. This can be used to visualise the evolution of the ratings.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | ELO Calculator
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar ELOBerekenaar [OPTION...] \
    --spelerBestand=<CSV file> --toernooiBestand=<PGN file>

  --charsetin           The characterset of <bestand> if it is different from
                        [cp].
  --charsetuit          The characterset of the output if it is different from
                        [cp].
  --geschiedenisBestand The file (with .csv extension) with the evolution of
                        the ratings.
  --invoerdir           Directory from which the inputfiles are read.
  --spelerBestand       A CSV file (with .csv extension) with the latest
                        ratings of the players. This file is updated or created.
  --startDatum          A date after which the games count (yyyy.mm.dd).
  --startELO            The starting ELO points for unrated players. The
                        default value is 1,600.
  --toernooiBestand     The file with games from a tournament in PGN format.
  --uitvoerdir          Directory in which the output files are written.

The parameters spelerBestand and toernooiBestand are mandatory.

The parameters spelerBestand and geschiedenisBestand without directory.

You will find the <geschiedenisBestand> and <spelerBestand>files in the same directory as <toernooiBestand> or in the directory that you defined in the uitvoerdir parameter.


top PGN to HTML

Description

As a tournament leader I modify our website by adding the new results. The creation of game matrix is a donkeywork to make sure that the result was put in the right column. There were frequent errors. To make my life easier and reduce the errors I created this tool that uses a PGN file of the tournament. The tool created a HTML file with the matrix and a HTML file with the rankings. These two files can be used with SiteManager to include it on the right web pages.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes. The layout of the 2 pages are in 2 properties files in thee resource 'directory' of the jar. This way you can change the layout wiyhout changing the source.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to HTML
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToHtml [OPTION...] --bestand=<PGN file>

  --bestand    The file with games in PGN format.
  --charsetin  The characterset of <bestand> if it is different from [cp].
  --charsetuit The characterset of the output if it is different from [cp].
  --enkel      Single round <J|n> (J=Yes, N=No). Any other value gives a Match
               matrix.
  --halve      List of players (separated by a ;) that only plays the first
               half of the tournament. Only needed when enkel=N.
  --uitvoerdir Directory in which the output files are written.

Only parameter bestand is mandatory.

You will find the HTML files in the same directory as <bestand> or in the directory that you defined in the uitvoerdir parameter.


top PGN to JSON

Description

With the help of fellow chessplayer Nico I created a Javascript to replace ChessTheatre (It uses Flashplayer which is no longer supported everywhere). Since JavaScript works well with JSON and not with PGN I created this tool.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to JSON
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToJson [OPTION...] --bestand=<PGN bestand>

  --bestand    The file with games in PGN format.
  --charsetin  The characterset of  if it is different from UTF-8.
  --charsetuit The characterset of the output if it is different from UTF-8.
  --invoerdir  Directory from which the inputfiles are read.
  --json       The file with the games in JSON format.
  --pgnviewer  Add information for tee PGNViewer .
  --uitvoerdir Directory in which the output files are written.

Only parameter bestand is mandatory.

You will find the JSON file in the same directory as <bestand> or in the directory that you defined in the uitvoerdir parameter.


top PGN to LaTeX

Description

As a chess player and tournament leader I was looking for a way to put chess games in a PDF file together with a diagram of the final position. I use SCID as a database. In there I found an option to export games in LaTeX format. I processed the file with MiKTeX. Unfortunately the result did not please me. The final position had to be defined in SCID itself. I did not want to add it to all my games. I continued my search and I found SKAK. With this LaTeX package I could add a diagram of the final position without the need to put it in my games. I created this tool to generate the input for LaTeX. Because I only use it to put the chess games of 1 tournament in a PDF file I had the idea to add a matrix to it.

Usage

Execute the JAR with the appropriate parameters. The keywords are used in the header of the PDF file. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | PGN to LaTeX
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar PgnToLatex [OPTION...] --bestand=<PGN file>

  --auteur     The author or club that publishes the games.
  --bestand    The file with games in PGN format.
  --charsetin  The characterset of <bestand> if it is different from [cp].
  --charsetuit The characterset of the output if it is different from [cp].
  --datum      The date on which the games were played.
  --enkel      Single round <J|n> (J=Yes, N=No). Any other value gives a Match
               matrix.
  --halve      List of players (separated by a ;) that only plays the first
               half of the tournament. Only needed when enkel=N.
  --keywords   List of keywords (separated by a ;).
  --logo       Logo on the title page.
  --matrix     Result matrix <J|n> (J=Yes, N=No).
  --template   Een template voor het uitvoer TEX bestand. 
  --titel      The title of the document.

Only parameter bestand is mandatory.

You will find the TEX file in the same directory as <bestand>.


top Start PGN

Description

Nothing takes up more time than the creation of a database for a tournament. With this tool you create a PGN file with all the games between all players. The results are undecided. This way you only need to enter the results.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Start PGN
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar StartPgn --bestand=<PGN file>
    --date=<date> --event=<event> --site=<site> \
    --spelers=<player1>[;<player2>...] \
    [--uitvoerdir=<output-directory>]

  --bestand    The file with games in PGN format.
  --charsetin  The characterset of <bestand> if it is different from [cp].
  --charsetuit The characterset of the output if it is different from [cp].
  --date       Date of the tournament.
  --event      Name of the tournament.
  --site       Place where the tournament is played.
  --spelers    List of players (separated by a ;).
  --uitvoerdir Directory in which the output files are written.

All parameters (except uitvoerdir) are mandatory.

You will find the PGN file in the same directory in which you execute the command or in the directory that you defined in the uitvoerdir parameter.


top Statistics

Description

You have all your games in a PGN file and you want to know against who you perform best or in which year you played best. With this tool you can make all kind of statistics based on the different PGN tags.

Usage

Execute the JAR with the appropriate parameters. Be careful with spaces. If the value of a parameter contains a space then you must put the whole value of the parameter between double quotes.

+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Player Statistics
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar SpelerStatistiek [OPTION...] \
    --bestand=<PGN file> --speler=<Player's name>

  --bestand    The file with games in PGN format.
  --charsetin  The characterset of <bestand> if it is different from [cp].
  --charsetuit The characterset of the output if it is different from [cp].
  --logo       Logo on the title page.
  --speler     The speler for whom the statistics are made.
  --tag        The PGN tag on which the statistics are based. Without this
               parameter the opponents are taken. With the tag "date" the year
               is used.

The parameters bestand and speler are mandatory.

You will find the TEX file in the same directory as <bestand>.


top Translate PGN

Description

You sometimes get a PGN file with the codes of the pieces in a different language than you chess database uses. Instead of doing several times search-and-replace you can also use this tool to do the job.

Usage

Execute the JAR with the appropriate parameters.
+----------+----------+----------+----------+----------+----------+----------+
|          |          |
|   |\__   *   __/|   | Translate PGN
|   /  .\ *** /.   \  |
|  | ( _ \ * / _ ) |  |
+--|    \_) (_/    |--+----------+----------+----------+----------+----------+
|  |    |     |    |  |
|  /_____\   /_____\  |
| [_______]_[_______] | E-Mail : noreply@debooy.eu
|       [_____]       | Website: https://www.debooy.eu
+----------+----------+----------+----------+----------+----------+----------+
                                                 v1.2.0 | 2017-12-28 19:45:25

java -jar CaissaTools.jar VertaalPgn [OPTION...]

  --bestand    The file with games in PGN format.
  --charsetin  The characterset of <bestand> if it is different from [cp].
  --charsetuit The characterset of the output if it is different from [cp].
  --naartaal   The output language if it is different from: [lang]
  --pgn        The moves that need to be translated. Put them between ".
  --vantaal    The input language if it is different from: [lang]

The input can be a PGN file (<bestand>) or a parameter <pgn>. In case of a
<bestand> a file will be created that has the same name but with a postfix of
an _ and the <naartaal>.

The languages that you can use are CZ, DA, DE, EN, ES, ET, FI, FR, HU, IS, IT, NL, NO, PL, PT, RO, SV, and UTF8.


Version Date Modification
1.2.0 2017/12/28 A PGN file can now be transformed into a JSON file.
1.1.2 2014/12/31 The CSV file that holds the players and their ELO rating was corrupted when the ELO ratings were modified. The name was not properly surrounded by double quotes.
1.1.1 2014/10/09 All gamedataX.xml files, except the last one, were not closed. As a result you got files of 8192 or 0 bytes.
1.1.0 2014/09/30 Some bugs removed.
The layout of the index.html and matrix.html are stored in 2 properties files in thee resource 'directory' of the jar. This way you can change the layout without changing the source.
1.0.0 2013/11/22 Some bugs removed.
First multi-lingual version. Available in Dutch and English.
There is now also the tool VertaalPgn to translate the characters from one language to another.
The PgnToLatex tool now generates a game matrix for matches.
0.5.0 2012/04/21 Some bugs removed.
There is now also the tool ELOBerekenaar to calculate the ELO ratings of the players based on a PGN file.
The tool PDF to Latex can now put the title, author, and keywords in the PDF header. The standard paper format is now A4.
0.4.1 2011/05/08 ChessTheatre did not work correct. PGN with a TAB character now works correct and the Round tag can now contain multiple levels.
From now on PgnToHtml only makes the tables in HTML. The must be included in the 'real' HTML pages. You can use SiteManager to include them in the 'real' HTML page(s).
0.4.0 2011/04/17 On Windows it is no problem to publish your chess games with DGT ChessTheatre. On Linux there is nothing available. Lucky for us DGT is very open on this product. This tool gives you the possibility to publish your chess games with DGT ChessTheatre.
0.3.1 2010/12/04 After my switch from Windows to Linux I had problems with accentuated characters. The reason for this is that in Windows I used ISO-8859-1 and on Linux I use UTF-8.
There is now a new tool for player Statistics.

Downloads