Murdoku Assistant

Open a PDF or image, align or detect a grid, and keep solving with notes. Multi-page PDFs add page navigation automatically.

Files and grid recognition are processed in your browser, with no file upload or cloud recognition. Notes are saved locally.

Choose a PDF or image to start.

Edit people

Edit, add or remove letters, including V, here or in fullscreen. Use 1–64 unique labels of 1–16 English letters (automatically uppercased). Renaming keeps placements, candidates and cell undo. Removal clears only that person’s notes; existing × marks stay. Changes apply to this file, layout and page only.

Keyboard shortcuts
A–Z (no Shift)Select a person in the current roster. Other letters do nothing; confirmed people cannot be placed twice. X is a person; Shift+X selects ×. Multi-letter names remain available in Tools.
Shift + XExclude (×)
Shift + ECell eraser
Shift + ABrush
Shift + TText
Shift + DInk eraser
Shift + ZZen mode (fullscreen only)
Shift + +Zoom in
Shift + − / _Zoom out
PageUp / PageDownPrevious / next PDF page
?Keyboard shortcuts
EscClose help / cancel gesture / leave Zen / exit fullscreen

Shortcuts work while the assistant has focus, not while typing or using a select, IME or dialog. Escape still works on fullscreen sliders and selectors; their other keys keep native behavior. Caps Lock does not count as Shift. Keys select tools only: tap a cell for a candidate, hold 400 ms or press Space to confirm. Confirmation removes this person’s other candidates everywhere.

Choose T or Shift+T, then click the PDF, image or whiteboard to type. Click existing text to edit. Enter starts a new line; click outside or use Done to finish, Esc to cancel. Text saves locally as you type. Font size follows page zoom; ink erasers do not remove text.

Fullscreen fills the browser content area (the address bar stays). Escape closes help, cancels an unfinished gesture, or exits fullscreen. Use Tools for touch controls, zoom and undo. PageUp / PageDown turns PDF pages.

Choose tools with +. Click a tool to use it; drag the button to reorder. On touch, hold briefly then drag; swipe without holding to scroll. You can also use the move buttons here. Select again to remove. Saved in this browser, across files and pages.

In fullscreen, press Shift+Z to hide all floating tools and status messages; press it again to restore them. Tools and page shortcuts still work. Esc cancels a gesture first, then leaves Zen mode before exiting fullscreen. Errors restore the tools automatically. Zen mode requires a keyboard and resets when you leave fullscreen or reload.

Keyboard: arrows move between cells; Enter adds a candidate, Space confirms. In alignment mode, arrows move the grid (Shift = larger step); corner handles also support arrow-key resizing.

Clear all cell notes, crosses, ink and typed text in the displayed view? Whiteboard frames, grid, roster, original file and other views are kept. A spread and its single pages have separate notes. This cannot be undone.

View imported answer

This is your imported answer PDF, not an automatically generated solution.

How to use the Murdoku PDF assistant

  1. Import a PDF or image. Page navigation and single/spread layout appear for multi-page PDFs.
  2. Detect the current page’s grid and check the preview, or enter rows and columns and adjust width and height independently.
  3. Applying a suggestion locks the grid and sets an editable default roster with victim V last. After manual alignment, lock it yourself. Tap for candidates or hold to confirm; unlocking preserves notes.

One grid per page or spread. Notes are saved separately by file, layout and page. Reimport the same PDF to revisit its notes. Page Up/Down turns pages when the page viewer is focused.

Existing notes are retained. Old assistant notes are copied only into pages without newer work; the old storage is untouched. Clearing browser data removes progress. Localhost and this website have separate browser storage.

This tool processes and saves files and notes in your browser; it has no upload feature. Clearing browser data removes progress. Page ads and traffic analytics still follow your privacy settings. Do not import sensitive documents.

More official cases to print ↗ · Original project, acknowledgements & changes ↓

Brush starts off. Draw anywhere in the map area, including outside the grid. Ink eraser affects only freehand marks; they stay attached when zooming or panning and are saved per file/page.

Keyboard: arrows move between cells; Enter adds a candidate, Space confirms. In alignment mode, arrows move the grid (Shift = larger step); corner handles also support arrow-key resizing.

Murdoku Contest results & solution →

Murdoku Contest rules archive →

Original project & thanks

Thank you to XuPub for creating and publicly sharing MurdokuAssistant. Its PDF/image grid overlay and candidate-note workflow inspired this tool.

Original repository: https://github.com/XuPub/MurdokuAssistant

This version reimplements the original interaction concept for murdoku.fans. It is not a release by the original author.

What we changed in this version

  • Grid dimensions — Set columns and rows independently from 1 to 64, including 24×24 and rectangular maps.
  • People — Set 1–64 people independently of the grid. The default ends in V; edit, add or remove any letter in the sidebar or fullscreen without clearing unrelated notes. Exclusions use ×, distinct from person X.
  • Grid alignment — Detect a grid locally and confirm the preview, or drag and resize its width and height independently. Applying a suggestion locks it; manual alignment remains available. Unlocking keeps notes.
  • Local progress — Separate saved boards by file, single/two-page layout and page number. Deleting tool data leaves other site settings intact.
  • PDF loading — Use PDF.js 6.4.299 with its worker and rendering resources served by this site, rather than the original CDN dependency.
  • Wide workspace & colours — Use fullscreen with keyboard tools and a compact floating toolbar, two-axis panning and Fit map. Fullscreen hides the sidebar and the full page toolbar. Each person has a stable colour with a black-only switch.
  • Temporary whiteboards — Drag white rectangles over unwanted content, then move, resize or delete them. Handwriting stays with its board; the original PDF is not modified.
  • Typed text — Use T to type on PDFs, images or whiteboards, with multiline editing, size, colour, delete and separate undo. Text follows page zoom and whiteboard movement, and saves locally without modifying the original file.
  • Freehand marks — A brush that starts off, five ink colours, adjustable size, partial erasing and separate undo. Marks follow the document and are saved per file, layout and page without changing the image or cell notes.
  • Site integration — Match this site's visual style and add English, Chinese, Spanish and Japanese interfaces with responsive layouts.

Retained workflow: candidate notes, hold to confirm, automatic row/column × marks, erasing, undo and viewing an imported answer PDF. This remains a manual assistant, not an automatic solver.