Sudoku

Overview

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.

Available Puzzle Types

kids4n: Kids 4x4
kids4l: Kids 4x4 with Letters
kids6: Kids 6x6
kids6l: Kids 6x6 with Letters
easy9: Classic 9x9 (Easy)
medium9: Classic 9x9 (Medium)
hard9: Classic 9x9 (Hard)
evil9: Classic 9x9 (Evil)

Get a Puzzle

Fetches a new puzzle and stores it as JSON. Output is JSON by default (use --text for human-readable output).

Get a Classic Easy puzzle:

./scripts/sudoku.py get easy9

Get a Kids 6x6 puzzle:

./scripts/sudoku.py get kids6

Render Puzzle

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 Solution

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

Share Link

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>).