Fetch Sudoku puzzles and store them as JSON in the workspace; render images on demand; reveal solutions later.
Fetch, render, and reveal Sudoku puzzles. Use sudoku.py to get new puzzles from sudokuonline.io, generate printable PDFs or images, and reveal solutions.
For details on the saved JSON format, see DATA_FORMAT.md.
kids4n: Kids 4x4kids4l: Kids 4x4 with Letterskids6: Kids 6x6kids6l: Kids 6x6 with Letterseasy9: Classic 9x9 (Easy)medium9: Classic 9x9 (Medium)hard9: Classic 9x9 (Hard)evil9: Classic 9x9 (Evil)Fetches a new puzzle and stores it as JSON. Output is JSON by default (use for human-readable output).
--textGet a Classic Easy puzzle:
./scripts/sudoku.py get easy9
Get a Kids 6x6 puzzle:
./scripts/sudoku.py get kids6
Render a puzzle as an image or PDF.
Render latest puzzle as A4 PDF (for printing):
./scripts/sudoku.py render --pdf
Render latest puzzle as clean PNG (for viewing):
./scripts/sudoku.py render
Render a specific previous puzzle by short ID:
./scripts/sudoku.py render --id a09f3680
Reveal the solution for the latest or specific puzzle. Use --id <short_id> (e.g., a09f3680) to target a specific puzzle.
Reveal full solution as printable PDF:
./scripts/sudoku.py reveal --pdf
Reveal full solution for a specific ID:
./scripts/sudoku.py reveal --id a09f3680 --image
Reveal full solution as PNG image:
./scripts/sudoku.py reveal
Reveal a single cell (row 3, column 7):
./scripts/sudoku.py reveal --cell 3 7
Reveal a specific 3x3 box (index 5):
./scripts/sudoku.py reveal --box 5
Generate a share link for a stored puzzle. Targets the latest puzzle by default; use --id <short_id> for a specific one.
Generate a SudokuPad share link (default):
./scripts/sudoku.py share
Generate link for specific ID:
./scripts/sudoku.py share --id a09f3680
Generate an SCL share link:
./scripts/sudoku.py share --type scl
Telegram Formatting Tip:
Format links as a short button-style link and hide the full URL: [Easy Classic \[<id>\]](<url>).