MojoPad

FAQ and Troubleshooting

The AI features say Ollama isn't running.

Install it from ollama.com, launch it once, and pull a model (ollama pull qwen2.5). MojoPad checks 127.0.0.1:11434. Semantic features additionally want an embedding model (ollama pull nomic-embed-text). See Local AI.

“Related by meaning” shows nothing.

The index builds in the background the first time — give a large document a minute, and watch for “Semantic index ready” in the status bar. No embedding model installed means no semantic features (keyword search still works fully).

Can MojoPad really read my books?

Yes — import a PDF or ePub and use the Ask palette's This page mode, or Summarize. Long documents are read in full: questions retrieve the relevant passages from anywhere in the book, and summaries are built part by part. Whole-book work needs an embedding model (see the first question above) and a generation model; everything runs on your Mac.

Why is the first question to a book slow?

The first time, MojoPad extracts the book's text and indexes it into sections — watch the status line under the Ask box. The index is then saved inside the document, so every later session starts warm: questions are quick and the book is findable in document search immediately. A whole-book summary is always a long job (the model genuinely reads everything) — the status line counts the parts, and the Stop button abandons it cleanly.

How do the trial and license work?

MojoPad is free, full-featured, for 14 days — no signup. After that, your documents stay safe, readable, searchable, and exportable, but editing pauses until you enter a license (MojoPad ▸ Enter License…). One $59 license covers two Macs; buy it at mojopad.app and the key arrives by email. Deactivate on this Mac in Settings ▸ License frees a seat for another machine. Licenses never expire — minor updates are free, and future major versions are an optional paid upgrade.

How do updates work?

MojoPad quietly checks a small version file when it starts and lets you know when a new release is out — nothing downloads or installs without you, and Skip This Version means that release won't be offered again. Check any time with MojoPad ▸ Check for Updates…, and turn the automatic check off in Settings ▸ Updates if you prefer.

Something's wrong — how do I report it?

Choose Help ▸ Save Diagnostic Report… and attach the file to your report. It gathers what support needs to see in one text file: app and macOS versions, your preferences, statistics about the open documents (page counts and sizes — never page names or content), backup status, and the recent application log. You can open the file and read exactly what it contains before sending it. MojoPad also keeps a rolling log at ~/Library/Logs/MojoPad/; errors are recorded there as they happen, so a report saved even days after a problem usually still shows it.

Record Audio asks for microphone access.

That's macOS doing its job — allow it in System Settings ▸ Privacy & Security ▸ Microphone if you declined the first prompt.

A page I pasted lost its colors when I switched views.

That's a Markdown page — Markdown can't express colors, so they don't survive the trip to source. Convert the page to rich text for full styling. See Markdown Pages.

I forgot an encrypted page's password.

There is no back door; that's the feature. Check File ▸ Show Backups in Finder for a copy old enough to predate the encryption, if one exists.

Clicking a mojopad:// link does nothing.

The link targets a document that has moved or been renamed. Links carry the document's path; if you reorganize, copy fresh links.

The “Save PDF to MojoPad” print item is missing.

It's installed the first time the app runs from /Applications. Launch MojoPad once, then check the PDF menu again. A document must be open to receive the PDF.

Where exactly is my data?

In the .mojopad document wherever you saved it — it's a folder bundle of JSON and your attachments; right-click ▸ Show Package Contents to see for yourself. Backups live in MojoPad's Application Support folder (File ▸ Show Backups in Finder). Nothing is stored anywhere else.

How do I report a bug or ask for a feature?

The Help menu and mojopad.app will always have a current address. MojoPad is built by people who use it daily — sharp edges get filed fast.