LibreTT

DESKTOP APPLICATION · DOCUMENTATION

LibreTT documentation

Learn how to install LibreTT and run a table tennis tournament, from your first player registration to final standings. Your data stays on your computer and the app works offline.

This guide follows the current desktop documentation. Some features may require a newer build than the first beta available on the download page.

Install LibreTT

Choose your platform on the Download page. Windows and Linux packages are x64; macOS has separate Intel x64 and Apple Silicon ARM64 installers.

Windows · x64

Download the EXE installer, run the setup wizard and launch LibreTT from the Start menu. The installer includes the WebView2 runtime for offline installation. If you downloaded a ZIP from GitHub, extract it first.

This beta is unsigned. If SmartScreen shows an unknown publisher warning and you trust the download source, choose More info Run anyway when available. If your computer policy blocks it, contact your administrator. Do not bypass antivirus warnings identifying malware.

macOS · Intel or Apple Silicon

Check About This Mac to find your processor. Choose ARM64 for Apple Silicon (M-series) or x64 for Intel. Open the DMG, drag LibreTT into Applications, launch it from Applications and eject the DMG afterwards.

The beta is not notarized. If macOS blocks a trusted download because the developer cannot be verified, try opening the app, then use System Settings Privacy & Security Open Anyway. Do not disable system protection globally or bypass a malware warning.

Linux · Debian / Ubuntu

Download the .deb package and install it with your package manager. From the directory containing the download, you can run:

sudo apt install ./LibreTT_0.1.0-beta.1_linux-x64.deb

Linux · AppImage

For Fedora and other distributions, download AppImage, make the file executable and run it:

chmod +x LibreTT_0.1.0-beta.1_linux-x64.AppImage
./LibreTT_0.1.0-beta.1_linux-x64.AppImage

AppImage runs directly without a traditional installation. You can keep it in ~/Applications. Linux packages still require compatible system libraries; if it fails to start, report the exact terminal message.

Before updating an existing installation, close LibreTT and make a backup. Installers contain the application, not your database. The first beta still needs validation in real tournaments; keep a backup and a parallel record for your first event.

Run a tournament

Follow the steps in order. Skip anything you have already done. You can reopen this guide from the left menu at any time.

1. Create a tournament

  1. Open Tournaments in the left menu and choose Add tournament.
  2. Enter a name, such as “Bubušinac 2027”. A cover image is optional.
  3. Save, then open the tournament card.

2. Add players

  1. Open Players in the left menu and add a player.
  2. Enter their name, birth year and club. Birth year is required; photos and contact details are optional.
  3. Choose an existing club name when available. Check any similar-name suggestion and click it to accept it.

Correct clubs before registration: editing a profile does not change the club saved in an existing registration.

3. Create categories

  1. Open the tournament, then Categories Add category.
  2. Enter a name such as “Singles 40+”. Choose singles or doubles.
  3. Choose direct knockout or groups followed by knockout. For groups, set the number of groups and qualifiers per group.
  4. Set the number of sets, points to win a set and winning margin. Enable an age range if needed.
  5. Choose BYE or lucky losers, the third-place rule, and whether clubmates may share an automatic group. Save.

Age limits show a warning; organizers may confirm exceptions. Agree the rules with your tournament organizers before starting.

4. Register participants

  1. Open a category, then Registrations.
  2. Choose players and save their registrations. For doubles, build a pair of two different players.
  3. Repeat for every category. A player may enter several categories.
  4. Check names, clubs and participant counts before creating the draw.

5. Confirm arrivals

  1. When a player arrives, mark them as arrived in Registrations.
  2. Arrival applies across that tournament. Confirm both doubles members.
  3. Withdraw registrations for players who drop out before the category starts.

Before the first result, the app checks arrivals. An explicit organizer override allows starting without every arrival; it does not enable collecting payment from unconfirmed arrivals.

