A SteamVR dashboard panel for the Steam Frame that switches the headset microphone's echo cancellation and noise suppression while you're wearing it. Turn echo cancellation off when you use earphones, so quiet sounds like mouth noises come through clearly, and back on when you use the Frame's speakers, so their sound doesn't leak into your mic. A built-in voice check records a few seconds of what apps actually hear, so you can compare settings on the spot.

日本語版はこちら

Quick (presets)	Fine-tune

The Frame's speakers play a blizzard sound while the voice check records, and the two recordings are played back. 1st clip: noise suppression off (Speaker preset). 2nd clip: echo cancellation off too (Earphones preset). With echo cancellation off, the blizzard from the speakers leaks into the mic. The panel in the video is in Japanese.

• Two tabs: Quick has the presets, Fine-tune has the individual switches and sliders. The panel opens on the tab you used last.
• Presets for how you listen (Quick tab, "How are you listening?"): one tap on Earphones / headphones sets echo cancellation off and noise suppression off; one tap on Frame speakers sets echo cancellation on and noise suppression off. Each card shows what it sets, and the card matching your current settings is highlighted. On the Fine-tune tab, echo cancellation and noise suppression also have their own on/off switches; when your settings match neither preset, both cards turn grey. Changes apply at once, even while the mic is in use, without cutting the sound, and they are kept after a restart.
• Noise filter strength: two sliders tune the noise suppression on the spot: Strictness (how voice-like a sound must be to pass; lower lets more through) and Hold (how long sound keeps passing after you stop speaking).
• Signal path: shows whether an app is using the mic and which filters the sound actually goes through (mic → EQ → echo cancellation → noise suppression → apps), read from the live PipeWire links.
• Voice check: records up to 10 seconds of the final sound that apps receive, keeps the last 5 recordings, and plays them back through the Frame's speakers or your earphones. Each recording shows the time, length, the setting it was made with and a small waveform.
• Updates: an update card above the bottom row always shows the running version. It asks GitHub for a newer release about once a day (turn this off with update_check: false in the settings file), and Check now asks right away regardless. When a newer version is available the card gets an accent-colored border and an Update button, which downloads and installs it after you confirm once.
• Japanese and English UI. Text and controls meet WCAG 2.x AA contrast.

Why this is needed: while an app uses the mic, SteamOS runs it through EQ, echo cancellation and noise suppression. Echo cancellation strongly reduces small sounds, and noise suppression silences anything that doesn't sound like a voice. With earphones there is no speaker sound to cancel, so turning echo cancellation off lets more of your voice through.

• A Steam Frame with Developer Mode on and SSH access (Settings > System > Developer Mode, then set a password under Developer). Choose a strong password: with SSH on, anyone on your network who knows it can log in to the headset.
• SteamVR on the headset. Building from source (see below) needs cmake, ninja, g++, pkg-config and the cairo, FreeType, PipeWire and Vulkan development files, which already come with SteamOS; a downloaded release doesn't need any of them.

No PC needed. In Konsole on the Frame (+ on the bar at the bottom → the list of programs → Konsole), type this command, press Enter, and pick 3 (frame-mic-tuner) from the menu.

curl -fsSL https://frame.sasaken1102s.net | sh

• Do this once first: Steam Settings → System → turn on "Enable Developer Mode" (while it's off, Konsole doesn't show up in the + list).
• The other apps (frameeyeosc, frame-jp-keyboard, frame-perf-overlay) can be installed from the same menu.
• To update, run the same command and pick the same number again. To uninstall, use u in the menu.
• Step-by-step guide and video: https://frame.sasaken1102s.net
• To install without any prompts: curl -fsSL https://frame.sasaken1102s.net | sh -s -- install mic

What gets installed and the options are the same as in "Install from a PC" below (it runs install.sh for you).

Download frame-mic-tuner-<version>.tar.gz from the releases page and copy it to the headset, for example from your PC:

scp frame-mic-tuner-*.tar.gz steamos@<headset-ip>:

Then on the headset (ssh steamos@<headset-ip>):

tar xzf frame-mic-tuner-*.tar.gz
cd frame-mic-tuner
./install.sh

Or build it from source instead (also on the headset):

git clone https://github.com/sasaken1102r/frame-mic-tuner.git
cd frame-mic-tuner
./install.sh

