Microphone level tuning
Follow-up to the RNNoise work in v0.2.0. This release adds a dedicated tool for tuning microphone levels, and the installer now applies sensible starting mic levels automatically so a fresh install lands on usable audio instead of raw hardware defaults.
If you hit the "denoised but too quiet / clipping" situation, this release is the fix path.
✨ Added
mic-tune.sh— interactive microphone & RNNoise level tuner (~/.local/bin/).- Tunes all four level parameters from one place: hardware Capture gain, Mic Boost, the raw mic software volume, and the RNNoise source software volume.
- Record-and-measure test: captures a few seconds while you speak, reports peak/RMS, and tells you whether you are clipping, hot, good, low, or too quiet — the reliable way to calibrate.
- Auto-detects the ALSA card, hardware mic, and RNNoise source (no hardcoded device names), so it is portable across machines.
[s]persists hardware gains viasudo alsactl store; software volumes persist via WirePlumber.
mic-tuneshell alias added tobashrc.shso the tuner is one word away in a bash terminal.
🔄 Changed
-
install.shnow applies tuned starting mic levels. After enabling the RNNoise "Noise Suppressed Source" as the default input,setup_microphone_denoising()sets:- Hardware Capture gain → 100%
- Mic Boost → ~+10 dB
- Raw mic software volume → 50%
- RNNoise source software volume → 40%
The ALSA card index and mic-boost control name are auto-detected, the values are editable constants at the top of the block, and every step is guarded so it never fails the install if a control/device is missing. ALSA gains are persisted with
alsactl store; software volumes via WirePlumber.
📖 Documentation
- FAQ updated: the RNNoise section now points to
mic-tune.shfor level tuning (with the record-and-measure workflow), notes that the installer applies starting levels, and explains the WirePlumber-manages-Capture caveat — the software volumes are the dependable knobs.
⬆️ Upgrade / notes
- The installer's mic levels are starting points tuned for a typical built-in laptop mic. Microphone sensitivity varies per machine, so if you clip or sound too quiet, run
mic-tune.shand aim for a normal-speech peak of ~35–90% FS. Capture=100%is set for completeness only — WirePlumber manages that control and forces it toward 100% regardless, so prefer adjusting the software volumes and Mic Boost.- Existing installs can grab just the new tooling without reinstalling:
cp .local/bin/mic-tune.sh ~/.local/bin/ && chmod +x ~/.local/bin/mic-tune.sh # from the hyprsimple repo mic-tune.sh
Full changelog: v0.2.0...v0.2.1