Get started with Merrimo on Mac
Merrimo combines screenplay writing, comic layout drafting, dialogue lettering, and diffusion art generation into a unified Mac app. The first time you open it, a short setup gets you signed in (or not) and asks whether you want AI. Then here's how to get up and running.
Sign in, or use Merrimo without an account
With an account, your stories stay in sync across your devices and you can share them. There's no password: Merrimo emails you a sign-in link.
- On Welcome, click Continue with email.
- Enter your email and click Send Link. If you don't have an account yet, signing in makes one.
- Open the email on this Mac and click its link. Merrimo picks it up and carries on.
If Welcome shows Sign in with Apple, you can use that instead.
Reading your email on another device? Click Opened the email on another device? Enter a code instead, then type the 6-digit code from the email and click Continue. A link or code works for 15 minutes. Click Resend Link if it has expired, or Use a different email to start over.
To keep your stories on this Mac only, click Use without an account on Welcome instead. Syncing and sharing need an account, and the sidebar says Local only. You can turn on sync any time: see Turn on sync later.
Choose whether to use AI
Merrimo can draw your characters, places and comic panels, and help with your writing. It's entirely optional.
Merrimo can draw your characters, places and comic panels, and help with your writing, using an online service you choose. It's entirely optional.
- No AI — just write opens Merrimo now.
- Set up AI lets you choose how pictures and writing help run.
- Set up AI lets you choose the online service pictures and writing help come from.
Choose what to add
Pick as many as you like: on this Mac, online, or both.
- Draw pictures: Everyday Pictures, on this Mac is free and unlimited once downloaded. Online with OpenRouter is pay as you go.
- Help me write: Online with OpenRouter, or My own API key or model server (Anthropic, OpenAI or Google, or a server you run such as LM Studio or Ollama).
Merrimo suggests what fits your Mac and shows how much it downloads and how much space is free. It picks Standard or Best picture quality from your Mac's memory (Best needs 48 GB); click Why? to see the reason. If the downloads don't fit, it says how much more room you need.
The button at the bottom changes with what you tick:
- Download & Start Writing opens Merrimo while the downloads run in the background. Their progress shows in the toolbar: see Download and manage AI models.
- Continue (anything online, or your own key or server, ticked) goes on to connect it: Connect OpenRouter when you ticked only OpenRouter, otherwise Choose an AI service.
- Start Writing (nothing ticked) just opens Merrimo.
Choose an AI service
To download nothing, click Use an online account instead; Choose an AI service also comes next when you tick My own API key or model server. When you ask for a picture or a suggestion, that part of your story is sent to the service you choose.
Set up AI opens Choose an AI service. When you ask for a picture or a suggestion, that part of your story is sent to the service you choose.
- Pay as you go with OpenRouter (pictures and writing): billed by OpenRouter as you use it, usually a few cents a page. Click Sign in with OpenRouter…, approve Merrimo in your browser, and Merrimo connects on its own. You can also click Use an OpenRouter API key instead and paste a key.
- Use your own API key (writing only): choose Anthropic, OpenAI or Google and paste a key from that provider. Merrimo checks the key as soon as you stop typing, and keeps it in iCloud Keychain, so your other devices get it too.
- Use a model server (writing only): models you run yourself in LM Studio, Ollama or another OpenAI-compatible server.
Click Continue, follow the steps, then click Start Writing. Back returns to the screen before. See Set up AI in Merrimo on Mac for each service's steps.
The service you choose appears in Settings › Providers, where you can change it later.
Pick up where you left off
If you quit during setup, Merrimo opens at the same step next time. Closing the setup window keeps your place too: click Merrimo in the Dock to bring it back. Once setup is done, it doesn't come back; if you sign out, Merrimo asks you to sign in again, or you can choose Use without an account.
Turn on sync later
If you started without an account, you can move your stories into one at any time:
- Choose Merrimo › Settings, then click Account.
- Click Turn on sync… and sign in.
- Merrimo closes your story windows and moves your stories into your account. The Account pane shows the progress.
Comments, stickers and your own workflows move with them. If the move stops partway, your stories are still on this Mac: click Try Again.
Add or change AI later
- To add OpenRouter, your own API key or a model server, or to choose which one Merrimo uses, open Settings › Providers. Use AI at the top switches AI on or off everywhere.
- To draw pictures on this Mac (one with Apple silicon), choose Tools › Models, select Everyday Pictures and click Get on this Mac's card. Merrimo downloads what it needs in the background. See Everyday Pictures on each machine.
Explore the workspace
Merrimo provides dedicated workspace views to support every phase of production:
- Prose Mode (⌥1): Draft screenplays and chapters with scene headers and character dialogue blocks.
- Canvas Mode (⌥2): Lay out pages, draw panels, and arrange artwork on an infinite drafting surface.
- Source Text Sidebar Tab: Read and follow your manuscript alongside the canvas while laying out panels.
Structure your comic pages
Add chapters and pages, draw panel grids, and adjust margins and borders:
- Press P (or R) to activate the Panel tool, then click and drag on the canvas to frame your shot.
- Adjust panel dimensions, aspect ratios, and gutters in the Inspector or by dragging panel edges.
- Configure bleed, trim, and live margins in the Page Settings inspector.
Add dialogue and captions
Give your characters a voice with typography and comic balloons:
- Select a panel and press ⌘B to insert a speech bubble or ⌘T for a thought bubble.
- Press C to arm the caption tool and draw a narration box.
- Type dialogue with automatic text reflow, auto-hyphenation, and comic font styling.
- Drag the yellow tail handle toward the speaking character's mouth or off-panel.
Connect render engines
Bring panels to life with generative diffusion models:
- Connect an AI service for writing help and online pictures (OpenRouter, your own API key or a model server) when you first open Merrimo, or in Settings > Providers. See Set up AI.
- Add This Mac or a ComfyUI server on your network as a render machine in Settings > Rendering.
- Type prompt descriptions directly into panel nodes.
- Render iterations with ⌘R and track every version in History (⌥⌘L).