✦ docs

docs.

full docs are coming soon. for now, you can check the mustardy repository →

how to install

download the latest version for macOS or Linux from github releases. you can also build it from source using the instructions in the README.

controls

quieter by (dB): set how quiet audio needs to be to count as a silence.
min pause: pick the shortest pause to cut. raise this number if you want to keep small gaps.
evenness: balances your voice so quiet parts and loud parts match.
normalize export: applies evenness to your final exported video.
manual cuts: drag on the empty timeline to add a cut. click a cut and press delete to remove it.

command line

the app ships a command for agents and scripts. it is the same binary as the editor: give it arguments and it runs headless instead of opening a window.

usage

mustardy trim <input> [options]

this removes the pauses and writes <input>-trimmed.mp4 next to the source. on macos, run mustardy install-cli once to put the command on your PATH. on linux the packaged app already does.

examples

mustardy trim talk.mp4
mustardy trim talk.mp4 -o cut.mp4 --drop 24 --min 0.5 --no-normalize
mustardy trim talk.mp4 --dry-run --json

options

parameter	default	what it does
`-o, --output <path>`	<input>-trimmed.mp4	output file
`--drop <dB>`	30	how far below talking a stretch counts as a pause (8 to 35)
`--min <seconds>`	0.9	shortest pause to remove
`--normalize`	on	even out the audio
`--no-normalize`		skip audio normalization
`--normalize-amount <0..1>`	0.7	normalization strength
`--no-visual`		skip the picture-change scan (faster, less precise)
`--dry-run`		report the cuts, write nothing
`--json`		machine-readable output on stdout
`-h, --help`		show help

json output

with --json, the result goes to stdout as JSON and progress stays on stderr, so an agent can parse it cleanly:

{
  "output": "talk-trimmed.mp4",
  "removed": 18.4,
  "dropDb": 30,
  "minPause": 0.9
}

exit codes

0: success
1: error

building for a server or CI? the same commands compile without the desktop toolchain:cargo build -p mustardy-core --bin mustardy-cli.