Then restart the headset once, so WirePlumber loads the switch script. Don't restart PipeWire or WirePlumber by hand while playing: SteamVR and Steam Link lose their sound. If that happens anyway, restart SteamVR on the headset (or reconnect Steam Link) and the sound comes back.

No sudo is needed. install.sh puts everything into your home directory (~/.local/bin, ~/.local/share, ~/.config), so SteamOS updates don't remove it. To update by hand: download the new release and run its install.sh again (or, in a source checkout, git pull && ./install.sh) — or just press Update on the panel's update card once it shows a newer version is available. Version 0.1.0 has no update card, so going from 0.1.0 to 0.2.0 has to be done by hand this once.

What gets installed:

• the app, a launcher entry for the dashboard's + (launch a program) list, and its icons
• a systemd user unit for starting it together with SteamVR (not enabled unless you turn it on; see below)
• a WirePlumber script and config (contrib/wireplumber/) that replace SteamOS's microphone tracker with one whose echo cancellation and noise suppression can be switched. It behaves like the original otherwise.
• the shared update script (~/.local/share/frame-mic-tuner/frame-update.sh, from vendor/frame-updater/), used by the panel's update card

To remove it: ./install.sh --uninstall, then restart the headset to get SteamOS's original microphone behaviour back. Add --purge to also delete the app's settings and the saved switch values.

1. Open the SteamVR dashboard, press + (launch a program) and choose Frame Mic Tuner. A Mic icon appears in the row at the bottom of the dashboard; select it to open the panel. Launching it again while it's running just opens the panel.
2. On the Quick tab, under How are you listening?, choose Earphones / headphones or Frame speakers. These are presets: they set echo cancellation and noise suppression to the recommended values (the chips on each card show them); the noise filter strength sliders stay as they are. For finer control, switch to the Fine-tune tab. If your settings then match neither preset, both cards on the Quick tab turn grey and it says "Using fine-tuned settings", with an Open Fine-tune → button; tap a card to go back to that preset. Noise filter cuts quiet sounds (mouth noises and the like) when on.
   • On the Fine-tune tab, drag the Strictness and Hold sliders (or use − / ＋) to tune the noise filter. SteamOS's defaults are 23% and 500 ms; Default brings them back. The sliders only have an effect while Noise filter is on.
   • SteamOS resets these two values whenever its audio restarts (for example after a reboot). The app saves your values and applies them again each time it starts, so they only stick while the app is running. Turn on Start with SteamVR if you want them all the time. Without the app, SteamOS's defaults are used.
3. Voice check: press Record, say something, and press Stop (it stops by itself after 10 seconds). Switch the setting, record again, and use ▶ on each row to compare. Recording stops as soon as you close the panel.
4. Start with SteamVR (bottom row): turn it on to have the app start automatically with SteamVR from now on. You can also enable it with ./install.sh --autostart.
5. Language: the panel starts in your Steam Frame's language (Japanese if Steam is set to Japanese, English otherwise). Change it with 日本語 / English at the bottom left; your choice is saved.
6. Quit: press it twice, or hover over the Mic icon in the dashboard and choose Close.
7. Updates (the card above the bottom row): it shows the running version, for example "Up to date (0.2.0)". Check now looks for a newer release right away (this works even if the automatic daily check is off).
   • When one is available, the card gets an accent-colored border and says "Version X is available". Press Update; the card asks "Update to X?" with Cancel and Update (the question goes away by itself after 3 seconds). Press Update again to start. The card then shows the progress ("Updating: Downloading", and so on).
   • The panel stays open and keeps running the old version while it installs. When the card says "X is installed. Quit and start the app again to use it", press Quit twice and start the app again from + (or restart SteamVR), then Close the message if it's still shown. If the new version changed the WirePlumber script, restart the headset too (the card reminds you, and the update log says whether it changed).
   • If the card says "This version can't be installed from here" (the release has no SHA256SUMS or no package), update by hand as described under Install; the card shows the release page.
   • If the update fails, the card gets a red border, says why and that nothing was changed, and offers Try again and Close. If only the check fails (for example with no network), just the text turns red and Check now stays.

The settings are also available from SSH:

