Skip to content

Latest commit

 

History

History
181 lines (126 loc) · 7.3 KB

README.md

File metadata and controls

181 lines (126 loc) · 7.3 KB

Contributors Forks Stargazers Issues MIT License


Sudoku Solver

A working sudoku solver where you can also ask for random sudoku's to play
Explore the docs »

View Demo · Report Bug · Request Feature

Table of Contents
  1. About The Project
  2. Getting Started
  3. Usage
  4. Roadmap
  5. License

About The Project

[Product Name Screen Shot]

The Sudoku Solver is a software application that solves Sudoku puzzles using a backtracking algorithm. It provides a graphical user interface (GUI) for users to interact with and solve Sudoku puzzles.

This Sudoku Solver project provides an interactive and efficient way to solve Sudoku puzzles using a desktop application. It is designed to enhance the puzzle-solving experience by automating the solution process and offering a user-friendly interface.

(back to top)

Built With

This section should list any major frameworks/libraries used to bootstrap your project. Leave any add-ons/plugins for the acknowledgements section. Here are a few examples.

  • Programming Language: C#
  • Framework: .NET Framework
  • GUI Development: Windows Forms
  • JSON Parsing: Newtonsoft.Json

(back to top)

Getting Started

This is an example of how you may give instructions on setting up your project locally. To get a local copy up and running follow these simple example steps.

Installation

To install and run the Sudoku Solver application on your machine, follow these steps:

  1. Prerequisites:

    • Make sure you have the .NET Framework installed. You can download it from the official Microsoft website.
    • Ensure you have a compatible operating system (e.g., Windows 11, Windows 10, Windows 8.1, Windows 7).

  2. Download:

    • Download the latest release of the Sudoku Solver application from the project's GitHub repository.

  3. Extract the Files:

    • Extract the downloaded ZIP file to a directory of your choice.

  4. Run the Application:

    • Navigate to the extracted directory and locate the executable file (e.g., Sudoku_Solver.exe).
    • Double-click on the executable file to run the application.

  5. User Interface:

    • The Sudoku Solver application will open with the main GUI, displaying the Sudoku grid.

(back to top)

Usage

  • Load a Sudoku puzzle by clicking on the "Load Random" button to fetch a random puzzle or use the "Clear" button to start with an empty grid.
  • Fill in the empty cells with numbers from 1 to 9.
  • Click the "Solve" button to solve the puzzle. If a solution is found, the solved puzzle will be displayed in the grid.

Enjoy solving Sudoku puzzles with the Sudoku Solver application!

(back to top)

Roadmap

  • Graphical User Interface (GUI): The program has a user- [x]friendly interface built using Windows Forms in C#. It allows users to interact with the Sudoku grid visually.
  • Puzzle Generation: The program can generate Sudoku puzzles by fetching data from an API or using a predefined template. Users have the option to load a random puzzle or start with an empty grid.
  • Puzzle Solving: The application uses a backtracking algorithm to solve the Sudoku puzzle. It provides a Solve button that attempts to find a solution for the given puzzle.
  • Input Validation: The program validates user input to ensure that only valid numbers from 1 to 9 are entered in the Sudoku grid. It displays error messages for invalid input.
  • Visual Representation: The Sudoku grid is displayed using a table- [x]like structure with text boxes for each cell. Filled cells are shown with a dark gray background, while empty cells are displayed with a white background.
  • Solution Display: Once the puzzle is solved, the program displays the solved puzzle in the Sudoku grid, highlighting the solution cells.

See the open issues for a full list of proposed features (and known issues).

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)