# The &chessament; Handbook

## Introduction

&chessament; is a chess tournament manager. It supports individual Swiss-system tournaments.

Main features of &chessament;:

- Registering players.

- Pairing rounds.

- Calculating standings.

## Basic Usage

### Creating a New Tournament

To create a new &chessament; tournament, select File New…, enter a name, choose the number of rounds, and click Save. You will be asked to choose a location where you want to save the tournament.

### Registering Players

To add a new player to the tournament click on the Add Player… button in the toolbar.

### Pairings & Results

After you have finished registering all the players of the tournament, you can now make the pairings for the first round. Go to the Pairings view and click on the Pair Round 1… button. A dialog will appear where you can customize some options for the first round. It is recommended that you leave the Sort players option enabled. You can choose the color of the pieces of the highest ranked player, or let &chessament; choose a random color for you.

To enter the results, click on a pairing and choose from one of the supported results at the bottom. You can also enter the results using the keyboard. Pressing 1 sets the result to White wins, 0 to Black wins and 5 to draw. After entering a result, the next pairing without a result is automatically selected.

### Viewing Standings

To view the standings of the tournament, go to the Standings view. From there you can choose to view the final standings or the standings from a previous round.

## Tournaments

### Settings

To open the settings window of a tournament, click on the Settings button at the bottom of the &chessament; window. This section describes the available options in details.

#### Information

In this section you can set some basic information such as the tournament's name, location, and arbiters.

#### Format

In this section you can configure the number of rounds of the tournament and the tiebreaks used for calculating the standings. More information about the tiebreaks is available in the Tiebreaks section.

#### Calendar

In this section you can set the tournament's schedule.

### Tiebreaks

&chessament; supports the following tiebreaks as described in the FIDE Handbook:

- Average Buchholz of Opponents (AOB)

- Buchholz (BH)

- Number of Games Played with Black (BPG)

- Number of Games Won (over the board) (WON)

- Number of Wins (WIN)

- Points (PTS)

## Reference

### The Menubar

#### The File Menu

File New tournament…

- Create a new tournament. If there is already an opened tournament it will be closed.

&Ctrl;O File Open…

- Open a &chessament; file.

&Ctrl;&Shift;S File Save As…

- Save the tournament under a new name.

&Ctrl;I File Import tournament report…

- Import a Tournament Report File (TRF). If there is already a opened tournament it will be closed.

File Export tournament report…

- Export the current tournament to a Tournament Report File (TRF).

#### The View Menu

&Ctrl;&Alt;I View Open Command Bar

- Opens the command bar.

#### The Settings Menu

&Ctrl;&Alt;, Settings Configure Keyboard Shortcuts…

- Opens the Keyboard Shortcuts window.

&Ctrl;&Shift;, Settings Configure Chessament…

- Opens &chessament; Settings window.

### Command Line Options

``chessament` `--import-trf `file```

- Import a Tournament Report File (TRF) as a new tournament.

## Credits and License

Documentation Copyright © &Manuel.Alcaraz.Zambrano; &Manuel.Alcaraz.Zambrano.mail;

&underCCBYSA4; &underGPL;
&documentation.index;