Docs

FAQ & Troubleshooting

Common questions and their answers.

FAQ

Is Mioru free?

Mioru is a paid app (one-time purchase, no subscription). You bring your own AI provider keys — Mioru never charges for AI usage.

What AI providers does Mioru support?

Currently: ChatGPT (OAuth sign-in), Anthropic Claude (API key), and OpenAI (Whisper for voice). More providers are planned. See AI Providers.

Does Mioru work offline?

Yes — for reading, writing, and editing notes. AI features require an internet connection because they call cloud APIs. Voice transcription also requires internet (currently OpenAI Whisper API).

Where is my data stored?

Everything is local. Your notes are plain .md files in the directory you choose. Settings are in ~/.config/mira/settings.json. Nothing is uploaded to Mioru servers — Mioru doesn't have servers.

Can I sync notes between devices?

Yes. Point your Notes Directory at a cloud-synced folder (Nextcloud, Dropbox, iCloud) and sync happens automatically.

Does the AI read all my notes?

The AI only sees notes in the current project context. You control exactly which notes and projects are in context. Private notes outside the active project are invisible to the AI.

What happens if the AI makes a mistake editing my note?

Every AI edit is saved to .history/ before applying. You can always revert. The Feedback Loop also means the AI knows what actually happened in previous turns.

Can I use Mioru without any AI?

Yes — Mioru is a fully functional Markdown editor without AI. The AI features are additive and completely optional.

Why does Mioru cost money?

Mioru is actively developed, maintained, and improved. The 9 CHF one-time price is deliberately affordable — so as many people as possible can use it — while still valuing the work behind it. Your purchase directly supports future development: new features, macOS, and mobile.

Is Mioru open source?

Not right now. Mioru is an independent product built with care. Openness remains a possible future path, but the current focus is on a fair, understandable purchase model. The door isn't closed — but Mioru starts as a paid product with a simple promise: buy once, use forever.

Do I own Mioru after purchasing?

You buy a permanent usage license for your copy of the official Mioru version. You can keep it and use it — on your devices, for as long as you want. The name, source code, and redistribution rights remain with the developer. No subscription, no rental feeling.

Why no subscription?

Because Mioru is meant to stay simple. Buy once, use it, done. No monthly fees, no forced upgrades, no artificial dependency. Just a tool you can rely on.

Troubleshooting

PDF export is blank or shows file:// paths

Mioru uses Chromium/Edge for PDF export. Make sure Chromium or Edge is installed. PDF exports now suppress default browser headers and footers (since v0.9.6.1).

DOCX export fails

Pandoc is required for DOCX export. Install it: sudo apt install pandoc (Ubuntu/Debian) or brew install pandoc (macOS).

Voice Mode doesn't work

Voice Mode is in Beta. It requires an OpenAI API key for transcription. Check Settings → Voice → Voice Mode is enabled. On Linux, make sure your microphone is working in the system sound settings.

Chat AI doesn't respond

Ctrl+K search is slow on large vaults

The Vault Index makes search near-instant for vaults of any size. If you're experiencing slowness, the index may be rebuilding. Wait a moment and try again.

Changed notes directory but old files still show

Mioru reloads settings immediately when you change the Notes Directory. If the sidebar still shows old projects, try closing and reopening Mioru.