Skip to content

v0.2.1

Latest

Choose a tag to compare

@rizukirr rizukirr released this 19 Jun 13:34
55513df

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 via sudo alsactl store; software volumes persist via WirePlumber.
  • mic-tune shell alias added to bashrc.sh so the tuner is one word away in a bash terminal.

🔄 Changed

  • install.sh now 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.sh for 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.sh and 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