Klotski 1.3.1

by Philippe Fremy phil@freehackers.org

Graphics by Ben Adler benadler@bigfoot.de

Klotski is small brick game which has its root in a wooden game named (in french) Ane rouge. The goal is to bring the red piece to its destination by moving other pieces. It sounds simple but it is a real brainteaser.

There was a klotski game on Windows 3.1, and this is where all levels are from.

To run Klotski:

1. If you are Windows, simply download the zip package here. Extract it and run the klotski.exe

2. In other situations, you need to use Python to run it:

Klotski requires Python 3.5 (at least) and PyQt 5. To install Klotski, you must already have Python installed on your computer.

Type:

pip install klotski

To play:

python -m klotski

This was my first program using python and PyQt in 2001. I must say I have enjoyed it a lot: Python and Qt are both excellent, easy to use and well documented. I have never been able to implement my ideas so quickly. The usual cycle think, organise into organigram, code, compile, correct compiling errors, run, correct bugs, run, it works was reduced to think, code, run, it works. Because of the simplicity and the power the python language, my ideas could be expressed very clearly and I could concentrate on what I wanted to do instead of how I needed to code it. The result is a simple and clean program, that was coded in half the time (and probably less) it would have taken to do it in C++.

Contributions and feedback are gladly welcome. Especially, bug, new levels or new tile themes. To add new levels, just edit boards.kts, the format is pretty simple. To add new tile themes, look at pixmap/THEMES.txt and replace the image klotski-tiles.png .

For any bugs or feedback, please use the GitHub page: https://github.com/bluebird75/klotski

Full solution to Ane Rouge are available here.

Release history

v1.3.1: 16 May 2021

• window may be resized smaller than the board, to fit smaller screens

v1.3: 10 September 2020

• make it installable through pypi.org and pip
• move project to GitHub
• internal:
  • add type annotations
  • port from PyQt3 to PyQt5

version 1.2: 01 June 2006

• Windows version with installer: Setup-Klotski-1.2-20060601.exe

version 1.1: 17 November 2004

• Unix version: klotski-1-1.tar.bz2
• Windows Version with installer: Setup-Klotski-1.1-20050416.exe

version 1.0 : 23 January 2001

• Unix version: klotski-1.0.tar.bz2
• Windows version (no installer): klotski-1.0.zip