wpctl settings --save frame-mic.echo-cancel false        # earphones: echo cancellation off
wpctl settings --save frame-mic.echo-cancel true         # speaker: echo cancellation on (default)
wpctl settings --save frame-mic.noise-suppression true   # noise suppression on (default: off)
~/.local/bin/frame-mic-tuner --print                     # current values, mic in use, signal path

• The panel says "Mic switch is not installed": the WirePlumber script isn't loaded yet. Run ./install.sh, then restart the headset.
• Autostart buttons are grey: the systemd unit isn't installed. Run ./install.sh.
• Recordings are silent, or others can't hear you at all: check the microphone volume in the headset's mixer (read only; this is safe):

  amixer -c 0 cget name='VA_DEC0 Volume'
  amixer -c 0 cget name='VA_DEC1 Volume'

  Both should say values=96. If they say 0, the microphone is effectively muted. This app never touches the mixer, but it has been seen dropping to 0 on its own. To set them back (at your own risk; note the current values and the max= shown by cget first, and use the value your headset normally has, 96 on ours):

  amixer -c 0 cset name='VA_DEC0 Volume' 96
  amixer -c 0 cset name='VA_DEC1 Volume' 96

• No sound at all in SteamVR or Steam Link after PipeWire or WirePlumber was restarted: restart SteamVR on the headset (or reconnect Steam Link). The sound comes back.
• No sound at all after a SteamOS update: the switch script is loaded as a required part of WirePlumber, so if an update breaks it, WirePlumber may stop and take all sound with it. Remove the config over SSH and restart the headset (or run ./install.sh --uninstall and restart):

  rm ~/.config/wireplumber/wireplumber.conf.d/90-frame-mic.conf

• "In use" while you're not talking in any app: any app that records audio counts, including screen or audio recorders. SteamOS turns the filters on for all of them.
• Frame Mic Tuner is missing from the + list: restart the headset once after installing.
• The Mic icon is missing from the dashboard although the app is running: SteamVR can lose the app's dashboard panel (for example when the dashboard itself restarts). The app checks every 3 seconds and recreates the panel by itself, so wait a few seconds and open the dashboard again. Launching the app again from + also checks and recreates it before opening the panel. If it still doesn't come back, the log (journalctl --user -u frame-mic-tuner -f when it runs as a service) says why (the log is in Japanese; look for lines starting with "自己修復", which means "self-repair"); quitting the app and starting it again fixes it too.
• Logs: journalctl --user -u frame-mic-tuner -f when it runs as a service. To see the log of a manual run, quit the app and start ~/.local/bin/frame-mic-tuner from SSH.
• The update check fails, or "Update" doesn't do anything: ~/.cache/frame-mic-tuner/update.log has the details, and ~/.cache/frame-mic-tuner/update-check.json / update-state.json the last raw answer. update_check: false in the settings file turns off the automatic daily check without removing the update card or its Check now / Update buttons.

• Voice check recordings are kept only in the app's memory. They are never written to disk or to logs, and never sent anywhere. They are gone when the app quits.
• While it records, the panel shows "● Recording". Recording stops as soon as you close the panel.
• The microphone may pick up the voices of people around you. Keep that in mind before recording.
• To pick the default language it reads the language line of Steam's ~/.steam/registry.vdf once at startup (read only).
• The app has no telemetry. Its only network use is the update check:
  • When: while the app runs, it asks GitHub at startup if its last answer is more than 24 hours old, and after that about once a day (an hour later after a failed check). Check now asks right away. Set update_check: false in the settings file to stop the automatic check; then it only connects when you press Check now or Update.
  • What it sends: one HTTPS request for this project's latest release to api.github.com, with no account, ID or usage data. Like any web request, GitHub sees your IP address and the User-Agent of curl. Your recordings, settings and logs are never sent.
  • What it receives: the latest release's version number, its page and the names and links of its files. The answer is kept in ~/.cache/frame-mic-tuner/update-check.json.
  • Only when you press Update and confirm, it also downloads that release's package and SHA256SUMS from github.com / *.githubusercontent.com.
• The only files it writes are ~/.config/frame-mic-tuner/config.json (UI language, last tab, noise filter strength and the update-check setting), ~/.config/frame-mic-tuner/install-args (the options your last ./install.sh run used, so an update reinstalls the same way), ~/.cache/frame-mic-tuner/ (the update check's cached answer, the update's log and state, a lock folder update.lock/ while an update runs, and a work folder whose download is deleted after each update), and a lock file in $XDG_RUNTIME_DIR that holds its process ID (to stop a second copy from starting). An update also rewrites the installed files, as running ./install.sh does.

