The murmur CLI
- Turn any text or Markdown script into WAV or M4A with one command.
- Batch a whole project from a small JSON manifest you can version in git.
- Install, select, inspect, and remove local models from scripts.
Murmur is not limited to the app window. Generate narration from Terminal, or let your coding agent create, inspect, and organize audio — all on-device, all with the models and voices already on your Mac.
murmur generate --input video/script.md --output video/voiceover.wavEvery automation rides the same app-owned pipeline — your installed models, saved voices, and license stay in one place.
The CLI contract is small on purpose: status, model management, voices, generate, batch, jobs. Learn it once and every script — or every agent — can speak.
Read the full CLI & MCP docsTurn on local automation in Settings → Automation and click Install CLI. Murmur links the signed helper to ~/.local/bin/murmur.
Pass text directly or point at a script file. Pick a voice and speed, choose WAV or M4A, and Murmur renders on-device.
Add one MCP server entry to Codex, Claude Code, or Cursor. The agent gains ten Murmur tools for models, voices, generation, and jobs.
Keep a scenes.json beside your video script. Relative paths resolve from the manifest folder, so the whole voiceover versions with the project.
With MCP connected, your agent can install and select a model, inspect its voices, queue a batch, poll the job, and hand back the exact files it created — while your script never leaves the workspace.
Read video/script.md. Split it into intro, demo, and outro. Use Murmur to create WAV files in video/voiceover/, keeping one voice and pace across every scene. Don’t replace existing takes.
Manage local models, discover voices, queue audio, and track or cancel jobs without opening a cloud dashboard.
murmur_statusSetup, license, and automation readiness.murmur_list_modelsEvery model, capability, and install state.murmur_list_voicesPreset voices and saved reference profiles.murmur_install_modelDownload a model as a trackable job.murmur_set_default_modelChoose the installed default model.murmur_remove_modelRemove downloaded model files with confirmation.murmur_generate_speechQueue one WAV or M4A inside the workspace.murmur_generate_batchQueue a sequence of named files as one job.murmur_get_jobProgress and finished artifact paths.murmur_cancel_jobStop any active long-running job.The same privacy story as the app, enforced at the helper level — so a script or an agent can only do what you would do yourself.
Automation starts disabled. Nothing can call the helper until you allow it inside Murmur.
The Mac app runs every generation, so the CLI and agents never start competing model servers.
MCP reads and writes only inside the directory where the agent launched it.
Existing output fails safely unless you pass --force on purpose.
Removing downloaded model files requires confirmation, and bundled Kokoro cannot be removed.
Prompts, scripts, saved voices, and generated audio remain on your Mac.
Install commands, agent configs for Codex, Claude Code, and Cursor, batch manifests, and the full command reference.
Buy once, install the CLI, and let Terminal, Codex, Claude, and Cursor narrate with the voices on your Mac.