13 Mar 2006

I'm eventually going to move everything from here to

24 Jan 2006

If you're looking for SudokuBan on the Linux Format 76 coverdisc, it's called sudoku-sensei-1.0.tar.gz. The name is different, but the software is otherwise identical to SudokuBan 1.0.

15 Dec 2005

Sudoku Sensei has now been renamed to SudokuBan. A project called Sudoku Sensei already existed, and is much better suited to the name.

Keep an eye out for LXF 76.


1  Description       
2  Screenshot       
3  License       
4  Instructions       
5  Dependencies       
6  Download       
7  To-Do List       
8  File Format       
9  Contact       


SudokuBan allows you to view, create, edit and solve Sudoku puzzles.

For a description of Sudoku, see the Wikipedia article.



This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

A copy of the GNU General Public License is included with the program. You can also view it at the GNU website.


To install and run SudokuBan:

  1. Download and install the dependencies.
  2. Download and extract the latest version of the SudokuBan tarball.
  3. Run

The program starts up with a blank 3x3 puzzle. You can enter numbers by selecting a square and typing a number, or by right-clicking on a square and selecting from the menu. The Presets option is selected by default; this means that any numbers you enter to begin with will be part of the starting configuration of the puzzle. Turn this off when you've entered all of the given numbers.

To create a random puzzle, click the New button. Hover the mouse over an option to see a description of what it does.

To load an existing puzzle, select Open from the File menu. The puzzles directory distributed with SudokuBan contains some sample puzzles of different sizes, roughly ordered by difficulty.

If you get stuck on a puzzle, try some of the hints:


SudokuBan requires the following to be installed:

It should work on any platforms for which the above dependencies are available (essentially Linux and other UNIX-likes, and Windows). It has been successfully run on Debian, Ubuntu, SUSE and Windows XP.


Download sudokuban-1.0.tar.gz, extract it, and follow the instructions.

To get the latest development version (be prepared to wait):

    bzr branch

To-Do List

This program was originally written in search of a Linux Format bounty, but it's far from perfect, and there were a few features I didn't get a chance to implement, so here is a list of things that will be considered at some later stage. Especially if there's interest from the outside world.

File Format

SudokuBan uses a text-based file format, normally with extension .sku, defined as follows:

Note that any characters other than digits, dots or asterisks, including line breaks, are treated equally as separators. It is generally useful to arrange them in a way that resembles the board itself, but this isn't necessary.

An example puzzle (this represents the board shown in the screenshot above):

3, 3
|*6 . 1| . 4 9|*5 2*8|
| 2 .*9| . .*8|*1*6 4|
| 5*4 .|*1 6*2| 7*3 9|
| .*1 .|*8 . 3| . 7 .|
| 8 . .| . . .| . . 1|
| . 6 .| 7 .*1| . . .|
| 7 . 4| . 1 .| . . 3|
| 1 . .| . . .| . . 5|
| . 9 .| 2 8 .| 4*1*7|

Email David McLeish: dave at dmcleish dot id dot au.