man(6)

💖 NAME 💖

nudoku — a ncurses based sudoku game, bestie. that's it, that's the whole vibe ✨

(also hi, you're reading the nudoku man page, section man(6) — you're in the right place 🫶)

---

🌸 SYNOPSIS 🌸

nudoku [OPTIONS]

---

🦋 DESCRIPTION 🦋

okay so <rainbow>nudoku</rainbow> is a ncurses based sudoku game. it's literally the perfect thing to do when you wanna relax a lil bit or you're just feeling like wasting some time while you're on the console. no cap. 💅

🎀 Keybindings 🎀

for navigation you got vi-keybindings (hjkl) or the arrow keys, whichever one your heart desires. pressing a number will put it in a field. pressing delete, backspace or x will delete it. slay.

some keys need to be typed uppercase to prevent pressing them accidentally. it's giving safety feature ✋

• c — gives feedback whether your solution is right. if you think you finished your sudoku, press this key to make sure it actually is. you can also use this during the game to check if you've made any mistakes 👀
• H — the computer will fill in one number for you. if you're pretty close to finishing he might not want to help you. and if you did something wrong so far, he will not say anything. rude but okay 💀
• m — toggle marks. if enabled, the number in the currently selected cell will be highlighted in all other cells they occur in. ⚠️ only works when colors are enabled.
• N — create a new puzzle. fresh start era.
• G — save current game state. protect your progress bestie 🫶
• Q — quit nudoku. goodbye icon 👋
• r — redraw screen. in case you resized your terminal this will come handy.
• S — let the computer solve the puzzle. watching it cook 🔥
• x — delete number from field.
• u — undo previous action. the way that this saves lives 😭

---

✨ OPTIONS ✨

• -h — print help.
• -v — display version information.
• -c — do not use colors. black and white mode. some terminals don't support colors, so use this option in this case. minimalism aesthetic ✨
• -o — output stream. print a single sudoku onto standard output. notation is in stream format like used by -s.
• -d — choose difficulty. available options are: easy, normal, hard.
• -s — user provided stream. the user can provide a sudoku himself. nudoku won't generate it in this case. notation is in stream format, meaning everything in one line. use dots (.) for empty fields. example:

nudoku -s 4.....8.5.3..........7......2.....6.....8.4......1.......6.3.7.5..2.....1.4......

• -r — resume saved game. game state is stored in $XDG_STATE_HOME/nudoku/ directory and deleted on successful resume.
• -p — output PDF. prints a sudoku into a PDF file. file name needs to follow. this can be combined with -n to define how many sudokus the PDF should contain. example: -p riddle.pdf
• -n — number of sudokus to put in PDF. ⚠️ this can only be used with -p. example: -p riddle.pdf -n 8
• -i — output PNG image. puts a single sudoku into a PNG image file. file name needs to follow. example: -i sudoku.png
• -S — paper size for PDF output. accepted values are: 'a4' (default), 'a5', 'letter', 'legal', 'oficio', 'invoice', or 'WIDTHxHEIGHT[unit]'. if not given, the unit defaults to centimeters. this can only be used with -p. example: -p riddle.pdf -S 11x8.5in

---

💀 BUGS 💀

no known bugs. we are flawless, we are that girl, periodt 👑

---

👑 AUTHOR 👑

Michael Vetter (jubalh@iodoru.org) — thank him, he ate 💖

---

and that's the whole thing bestie!! go play some sudoku, you deserve it 🌈🎀💜

this was the nudoku man page, version 8.0.1, dated 08 July 2026 — catch you on the next one, iykyk 🦋✨💅