Sudoaudio is a simple sudoku playing interface for blind people and others that need audio feedback for solving sudoku puzzles. It is not intended to be an advanced application nor provide interfaces to solve more puzzles or variations of sudoku, either then the standard 9x9 sudoku. Moreover it is meant for playing and forgetting, no complicated interfaces or procedures.

Sudoaudio is in Early development stages. Expect bugs and kirks. You've been warned. The code is also a mess, and a not commented mess. However do not exitate to contact the AUTHOR with bugs and sugestions.

== Author and Contacts ==

Rui batista <ruiandrebatista@gmail.com>

== License ==

This software is covered under the terms of the GNU General Public License version 3 or any later version of this license. Check the file COPYING for details.

== how to run ==

The following instructions are for running from source code. binary packages (in particular for dum platforms like win32) will be provided for users benefit.

If you are running from source you can execute in the root source dir:

python sudoaudio

You will be prompted for a puzzle to choose.

or

python sudoaudio <puzzlefile>

The puzzle file should be in the following format:
* 9 (nine) lines
* each line with 9 numbers separated be white space
* numbers can be from 0 to 9, where 0 means a blank square.
* In the puzzles folder there are a bunch of example instances.

There are many puzzles in the sudoaudio/puzzles directory. You can also put your own there.

== Requirements ==

* Python 2.6 or greater
* pygame 1.9 or greater
* Speech-dispatcher (a recent version should work) and its python bindings, to run under linux
* the NVDA screen reader or SAPI5 on windows (not well tested) and the comtypes python library to use SAPI5.

== Why Sudoaudio ==

The main reason behind sudoaudio development is the lake of a sudoku audio interface for Linux systems, and a free software one, at least from its authors knowledge. OK, the truth is that the author wanted to play sudoku, and then thought this application could be useful to others. Further more there are not that many free software audiogames. Being free software everyone can contribute to the development and use the code and ideas for whatever they want to create, specially more free software audiogames.

== Future goals ==

* Make Sodoaudio run at least on Windows and Linux platforms (create binaries if possible)
* Make a graphical user interface so that the audio is accompanied with the sudoku board on the screen.
* Provide more puzzles and an easy way to load them
* Have good and funny sounds when playing