• Use at your own risk. This project was made with Claude Opus 5.5, an AI model. I've tested it on my own Steam Frame, but I can't take responsibility for what happens on yours, so please read the code and check it yourself before you run it. The software comes with no warranty (see LICENSE).
• What it changes: the two WirePlumber settings frame-mic.echo-cancel and frame-mic.noise-suppression (through wpctl settings), the noise suppressor's two live parameters "VAD Threshold (%)" and "VAD Grace Period (ms)" (through pw-cli set-param; SteamOS puts its defaults back when its audio restarts), and WirePlumber's configuration in your home directory, where it replaces SteamOS's microphone tracker with its own script. Apart from that it only enables or disables its own systemd user unit when you ask it to, and, when you update from the panel, runs the new release's install.sh in a short-lived systemd user unit (frame-mic-tuner-update).
• It never restarts PipeWire or WirePlumber, never writes to the ALSA mixer (amixer), never touches /etc and never needs root.
• Update: downloads the latest release's .tar.gz and SHA256SUMS from GitHub over HTTPS (only to GitHub's own hosts), checks the hash, and only then extracts it into ~/.cache/frame-mic-tuner/update/ and runs its install.sh with the same options as your last install. It refuses a release with no SHA256SUMS, a hash mismatch, or an archive containing an absolute path, .., a link or a special file; nothing is changed if any of that happens. The download is deleted afterwards. SHA256SUMS is a checksum published in the same release, not a signature: it catches a corrupted or incomplete download, but not a release that was replaced on GitHub. The running app isn't restarted: quit it and start it again to use the new version. See frame-update.sh's own notes for the exact steps.
• A SteamOS update can change how the microphone filters are set up. If that happens, the switches may stop working until this project is updated. Because the switch script is a required part of WirePlumber, a script that no longer loads can also stop all sound on the headset (see Troubleshooting). ./install.sh --uninstall and a restart bring back SteamOS's original behaviour.
• This is an unofficial project with no affiliation with or endorsement from Valve Corporation. Steam, Steam Frame, SteamVR and Steam Link are trademarks and/or registered trademarks of Valve Corporation in the U.S. and/or other countries. The names are used here only to say what this works with.

Build on the headset:

cmake -G Ninja -S . -B build && ninja -C build
./build/frame-mic-tuner --help
scripts/package.sh   # release build: dist/frame-mic-tuner-<version>.tar.gz, dist/SHA256SUMS

Useful options that don't need SteamVR: --print, --set-ns-vad N / --set-ns-grace N (apply a noise filter strength right away without saving it), --dump-png PATH (render the panel, with --fake-* states for screenshots, including --fake-update STATE and --preview-update-confirm for the update card), --test-record 3 (record 3 seconds and play them back), --contrast-report (WCAG contrast of every color pair) and --version. Design notes, how the switch script works and test results are in docs/DEVELOPMENT.ja.md (Japanese).

The update mechanism (vendor/frame-updater/) is copied from a shared, private repository; don't edit the copy by hand — sh vendor/frame-updater/verify.sh (run by scripts/package.sh) checks that it wasn't.

scripts/package.sh runs vendor/frame-updater/verify.sh, builds a Release binary, and writes dist/frame-mic-tuner-<version>.tar.gz and dist/SHA256SUMS (required for the panel's Update button to accept the release). It prints the command that creates the GitHub release (and its tag) with both files attached; write the release notes in a file outside the repository first:

gh release create v<version> dist/frame-mic-tuner-<version>.tar.gz dist/SHA256SUMS --title v<version> --notes-file <release-notes-file>

Don't make it a draft or a prerelease: the panel looks at GitHub's latest release, which skips both.

MIT. See LICENSE. The bundled OpenVR header (third_party/openvr/) is BSD-3-Clause by Valve Corporation. vendor/frame-updater/ is a copy of the author's own update helper and is MIT like the rest of this repository. Licenses of the bundled header and the libraries it uses are listed in THIRD_PARTY_LICENSES.md. Changes are listed in CHANGELOG.md.