Installation Notes - peteschaefer/jose GitHub Wiki

1. Download Package

• Download the appropriate package for Windows, macOS, resp. Linux.

• Download the latest patch package

• Unpack both Zip files into a directory of your choice

• Run:

  • jose.exe on Windows
  • jose.shon Linux
  • double click 'jose' app on macOS

• when starting for the first time, jose will ask you to create a fresh database. Click Create.

• Leela and Stockfish are pre-installed to be used as analysis and playing engines.

  • Press F9 to edit engine settings
  • or add any other UCI-compatible engine

• Linux: when starting jose.sh for the first time, a desktop file jose.desktop will be created. Copy it to /usr/share/applications, if you like.

2. Setting up Leela

• the bundled version comes with rather minimal hardware requirements
• if you have a somewhat decent GPU at your disposal, you should consider upgrading Lc0 by:
  • choosing an appropriate executable (see lczero.org/play/download)
  • a more powerful neural network (see [lczero.org/play/networks/bestnets] (https://lczero.org/play/networks/bestnets/))
  • Mac users can install Lc0 conveniently using: brew install lc0
  • Linux users have more work to do: README.md

3. Upgrading from an Old Version

• backup the existing database directory. It's a good idea to make such backups regularly.

• backup engine configurations config/lc0.xml, config/stockfish.xml etc.

• unzip the new package, either in a new folder, or on top of the old installation

• move over the backed-up files

• if, for some reason, the database gets corrupted, do not despair!

• "Help / Repair Database..." can fix almost any case.

4. Adding Games

There are some game collections for download (10.000 games, 500.000 games, 1.7 million games). You are free to add games from any PGN (portable game notation) file.

Shooting Trouble with Hi-DPI Displays

• Windows, MacOS: should work out of the box (from version 1.5.1)

• Linux: jose makes an effort to determine the scaling factor automatically. If this does not work, for some reason, you can set it manually: see shell script jose.sh. Fractional scaling is not supported.