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)

Setup / Requirements

• Binaries: python3
• Python libs: bash python3 -m pip install requests Pillow lzstring

Get a Puzzle

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

Use --count N to fetch/store multiple puzzles in one call. If a batch does not contain enough unseen puzzles, the command will fetch additional batches until it has enough.

Use --id <fragment> to select a specific source puzzle by matching any unique part of its UUID. If multiple IDs match, the command errors and lists candidates.

Get a Classic Easy puzzle: bash ./scripts/sudoku.py get easy9

Get multiple new puzzles at once (e.g. 4 easy 9x9): bash ./scripts/sudoku.py get easy9 --count 4

Get a Kids 6x6 puzzle: bash ./scripts/sudoku.py get kids6

Render Puzzle

Render a puzzle as an image, PDF, or minimal HTML.

Render latest puzzle as A4 PDF (for printing): bash ./scripts/sudoku.py render --pdf

Render latest puzzle as clean PNG (for viewing): bash ./scripts/sudoku.py render

Render a specific previous puzzle by short ID: bash ./scripts/sudoku.py render --id a09f3680

Render minimal HTML (square cells + bold box lines): bash ./scripts/sudoku.py html --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: bash ./scripts/sudoku.py reveal --pdf

Reveal full solution for a specific ID: bash ./scripts/sudoku.py reveal --id a09f3680 --image

Reveal full solution as PNG image: bash ./scripts/sudoku.py reveal

Reveal a single cell (row 3, column 7): bash ./scripts/sudoku.py reveal --cell 3 7

Reveal a specific 3x3 box (index 5): bash ./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): bash ./scripts/sudoku.py share

Generate link for specific ID: bash ./scripts/sudoku.py share --id a09f3680

Generate an SCL share link: bash ./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>).