diff options
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 23 |
1 files changed, 17 insertions, 6 deletions
@@ -39,6 +39,9 @@ LUFS with a -1.5 dBTP true-peak ceiling**. ./producer.sh recording.wav --profile narrator ./producer.sh recording.wav --profile radio +# Settings that differ from the built-in profile are named 'custom' +./producer.sh recording.wav --no-denoise # recording.custom.wav + # Process several files at once ./producer.sh take1.wav take2.wav --mp3 @@ -110,8 +113,12 @@ Direct package installs can use `producer[gui]` and need system FFmpeg or the late jobs never replace the visible comparison after you edit the selection. 5. Enter an existing **absolute** output directory (default: the directory you launched Producer from — start it next to your recording and exports - land beside the input), review the frozen current settings and confirm - **Export full recording**. This processes the entire original even if you + land beside the input). The audio file + (`<name>.<profile>.wav`, optional `.mp3`) is written directly into that + directory; the timestamped diagnostic report goes to the `logs/` + directory next to `producer.sh`. Settings that differ from the built-in + profile are named `custom`, and the browser asks before replacing + existing audio. This processes the entire original even if you selected only a few seconds. Completed exports list their full local paths; find the files with your operating system's file manager. @@ -169,9 +176,12 @@ is selected. Normalization and other effects are never forced on for comparison. Optional loudness matching is playback-only attenuation, not a change to export settings. -Exports process the whole original with the requested settings into a new, -non-clobbering `producer-export-*` folder in the chosen output directory: -`master.wav`, optional `master.mp3`, and `logs/master.report.json`. The API +Exports process the whole original with the requested settings and write the +audio file directly into the chosen output directory: +`<name>.<profile>.wav` (named `custom` when settings differ from the built-in +profile), optional `<name>.<profile>.mp3`. Replacing existing audio asks for +explicit confirmation. The timestamped diagnostic report goes to the `logs/` +directory next to `producer.sh`, so reports never collide. The API returns persistent local paths, **not browser blobs of multi-hour exports**. The browser only fetches bounded preview snippets. TOML presets can be imported as text or downloaded; no source recording is rewritten by the API. @@ -245,7 +255,8 @@ than risking chopped words. Controls: The detector can miss whispers, breaths, or unusual speech. If it detects **no speech**, cleanup fails open with a warning instead of muting the file. Other detector failures stop processing, not silently switch to a level gate. -Reports in `logs/` include the attenuated intervals on the original, +Reports in the `logs/` directory next to `producer.sh` include the attenuated +intervals on the original, pre-trim timeline for inspection. With VAD enabled, optional trimming only shortens near-zero cores; without it, legacy `gap_threshold_db` trimming can mistake quiet speech for silence. |