Merrimo User Guide › Reference

If you need more help with Merrimo on Mac

If you encounter issues while rendering artwork, connecting to render machines, or syncing stories with collaborators, use the troubleshooting procedures below.

A render machine won't connect

If Merrimo reports that your local ComfyUI engine or shared rendering machine is offline or unreachable:

  1. In Merrimo on your Mac, choose Merrimo > Settings (or press ⌘,), then click Rendering.
  2. Find the machine under Render Machines and click Test on its row (This Mac has Restart instead, under This Mac).
  3. If connection fails, verify that your ComfyUI server is running:
    • Default local port is http://127.0.0.1:8188.
    • Ensure no firewall or VPN software is blocking WebSocket connections on that port.
    • Try changing the host address from localhost to 127.0.0.1.
  4. For remote or shared Mac render peers, confirm that both Macs are on the same local network subnet and that the host Mac has switched the machine on under Share with Collaborators in Settings > Rendering.

A model is missing

If an engine circle shows an orange dot, or a render fails because a model is missing:

  1. Select the engine circle: the row under the engine circles names the node or model file that's missing.
  2. For pictures on This Mac, Merrimo downloads what it needs when you add This Mac in Settings › Rendering. If a download stopped, click the download item in the toolbar and click Try Again.
  3. A server on your network needs the model in its own ComfyUI models folder.
  4. To see which model files this Mac has, choose Tools › Models (or press ⇧⌘M).

Your AI provider account is out of credits

When the AI service you write or draw with has no credits left, Merrimo says Your AI provider account is out of credits, with Open Settings. Writing suggestions in Prose stop until it's fixed. Either:

  1. Add credits on the provider's own website (OpenAI, Anthropic, Google or OpenRouter), then try again.
  2. Or click Open Settings and make another provider the Active one in Settings > Providers. See Set up AI.

Dialogue lettering fonts appear jagged or misaligned

If custom comic typography does not appear correctly on the canvas:

  1. Open the Font Book app on your Mac and verify that the comic font family is installed and validated.
  2. In Merrimo, select the speech balloon or caption and inspect the Typography section in the Inspector.
  3. If exporting to PDF, ensure that Embed Fonts as Vector Outlines is selected in the Export dialog.

Realtime collaboration conflicts and soft locks

If two team members edit the same panel simultaneously:

  1. Merrimo uses automatic 2-minute soft locks to prevent write collisions. If a panel displays a collaborator lock icon, wait for the collaborator to finish or deselect the panel.
  2. If network connection is lost, Merrimo buffers your edits locally and automatically syncs them when reconnecting.
  3. To inspect version history or recover an earlier state, choose View > Show History (or press ⌥⌘L).

Send feedback to the developers

If an issue persists or you have a feature suggestion:

  1. Choose Help > Send Feedback… in the menu bar (or press ⌃⌥⌘F).
  2. Describe what you were doing when the issue occurred, and attach any relevant screenshots: click Capture Window, click Add Files…, or drag pictures onto the well.
  3. Click Send to send your diagnostic report directly to the development team.

If it can't be sent right away, you're told, and it's sent again the next time you open the app. A picture that can't be uploaded is left out, and both you and the report say why.

You can also ask the agent (Window > Agent, ⇧⌘A) to file it for you, for example after it has helped you track a problem down. It writes the report, shows you the title and description, and sends it only once you say yes. A bug report it sends carries the same recent activity log as one from Send Feedback.

See also