6. Record entry fees

  1. Open the tournament Cash desk.
  2. For an arrived player, select the categories they are paying for and record payment.
  3. Check outstanding balances and payments. Unconfirmed arrivals show an expected amount.
  4. Use the refund action if you return money.

The cash desk remains available after tournament completion.

7. Create and check the draw

  1. Open category Settings and find Seeds and arrangement.
  2. Add seeds in order, strongest first, if applicable.
  3. Choose automatic or manual arrangement, generate it, check every place, then save the draft.
  4. Open Groups for group standings and Draw for the knockout bracket. Direct knockout has no group phase.
  5. Use Draw Edit to change opening-round places. Group knockout editing is available after all groups finish and standings are resolved.

If club separation cannot find a layout, check club names, seeds and group count, or choose a manual layout.

8. Make a backup

  1. Open Backups in the left menu.
  2. Choose Create backup before matches begin.
  3. Export a copy and copy the exported file elsewhere, such as a USB drive, if needed.

A backup includes this tournament and the rest of the application database.

9. Enter match results

  1. Open category Matches and choose the group and round or knockout stage.
  2. Choose Edit on the correct match. If assigning a table, enter its number and save the table first.
  3. Enter each set’s points, such as 11:7, 11:9 and 11:5. Required set wins depend on the category rules.
  4. Use Played match for a normal ending. Choose Retired for withdrawal during a match or Walkover for a no-show, then choose the winner.
  5. Save the result and check that the correct winner is shown.

Saved results update group standings and subsequent knockout matches. Do not enter extra sets once the match has been decided.

10. Finish groups and check qualifiers

  1. If using groups, enter every group match and open Groups.
  2. If standings remain tied, check results and confirm a manual ranking if needed.
  3. Check qualifiers and lucky-loser places in Draw. Automatic selection waits for every group to finish.
  4. For manual selection, use Draw Edit to choose an entrant or BYE. Resolve any tied automatic candidates at the final available place manually.

BYE means automatic advance. A lucky loser is an entrant below the qualification cutoff who receives an extra place. Automatic filling uses BYE for remaining places if there are not enough candidates.

11. Complete each category

  1. Enter knockout results through the final, including a bronze match if the rules require one.
  2. Open Results and check final standings. The app lists anything still needed.
  3. Choose Complete category and confirm. Repeat for all categories.

Completion locks registrations, rules, draws and results. Reopen a category in Results before making corrections.

12. Complete the tournament and save reports

  1. Open tournament Overview and check that every active category is complete.
  2. Choose Complete tournament and confirm.
  3. Where report controls are available, use Print / PDF, CSV or HTML to save or print reports.
  4. Create another backup and export it to a safe location.

For corrections after tournament completion, reopen the tournament in Overview, then the category in Results. Confirm both completions again afterwards.

If you get stuck

I entered the wrong result.

Edit the same match and save the correction. If subsequent participants change, the app asks before clearing dependent results. Check those matches and enter valid results after confirmation.

A player withdrew after the category started.

Keep the registration. Record Retired or Walkover in the affected matches and choose the winner. Started categories cannot be removed.

I want a new draw or scoring rules after play starts.

A new draw requires confirmation and starts without previous scores or table assignments. Old records stay in history. Scoring changes also require confirmation: old results keep their original rules; subsequent entries and corrections use the new rules.

Where can I see changes?

Open History in the left menu. Newest actions appear first. Filter by tournament, history type or action, then expand record details.

How do I restore a backup?

Open Backups and choose Restore data or Restore from file. This replaces the whole database, not just one tournament. The app saves the current database first, then reloads and closes open tabs.

What do these words mean?

  • Category: A separate competition within a tournament, such as singles 40+ or doubles.
  • Seed: A participant ranked by the organizer for draw placement.
  • Knockout: Winners advance; losers leave the contest for first place.
  • Set: One part of a match. A match is won by winning the required number of sets.

Help and source documentation

Need help? Report an issue on GitHub or email support. Include your OS, application version, what you were doing and the exact error message. Avoid sharing player records or an unredacted database publicly.