https://github.com/ryp/sudoku-zig
Sudoku game written in Zig, using SDL for graphics.
https://github.com/ryp/sudoku-zig
Last synced: 3 months ago
JSON representation
Sudoku game written in Zig, using SDL for graphics.
- Host: GitHub
- URL: https://github.com/ryp/sudoku-zig
- Owner: Ryp
- License: mit
- Created: 2023-05-04T03:40:42.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2025-03-10T19:28:53.000Z (4 months ago)
- Last Synced: 2025-03-28T03:32:26.682Z (4 months ago)
- Language: Zig
- Size: 1.21 MB
- Stars: 10
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Sudoku
A Sudoku game that doesn't come with puzzles in the box, bring your own!
Supports all box sizes as long as they hold between 2 and 16 numbers, and has a solver included.
Lets you pencil out the candidates as well, which is necessary for advanced techniques.
Jigsaw (squiggly) puzzles are also supported, but manually entering them in CLI is tedious.
## Running
This should get you going after cloning the repo:
```sh
zig build run -- 3 3 72..96..3...2.5....8...4.2........6.1.65.38.7.4........3.8...9....7.2...2..43..18
```
> **NOTE:** The sudoku string has to contain valid clue characters, anything else is considered as an empty cell.
## Controls
| Action | Key |
|-----------------------|--------------------|
| Quit game | Escape |
| Select cell | Left mouse button |
| Move selection | Arrow keys |
| Place number | <1-9,A-G> |
| Toggle candidate | Shift + <1-9,A-G> |
| Clear number | <0>, Del |
| Undo | Ctrl + Z |
| Redo | Ctrl + Shift + Z |
| Fill candidates | H |
| Fill all candidates | Ctrl + H |
| Clear candidates | Shift + H |
| Solve | Enter |
| Get/apply a hint | Shift + Enter |
> **NOTE:** Getting a hint only works if you already placed candidates on the board and assumes they are correct.
> A preview will be shown to you with what the solver found and the game will wait for you to press the key again to apply it.
## Examples
### 4x3 sudoku
```sh
zig build run -- 4 3 8.9....B.4C.C......3.B9...B5..A8.2...2.4..5........9........7...1B69...32...C47A...B........5........1..A.7...5.87..13...8A.3......2.14.5....8.C
```
### Jigsaw sudoku
```sh
zig build run -- 3 3 .38.4.1...6.9532......6....97......54..........5..2......6..8...57....6.34.8..... 111111222113444422133455442334455222366657777366559997366659977386858997888888997
```
> **NOTE:** Jigsaw puzzles need a second string that matches each cell with its associated region, so it's like the sudoku string but instead of clues you write the region index.
