MojoPad

Settings, Themes, and Layout

MojoPad believes in options. Settings (⌘,, or the ⚙ toolbar button) keeps them in panes you pick from the sidebar — Appearance, Editing, Links & Pages, Journal, Reading Aloud, Dates & Time, Web Clipper, Sources, AI, AI Agents, Mail Drop, Sharing, Exporting, Files & Backups, Security, Shortcuts, Updates and License. Here is what you'll find in them, by subject:

Can't remember which pane it was in? Don't go hunting — there's a search box at the top of the sidebar. Type what you're after and the panes stop being one-at-a-time: every pane holding a match is shown at once, each labeled with its own name so you learn where things live while you look for them, and the setting that matched is marked down its edge. Its neighbors come with it on purpose — a control arriving on its own, without the sentence that explains it, tells you less than you came for.

Near enough is enough. You don't have to spell it, and you don't have to know the exact wording: typewrter finds "Typewriter line sits at", spellng finds "Check spelling while typing", and wordcompletion — no space, not what it's called — finds "Suggest word completions as I type". Typing what the setting actually says works too, and searches the explanations as well as the names, so a word you half-remember from reading a description will still get you there. Esc clears the box and puts you back where you were.

And Settings takes the interface size with it. If you have set Interface to Roomy because the app was too small to read comfortably, this window grows too — every label, every explanation, the sidebar and the search box, all in the same proportion. Compact shrinks it the same way. It used to be the one window that ignored you.

  • Theme — a flat, warm set led by Clay (the default: calm cream, charcoal ink, a confident terracotta accent) and its night sibling Clay Dark. The rest keep their own colors in the same clean, flat style — in the light, Ivory (near-white pages, warm cream chrome, one confident red — the very light look task-manager fans know), Panda (charcoal toolbar and rail, white paper, red links — for fans of a certain beloved bear), Daylight, Sepia, Blossom, and Linen; after dark, Midnight, Graphite, Forest, Sage, Ember, Harbor, Cobalt (deep-navy, cyan-lit), Harvest (orange headings and green bold, after NotePlan), and Matrix (neon terminal-green). Two Voodoo themes (light and dark) are the heirlooms of the set — deliberately plain, native Mac looks in honor of a beloved ancestor: silver toolbar, plain white page, honest Mac-blue links, system font throughout. Also under View ▸ Theme. Turn on Match system appearance and MojoPad follows macOS — pick one theme for day and one for night, and they trade places when your Mac does. Choosing a theme by hand switches back to manual.
  • Page Layout — Classic (full bleed), Inset (a soft frame), or Floating (your page as a card), plus the Default page width — Narrow, Medium, Large, or Full width — that new pages open at. Any page can override it from the reading-width control on the format bar, and the choice is remembered per page. Also under View ▸ Page Layout.
  • Float the panels — for anyone who finds a wall of panes divided by hairlines hard to read at a glance, or who simply wants the window to feel less like a spreadsheet. Off unless you turn it on, and it sits at the top of Appearance, above the theme swatches. Turn it on and the page list, the page you're writing in, the split view, the palettes and the AI drawer each lift onto their own panel with a little space between them, and the window's background shows through the gaps — so you can see where one thing ends and the next begins without a line being drawn to tell you. The icon rail comes along as a rounded dock rather than a fourth panel. It works with every theme, because it uses the colors your theme already has: a light theme stays light, a dark one stays dark. The gaps cost a small amount of width, which is worth knowing on a laptop screen, and turning it off puts everything back. This is a different thing from Page Layout ▸ Floating above, which shapes the page's own surface inside its pane; this one separates the panes themselves. There is no View-menu equivalent — Settings is the only way in.
  • Interface — overall chrome size (Compact / Comfortable / Roomy) and Page Zoom (90–150%), both also in the View menu.
  • Toolbar — which tools ride the top bar and which dock in a left icon rail, in your order. See "The toolbar, top or docked left" below.
  • Editing — default font and text size for your writing; line and paragraph spacing; where the typewriter line sits (see Typewriter scrolling under Formatting); spell checking; word completions (suggest words you've already used as you type); Markdown-aware paste; how much of a long property answer shows.
  • Links & Pages — whether wiki links open in place or in a new tab (-click does the opposite, either way); whether typing [[ opens the picker or lets you type the name; Two pages at once (including Open the second pane ready to write in); whether WikiWords highlight on new documents; and whether filing a page into a folder reveals that folder.
  • Journal — the daily note's name format and its template, the weekly review day, the calendar, the idea cards, and Show mood and energy on each day in the Journal. See Daily Notes and The Journal.
  • Dates & Time — time zone, date and time display, 12/24-hour clock, with a live preview.
  • Reading Aloud — the voice, its speed, and the second voice used for another language. See Read Aloud.
  • Web Clipper — the bookmarklet and the browser extension. See Page Links Everywhere and Augmented Browsing.
  • AI — chat model and embedding model, bring-your-own-model, and the web-search keys. See Local AI.
  • Sources — where a source lookup gets its answers, and the one place a key of your own goes. It says whether your reference library can be reached, with a Check the connection button that names what is missing rather than simply failing; and it holds an optional key for the catalog that reports citation counts. A key is written once and never shown again — it is encrypted by your Mac rather than kept in the settings file, so it does not travel when settings are copied to another machine or sent to us with a report. Forget takes one back.
  • AI Agents — the MojoPad MCP server, the tools you connect, and the local API. See AI Agents and The Local API.
  • Mail Drop — an email address for one of your wikis: the mailbox to read, the folder, and who is allowed to write. See Mail Drop.
  • Files & Backups — where backups go and how many are kept, the paper size used for export, and External apps (your external text editor and image editor). See Recently Deleted and Backups.
  • Security — the encrypted-content re-lock timer. See Encryption and Privacy.
  • Shortcuts — every remappable key. See Keyboard Shortcuts.
  • Updates — whether MojoPad checks for a new version on launch.
  • License — your license key.

Settings apply live — no restarts, no Apply buttons. (The Settings window wears your theme too, and switches the moment you pick a new one.)

The toolbar, docked left (or up top)

Out of the box, MojoPad's tools live in a left icon rail — a slim column down the left edge, the top bar reduced to navigation: clean lines. The toolbar is yours to arrange though: in Settings ▸ Appearance ▸ Toolbar, drag any tool between the rail and the top bar, and drag within a zone to set the order — "Everything on top" restores the classic single-bar look with one click.

A few pieces stay put on purpose: the document switcher, the back/forward arrows, and the search-and-command pair keep their places in the top bar — they're the steering wheel. Rail icons show their names in a tooltip beside the rail, and when the Pages panel is folded away, its reopen tab hangs off the rail's right edge.

Which side the page list loads

With a second page open beside the first, a click in the page list loads whichever side you were last working in — so if you have been reading in the pane on the right, that is the one that changes, and the page you are writing stays put. The working side wears a colored line down its inner edge, so the answer is on screen before you click. Click into the other side, or press ⌥⌘O, and it moves. With nothing open beside you there is only one side, and the list behaves exactly as it always has.

-click still opens a page in a new tab, whichever side you are on.

The trash

The trash holds your deleted pages — click it to open them. Everything you have deleted in the last thirty days is in there, newest first, each with Restore to put it back where it was and Delete Forever for when you mean it. A dot appears on the trash whenever there is something in it, which is the app's way of saying — before you ever need it — that deleting is not final.

To delete the page you are reading: ⇧⌘D, or Edit ▸ Delete Page, or right-click it in the page list. The trash used to do this as well, which read the wrong way around: everywhere else on this machine the Trash is a place you open, not a button that throws away whatever you are looking at. It is a place here too now.

Focus Mode

View ▸ Focus Mode (⇧⌘F) hides everything — toolbar, page list, palettes, status bar — leaving just your page, centered and quiet. Press Esc, ⇧⌘F again, or the small ✕ focus pill in the top-right corner, and the workshop reappears exactly as you left it. (The pill is there so nobody reaches for the window's close button to leave focus — that one quits the app.)

The panels' door handles

Every side panel can be put away without visiting a menu, and all three do it the same way. Hover the divider beside the Pages panel, the palettes or the AI drawer and a small chevron appears — click it, or double-click the divider itself, and the panel slides away with its width remembered for next time.

Getting one back depends on which. The Pages panel and the palettes each leave a small button on the window edge — the same shape as the chevron that sent them away — and clicking it brings the panel back exactly as it was. The AI drawer has no edge button, because the two panels on the right would be fighting for the same strip of window; bring it back with ✦ AI (⇧⌘A) instead. View ▸ Hide/Show Side Panels (⇧⌘\) puts the two side panels away and back in one stroke.

On the split pane and outline dividers, double-click keeps its older meaning: reset the width to the default.

Desks — a way of working you can come back to

Writing and researching want different windows. Writing wants the page and nothing else. Researching wants two sources open, the backlinks up and the tree showing. Monday morning wants your tasks and this week's notes. Getting from one to the other is a dozen small moves, and you make them again every time.

A desk is that arrangement, saved under a name. View ▶ Desks ▶ Save This Setup as a Desk… remembers which pages are open, which one you were reading, what stood beside it in the split, and which panels were up. Go to Desk… puts it all back.

Set up the window the way you want it first, then save — a desk records what is on screen at the moment you name it, so there is nothing to configure.

What a desk is not

It holds no writing. A desk is only a way of looking: which pages, which panels. Going to one can never change a page, and deleting one throws away the arrangement and nothing else — every page it opened stays exactly where it is.

It survives your wiki moving on. A desk saved six months ago that names a page you have since deleted still opens; it simply opens without it, and says how many it could not find. A saved setup that refused to work because one page went away would be worse than not having it, because you would only find out at the moment you reached for it.

Desks belong to the document, so each wiki has its own — and they travel inside it, like everything else you make.

Managing them

Manage Desks… renames one, or removes it: choose the desk, and clear its name to delete it. Saving over a name you already used replaces that desk, after asking.

Keep the manual inside your own wiki

Want the documentation searchable next to your own notes? Help ▸ Add the Manual to This Wiki… drops every chapter into a single page called MojoPad Manual, with a table of contents at the top. From then on it turns up in search results beside your writing, you can link to it, and you can scribble in it. Delete that one page whenever you're done with it — nothing else is touched.

Prefer a file? The manual is itself a MojoPad document: Help ▸ MojoPad Manual opens it, and File ▸ Export Document writes it out as PDF or ePub.

Two Macs, one set of preferences

Working on a laptop and a desktop? MojoPad ▸ Settings File ▸ Export Settings… writes your preferences to a small file — put it in whatever folder you already sync between machines. On the other Mac, Import Settings… and everything takes effect immediately: theme, fonts, layout, spacing, shortcuts, and the rest.

What deliberately stays put: your license, your open documents, each machine's window positions, any key you've pasted in — a key is a credential, and it is not in this file to begin with: the keys MojoPad holds for you — your model, your searches, your mailbox, the catalogs — are encrypted in files of their own, so an exported settings file could not carry one if it tried. (A key you give to a connected tool is the exception: those are part of that tool's own setup and travel with it.) — and the permissions you've granted for linked files — which folders MojoPad may reach on disk is a decision made at each keyboard, and carrying it across would approve folders the other Mac was never asked about. Everything else travels.

Slimmer headers when a second page is open

A page opens under its own title, set in serif, with the date it was made and how many pages link to it. That masthead is a good part of what MojoPad looks like, and on a large screen you would not want it any other way.

Open a second page beside it, though, and you pay for that introduction twice — and the two halves no longer start at the same height, because the page beside you begins right under the toolbar. On a thirteen-inch laptop that is a real amount of writing gone.

Settings ▸ Appearance ▸ Slimmer headers when a second page is open is for that. With it on, the masthead folds onto a single line while something is open beside you — sitting at exactly the height of the header on the other side, so both halves begin on the same line. Nothing is put away to manage it: the title is still there and still renames when you click it, and so are the type, any source or linked-file chip, the ◫ and the created-and-edited line. They simply stand in a row instead of a column. Close the second page and the full masthead returns. Off unless you turn it on.