Docker ShogiGUI + Yaneuraou

This repository aims at easily bringing ShogiGUI + YaneuraOu to Linux.

It is centered around a helper script (named docker-shogigui) to do all the dirty work for you (building / running the docker image, with install / setup of shogiGUI, compilation of YaneuraOu, configuration with NNUE eval functions, and much more...)

The default configuration file provided sets the following options :

• English language
• Set up japanese fonts to look better
• Multiple engines configured (YaneuraOu + elmo / suisho / orqha-1018)
• Disable sound (see "Troubleshooting" below)
• Allow the usage of simplified pieces (see "Simplified pieces" below)

Prerequisites

You need to install docker so that it is controllable by your desktop user.

Doing so is outside the scope of this repository, though.

Building the image

./docker-shogigui --build

This will also automatically select the best CPU flag to use to compile YaneuraOu.

Optional : Remove the builder image

./docker-shogigui --cleanup

Note that doing so will save space, but building the image again will take longer.

Running ShogiGUI inside a container

./docker-shogigui --run

That simple.

Load/Save games

If you want to load / save game files, you can type :

./docker-shogigui --run -g $HOME/somedir

This directory will be accessible at /shogi/games inside the container

Update settings.xml

Along the way, on this repository engines may be added / replaced / enhanced.

To keep up with those, you have to manually run (after having built the latest image) :

./docker-shogigui --update-settings

This is non-destructive, as it will only add missing engines to the settings.xml file.

And more...

For all the available commands, type :

./docker-shogigui --help

Simplified pieces

To use the simplified pieces embedded in this repository, you can go to Tools>Options>Design and check Image/Piece.

Troubleshooting

Could not open display (X-Server required. Check your DISPLAY environment variable)

This should not happen if you use --user $UID:$UID when running the container.

To circumvent the issue you can run :

xhost +local:

Known bugs

• If sound is activated in ShogiGUI, every piece move will cap a core to 100% usage