Pydoku

A Sudoku game built with Python and Pygame that fetches puzzles from websudoku.com.

Why This Project?

This project was created to combine the best of both worlds: advanced pencil marking techniques (specifically Snyder notation as explained in this video) with vim-style keyboard navigation. I wanted all the fancy pencil marks for serious Sudoku solving but without having to rely on mouse controls. Nothing too fancy going on here, not very robust. Just gets the job done whenever I want to play a quick game of sudoku on my computer.

Features

• Interactive Sudoku puzzle solving
• Multiple difficulty levels (Easy, Medium, Hard, Evil)
• Snyder notation pencil marks support (center and border notation)
• Pause/resume functionality
• Timer to track solving time
• Solution checking
• Vim-style keyboard navigation (no mouse required!)

Controls

• Arrow keys or WASD/HJKL: Move cursor (vim motions supported)
• 1-9: Enter numbers
• F: Fill mode (default)
• C: Center pencil marks mode
• B: Border pencil marks mode
• Backspace: Clear cell/pencil marks
• P: Pause/resume
• Enter: Check solution
• Mouse: Click to select cells or buttons (optional)

Usage

python pydoku.py [difficulty]

Difficulty options: easy, medium, hard, evil (default: medium)

Requirements

• Python 3.x
• Pygame

License

MIT License

Puzzle Source

Puzzles are fetched from websudoku.com