CLI¶

Murmure provides a command-line interface for two purposes: controlling the running instance via one-shot commands (useful for OS-level custom shortcuts), and importing configuration files for deployment or sharing.

Control commands¶

These commands communicate with the running Murmure instance. Murmure must already be running for them to take effect.

Command	Description
`murmure --transcription`	Toggle standard transcription ON/OFF
`murmure --transcription-llm`	Toggle transcription in LLM mode
`murmure --transcription-command`	Toggle transcription in Command mode
`murmure --paste-last`	Paste the last transcription
`murmure --cancel`	Cancel the current recording and return to idle
`murmure --voice-mode`	Toggle Voice Mode ON/OFF
`murmure --llm-mode 1`	Switch to LLM mode 1
`murmure --llm-mode 2`	Switch to LLM mode 2
`murmure --llm-mode 3`	Switch to LLM mode 3
`murmure --llm-mode 4`	Switch to LLM mode 4

These commands are primarily used on Linux Wayland to bind OS-level custom shortcuts. See Configure shortcuts on Linux for setup instructions per desktop environment.

Import command¶

Starting from version 1.8.0, Murmure can import configuration files. This is useful for IT administrators deploying Murmure across multiple workstations or for sharing settings between machines.

Usage¶

murmure import <FILE> [OPTIONS]

Commands¶

Command	Description
`murmure --help`	Show help
`murmure --version`	Show version
`murmure import <FILE>`	Import a .murmure configuration file
`murmure import <FILE> --strategy replace`	Replace all settings (default)
`murmure import <FILE> --strategy merge`	Merge with existing settings

Import Strategies (import command)¶

replace (default) - Overwrites all existing settings with the imported ones
merge - Keeps existing settings and adds new ones from the import file. Existing values are preserved.

Platform-Specific Paths¶

LinuxmacOSWindows

murmure import config.murmure
# or with merge strategy
murmure import config.murmure --strategy merge

/Applications/murmure.app/Contents/MacOS/murmure import config.murmure

murmure.exe import config.murmure

Import / Export

The .murmure File Format¶

The .murmure file is a JSON file with the following structure:

{
  "version": 1,
  "settings": { ... },
  "shortcuts": { ... },
  "formatting_rules": { ... },
  "llm_connect": { ... },
  "dictionary": { ... }
}

Each section is optional - you can import only the parts you need.

Use Cases¶

IT Mass Deployment¶

Combine with silent MSI install for deploying pre-configured Murmure:

# Install silently
msiexec /package Murmure_x64.msi /quiet

# Import company configuration
murmure.exe import company-config.murmure

Export your settings from Murmure, share the .murmure file, and the recipient imports it:

murmure import colleague-settings.murmure --strategy merge

Notes¶

CLI operations are fast - they detect early and skip full app initialization
If Murmure is already running, the import triggers a hot-reload of settings
The import validates the file format and version before applying